00001 /* ///////////////////////////////////////////////////////////////////////// 00002 * File: stlsoft/shims/access/string/std/time.hpp 00003 * 00004 * Purpose: String shims for standard time structures. 00005 * 00006 * Created: 25th July 2005 00007 * Updated: 10th August 2009 00008 * 00009 * Home: http://stlsoft.org/ 00010 * 00011 * Copyright (c) 2005-2009, Matthew Wilson and Synesis Software 00012 * All rights reserved. 00013 * 00014 * Redistribution and use in source and binary forms, with or without 00015 * modification, are permitted provided that the following conditions are met: 00016 * 00017 * - Redistributions of source code must retain the above copyright notice, this 00018 * list of conditions and the following disclaimer. 00019 * - Redistributions in binary form must reproduce the above copyright notice, 00020 * this list of conditions and the following disclaimer in the documentation 00021 * and/or other materials provided with the distribution. 00022 * - Neither the name(s) of Matthew Wilson and Synesis Software nor the names of 00023 * any contributors may be used to endorse or promote products derived from 00024 * this software without specific prior written permission. 00025 * 00026 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 00027 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 00028 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 00029 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 00030 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 00031 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 00032 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 00033 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 00034 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 00035 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 00036 * POSSIBILITY OF SUCH DAMAGE. 00037 * 00038 * ////////////////////////////////////////////////////////////////////// */ 00039 00040 00048 #ifndef STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_TIME 00049 #define STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_TIME 00050 00051 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION 00052 # define STLSOFT_VER_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_TIME_MAJOR 2 00053 # define STLSOFT_VER_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_TIME_MINOR 1 00054 # define STLSOFT_VER_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_TIME_REVISION 6 00055 # define STLSOFT_VER_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_TIME_EDIT 23 00056 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */ 00057 00058 /* ///////////////////////////////////////////////////////////////////////// 00059 * Includes 00060 */ 00061 00062 #ifndef STLSOFT_INCL_STLSOFT_H_STLSOFT 00063 # include <stlsoft/stlsoft.h> 00064 #endif /* !STLSOFT_INCL_STLSOFT_H_STLSOFT */ 00065 #ifndef STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_STD_H_C_STRING 00066 # include <stlsoft/shims/access/string/std/c_string.h> 00067 #endif /* !STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_STD_H_C_STRING */ 00068 #ifndef STLSOFT_INCL_STLSOFT_STRING_HPP_SHIM_STRING 00069 # include <stlsoft/string/shim_string.hpp> 00070 #endif /* !STLSOFT_INCL_STLSOFT_STRING_HPP_SHIM_STRING */ 00071 00072 #ifndef STLSOFT_INCL_H_TIME 00073 # define STLSOFT_INCL_H_TIME 00074 # include <time.h> 00075 #endif /* !STLSOFT_INCL_H_TIME */ 00076 00077 /* ///////////////////////////////////////////////////////////////////////// 00078 * Namespace 00079 */ 00080 00081 #ifndef _STLSOFT_NO_NAMESPACE 00082 namespace stlsoft 00083 { 00084 #endif /* _STLSOFT_NO_NAMESPACE */ 00085 00086 /* ///////////////////////////////////////////////////////////////////////// 00087 * Shims 00088 * 00089 * All the struct tm-related conversions assume a format of 20 characters 00090 */ 00091 00100 inline basic_shim_string<ss_char_a_t> c_str_data_a(struct tm const* t) 00101 { 00102 typedef basic_shim_string<ss_char_a_t> shim_string_t; 00103 00104 shim_string_t s(20); 00105 00106 if(NULL == t) 00107 { 00108 s.truncate(0); 00109 } 00110 else 00111 { 00112 const ss_size_t cch = ::strftime(s.data(), 1 + s.size(), "%b %d %H:%M:%S %Y", t); 00113 00114 STLSOFT_ASSERT(20 == cch); 00115 00116 s.truncate(cch); 00117 } 00118 00119 return s; 00120 } 00121 00129 inline basic_shim_string<ss_char_a_t> c_str_data(struct tm const* t) 00130 { 00131 return c_str_data_a(t); 00132 } 00133 00134 00135 00143 inline ss_size_t c_str_len_a(struct tm const* t) 00144 { 00145 return static_cast<ss_size_t>((NULL != t) ? 20 : 0); 00146 } 00147 00155 inline ss_size_t c_str_len(struct tm const* t) 00156 { 00157 return c_str_len_a(t); 00158 } 00159 00160 00161 00170 inline basic_shim_string<ss_char_a_t> c_str_ptr_a(struct tm const* t) 00171 { 00172 return c_str_data_a(t); 00173 } 00174 00183 inline basic_shim_string<ss_char_a_t> c_str_ptr(struct tm const* t) 00184 { 00185 return c_str_data_a(t); 00186 } 00187 00188 00189 00198 inline basic_shim_string<ss_char_a_t> c_str_ptr_null_a(struct tm const* t) 00199 { 00200 return c_str_data_a(t); 00201 } 00202 00211 inline basic_shim_string<ss_char_a_t> c_str_ptr_null(struct tm const* t) 00212 { 00213 return c_str_data_a(t); 00214 } 00215 00216 00217 00218 00219 00220 00229 inline basic_shim_string<ss_char_a_t> c_str_data(struct tm const& t) 00230 { 00231 return c_str_data(&t); 00232 } 00233 00241 inline basic_shim_string<ss_char_a_t> c_str_data_a(struct tm const& t) 00242 { 00243 return c_str_data_a(&t); 00244 } 00245 00246 00254 inline ss_size_t c_str_len_a(struct tm const& t) 00255 { 00256 return c_str_len_a(&t); 00257 } 00258 00266 inline ss_size_t c_str_len(struct tm const& t) 00267 { 00268 return c_str_len(&t); 00269 } 00270 00271 00280 inline basic_shim_string<ss_char_a_t> c_str_ptr_a(struct tm const& t) 00281 { 00282 return c_str_ptr_a(&t); 00283 } 00292 inline basic_shim_string<ss_char_a_t> c_str_ptr(struct tm const& t) 00293 { 00294 return c_str_ptr(&t); 00295 } 00296 00297 00306 inline basic_shim_string<ss_char_a_t> c_str_ptr_null_a(struct tm const& t) 00307 { 00308 return c_str_ptr_null_a(&t); 00309 } 00318 inline basic_shim_string<ss_char_a_t> c_str_ptr_null(struct tm const& t) 00319 { 00320 return c_str_ptr_null(&t); 00321 } 00322 00323 00324 /* ////////////////////////////////////////////////////////////////////// */ 00325 00326 #ifndef _STLSOFT_NO_NAMESPACE 00327 } // namespace stlsoft 00328 #endif /* _STLSOFT_NO_NAMESPACE */ 00329 00330 /* ////////////////////////////////////////////////////////////////////// */ 00331 00332 #endif /* !STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_TIME */ 00333 00334 /* ///////////////////////////// end of file //////////////////////////// */