00001 /* ///////////////////////////////////////////////////////////////////////// 00002 * File: stlsoft/util/placement_aid.hpp 00003 * 00004 * Purpose: A scoping class to aid in placement new-ing. 00005 * 00006 * Created: 9th January 2002 00007 * Updated: 10th August 2009 00008 * 00009 * Home: http://stlsoft.org/ 00010 * 00011 * Copyright (c) 2002-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_UTIL_HPP_PLACEMENT_AID 00048 #define STLSOFT_INCL_STLSOFT_UTIL_HPP_PLACEMENT_AID 00049 00050 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION 00051 # define STLSOFT_VER_STLSOFT_UTIL_HPP_PLACEMENT_AID_MAJOR 4 00052 # define STLSOFT_VER_STLSOFT_UTIL_HPP_PLACEMENT_AID_MINOR 0 00053 # define STLSOFT_VER_STLSOFT_UTIL_HPP_PLACEMENT_AID_REVISION 2 00054 # define STLSOFT_VER_STLSOFT_UTIL_HPP_PLACEMENT_AID_EDIT 33 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 00065 #ifndef STLSOFT_INCL_NEW 00066 # define STLSOFT_INCL_NEW 00067 # include <new> 00068 #endif /* !STLSOFT_INCL_NEW */ 00069 00070 /* ///////////////////////////////////////////////////////////////////////// 00071 * Namespace 00072 */ 00073 00074 #ifndef _STLSOFT_NO_NAMESPACE 00075 namespace stlsoft 00076 { 00077 #endif /* _STLSOFT_NO_NAMESPACE */ 00078 00079 /* ///////////////////////////////////////////////////////////////////////// 00080 * Classes 00081 */ 00082 00083 // class placement_aid 00084 00093 template <ss_typename_param_k T> 00094 class placement_aid 00095 { 00096 public: 00098 typedef T value_type; 00100 typedef placement_aid<T> class_type; 00101 00102 // Construction 00103 public: 00107 ss_explicit_k placement_aid(void *pv) 00108 : m_t(*new(pv) T()) 00109 {} 00110 00112 ~placement_aid() stlsoft_throw_0() 00113 { 00114 m_t.~T(); 00115 } 00116 00117 // Accessors 00118 public: 00120 operator T &() 00121 { 00122 return m_t; 00123 } 00125 operator T const& () const 00126 { 00127 return m_t; 00128 } 00129 00131 T *operator &() 00132 { 00133 return &m_t; 00134 } 00136 T const* operator &() const 00137 { 00138 return &m_t; 00139 } 00140 00141 // Members 00142 private: 00143 T &m_t; 00144 00145 // Not to be implemented 00146 private: 00147 placement_aid(class_type const&); 00148 class_type const& operator =(class_type const&); 00149 }; 00150 00151 /* ////////////////////////////////////////////////////////////////////// */ 00152 00153 #ifndef _STLSOFT_NO_NAMESPACE 00154 } // namespace stlsoft 00155 #endif /* _STLSOFT_NO_NAMESPACE */ 00156 00157 /* ////////////////////////////////////////////////////////////////////// */ 00158 00159 #endif /* !STLSOFT_INCL_STLSOFT_UTIL_HPP_PLACEMENT_AID */ 00160 00161 /* ///////////////////////////// end of file //////////////////////////// */