00001 /* ///////////////////////////////////////////////////////////////////////// 00002 * File: stlsoft/string/copy_functions.hpp 00003 * 00004 * Purpose: String utility functions for copying. 00005 * 00006 * Created: 13th June 2006 00007 * Updated: 10th August 2009 00008 * 00009 * Home: http://stlsoft.org/ 00010 * 00011 * Copyright (c) 2006-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 00047 #ifndef STLSOFT_INCL_STLSOFT_STRING_HPP_COPY_FUNCTIONS 00048 #define STLSOFT_INCL_STLSOFT_STRING_HPP_COPY_FUNCTIONS 00049 00050 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION 00051 # define STLSOFT_VER_INCL_STLSOFT_STRING_HPP_COPY_FUNCTIONS_MAJOR 1 00052 # define STLSOFT_VER_INCL_STLSOFT_STRING_HPP_COPY_FUNCTIONS_MINOR 0 00053 # define STLSOFT_VER_INCL_STLSOFT_STRING_HPP_COPY_FUNCTIONS_REVISION 2 00054 # define STLSOFT_VER_INCL_STLSOFT_STRING_HPP_COPY_FUNCTIONS_EDIT 7 00055 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */ 00056 00057 /* ///////////////////////////////////////////////////////////////////////// 00058 * Includes 00059 */ 00060 00061 #ifndef STLSOFT_INCL_STLSOFT_H_STLSOFT 00062 # include <stlsoft/stlsoft.h> 00063 #endif /* !STLSOFT_INCL_STLSOFT_H_STLSOFT */ 00064 #ifndef STLSOFT_INCL_STLSOFT_STRING_HPP_CHAR_TRAITS 00065 # include <stlsoft/string/char_traits.hpp> 00066 #endif /* !STLSOFT_INCL_STLSOFT_STRING_HPP_CHAR_TRAITS */ 00067 00068 #ifdef STLSOFT_UNITTEST 00069 # include <string.h> 00070 #endif /* STLSOFT_UNITTEST */ 00071 00072 /* ///////////////////////////////////////////////////////////////////////// 00073 * Namespace 00074 */ 00075 00076 #ifndef _STLSOFT_NO_NAMESPACE 00077 namespace stlsoft 00078 { 00079 #endif /* _STLSOFT_NO_NAMESPACE */ 00080 00081 /* ////////////////////////////////////////////////////////////////////// */ 00082 00097 template <ss_typename_param_k C> 00098 inline ss_size_t copy_contents(C *dest, ss_size_t cchDest, C const* src, ss_size_t cchSource) 00099 { 00100 STLSOFT_ASSERT(NULL != src); 00101 00102 if(NULL == dest) 00103 { 00104 return cchSource; 00105 } 00106 else 00107 { 00108 typedef C char_t; 00109 typedef stlsoft_char_traits<C> traits_t; 00110 00111 const ss_size_t cchContent = (cchSource < cchDest) ? cchSource : cchDest; 00112 00113 traits_t::copy(dest, src, cchContent); 00114 00115 if(cchContent < cchDest) 00116 { 00117 traits_t::assign(&dest[cchContent], cchDest - cchContent, 0); 00118 } 00119 00120 return cchContent; 00121 } 00122 } 00123 00125 // Unit-testing 00126 00127 #ifdef STLSOFT_UNITTEST 00128 # include "./unittest/copy_functions_unittest_.h" 00129 #endif /* STLSOFT_UNITTEST */ 00130 00131 /* ////////////////////////////////////////////////////////////////////// */ 00132 00133 #ifndef _STLSOFT_NO_NAMESPACE 00134 } // namespace stlsoft 00135 #endif /* _STLSOFT_NO_NAMESPACE */ 00136 00137 /* ////////////////////////////////////////////////////////////////////// */ 00138 00139 #endif /* !STLSOFT_INCL_STLSOFT_STRING_HPP_COPY_FUNCTIONS */ 00140 00141 /* ///////////////////////////// end of file //////////////////////////// */