00001 /* ///////////////////////////////////////////////////////////////////////// 00002 * File: acestl/memory/message_block_functions.hpp 00003 * 00004 * Purpose: Helper functions for ACE_Message_Block (and ACE_Data_Block) classes. 00005 * 00006 * Created: 23rd September 2004 00007 * Updated: 10th August 2009 00008 * 00009 * Home: http://stlsoft.org/ 00010 * 00011 * Copyright (c) 2004-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 ACESTL_INCL_ACESTL_MEMORY_HPP_MESSAGE_BLOCK_FUNCTIONS 00049 #define ACESTL_INCL_ACESTL_MEMORY_HPP_MESSAGE_BLOCK_FUNCTIONS 00050 00051 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION 00052 # define ACESTL_VER_ACESTL_MEMORY_HPP_MESSAGE_BLOCK_FUNCTIONS_MAJOR 2 00053 # define ACESTL_VER_ACESTL_MEMORY_HPP_MESSAGE_BLOCK_FUNCTIONS_MINOR 0 00054 # define ACESTL_VER_ACESTL_MEMORY_HPP_MESSAGE_BLOCK_FUNCTIONS_REVISION 3 00055 # define ACESTL_VER_ACESTL_MEMORY_HPP_MESSAGE_BLOCK_FUNCTIONS_EDIT 28 00056 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */ 00057 00058 /* ///////////////////////////////////////////////////////////////////////// 00059 * Includes 00060 */ 00061 00062 #ifndef ACESTL_INCL_ACESTL_HPP_ACESTL 00063 # include <acestl/acestl.hpp> 00064 #endif /* !ACESTL_INCL_ACESTL_HPP_ACESTL */ 00065 00066 #ifndef STLSOFT_INCL_ACE_H_MESSAGE_BLOCK 00067 # define STLSOFT_INCL_ACE_H_MESSAGE_BLOCK 00068 # include <ace/Message_Block.h> // for ACE_Message_Block 00069 #endif /* !STLSOFT_INCL_ACE_H_MESSAGE_BLOCK */ 00070 #ifndef STLSOFT_INCL_ACE_H_OS_MEMORY 00071 # define STLSOFT_INCL_ACE_H_OS_MEMORY 00072 # include <ace/OS_Memory.h> // for ACE_bad_alloc, ACE_NEW_THROWS_EXCEPTIONS 00073 #endif /* !STLSOFT_INCL_ACE_H_OS_MEMORY */ 00074 00075 /* ///////////////////////////////////////////////////////////////////////// 00076 * Namespace 00077 */ 00078 00079 #ifndef _ACESTL_NO_NAMESPACE 00080 # if defined(_STLSOFT_NO_NAMESPACE) || \ 00081 defined(STLSOFT_DOCUMENTATION_SKIP_SECTION) 00082 /* There is no stlsoft namespace, so must define ::acestl */ 00083 namespace acestl 00084 { 00085 # else 00086 /* Define stlsoft::acestl_project */ 00087 00088 namespace stlsoft 00089 { 00090 00091 namespace acestl_project 00092 { 00093 00094 # endif /* _STLSOFT_NO_NAMESPACE */ 00095 #endif /* !_ACESTL_NO_NAMESPACE */ 00096 00097 /* ///////////////////////////////////////////////////////////////////////// 00098 * Functions 00099 */ 00100 00127 inline ACE_Message_Block *make_copied_Message_Block(char const* p, as_size_t n) 00128 { 00129 #if defined(ACE_NEW_THROWS_EXCEPTIONS) 00130 try 00131 { 00132 #endif /* ACE_NEW_THROWS_EXCEPTIONS */ 00133 ACE_Message_Block *pmb = new ACE_Message_Block(n); 00134 00135 if(NULL == pmb) 00136 { 00137 errno = ENOMEM; 00138 } 00139 else 00140 { 00141 pmb->wr_ptr(n); 00142 00143 if(NULL != p) 00144 { 00145 ::memcpy(pmb->base(), p, n); 00146 } 00147 } 00148 00149 return pmb; 00150 #if defined(ACE_NEW_THROWS_EXCEPTIONS) 00151 } 00152 catch(ACE_bad_alloc) // TODO: This should be a reference, surely?? 00153 { 00154 return NULL; 00155 } 00156 #endif /* ACE_NEW_THROWS_EXCEPTIONS */ 00157 } 00158 00159 #if defined(STLSOFT_CF_STATIC_ARRAY_SIZE_DETERMINATION_SUPPORT) 00160 00161 template <ss_size_t N> 00162 inline ACE_Message_Block *make_copied_Message_Block(const char (&ar)[N]) 00163 { 00164 return make_copied_Message_Block(&ar[0], N); 00165 } 00166 00167 #endif /* STLSOFT_CF_STATIC_ARRAY_SIZE_DETERMINATION_SUPPORT */ 00168 00170 // Unit-testing 00171 00172 #ifdef STLSOFT_UNITTEST 00173 # include "./unittest/message_block_functions_unittest_.h" 00174 #endif /* STLSOFT_UNITTEST */ 00175 00176 /* ////////////////////////////////////////////////////////////////////// */ 00177 00178 #ifndef _ACESTL_NO_NAMESPACE 00179 # if defined(_STLSOFT_NO_NAMESPACE) || \ 00180 defined(STLSOFT_DOCUMENTATION_SKIP_SECTION) 00181 } // namespace acestl 00182 # else 00183 } // namespace acestl_project 00184 } // namespace stlsoft 00185 # endif /* _STLSOFT_NO_NAMESPACE */ 00186 #endif /* !_ACESTL_NO_NAMESPACE */ 00187 00188 /* ////////////////////////////////////////////////////////////////////// */ 00189 00190 #endif /* ACESTL_INCL_ACESTL_MEMORY_HPP_MESSAGE_BLOCK_FUNCTIONS */ 00191 00192 /* ///////////////////////////// end of file //////////////////////////// */