libstdc++-v3/include/bits/stl_construct.h

   1 // nonstandard construct and destroy functions -*- C++ -*-
   2
   3 // Copyright (C) 2001 Free Software Foundation, Inc.
   4 //
   5 // This file is part of the GNU ISO C++ Library.  This library is free
   6 // software; you can redistribute it and/or modify it under the
   7 // terms of the GNU General Public License as published by the
   8 // Free Software Foundation; either version 2, or (at your option)
   9 // any later version.
  10
  11 // This library is distributed in the hope that it will be useful,
  12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 // GNU General Public License for more details.
  15
  16 // You should have received a copy of the GNU General Public License along
  17 // with this library; see the file COPYING.  If not, write to the Free
  18 // Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307,
  19 // USA.
  20
  21 // As a special exception, you may use this file as part of a free software
  22 // library without restriction.  Specifically, if other files instantiate
  23 // templates or use macros or inline functions from this file, or you compile
  24 // this file and link it with other files to produce an executable, this
  25 // file does not by itself cause the resulting executable to be covered by
  26 // the GNU General Public License.  This exception does not however
  27 // invalidate any other reasons why the executable file might be covered by
  28 // the GNU General Public License.
  29
  30 /*
  31  *
  32  * Copyright (c) 1994
  33  * Hewlett-Packard Company
  34  *
  35  * Permission to use, copy, modify, distribute and sell this software
  36  * and its documentation for any purpose is hereby granted without fee,
  37  * provided that the above copyright notice appear in all copies and
  38  * that both that copyright notice and this permission notice appear
  39  * in supporting documentation.  Hewlett-Packard Company makes no
  40  * representations about the suitability of this software for any
  41  * purpose.  It is provided "as is" without express or implied warranty.
  42  *
  43  *
  44  * Copyright (c) 1996,1997
  45  * Silicon Graphics Computer Systems, Inc.
  46  *
  47  * Permission to use, copy, modify, distribute and sell this software
  48  * and its documentation for any purpose is hereby granted without fee,
  49  * provided that the above copyright notice appear in all copies and
  50  * that both that copyright notice and this permission notice appear
  51  * in supporting documentation.  Silicon Graphics makes no
  52  * representations about the suitability of this software for any
  53  * purpose.  It is provided "as is" without express or implied warranty.
  54  */
  55
  56 /* NOTE: This is an internal header file, included by other STL headers.
  57  *   You should not attempt to use it directly.
  58  */
  59
  60 #ifndef _CPP_BITS_STL_CONSTRUCT_H
  61 #define _CPP_BITS_STL_CONSTRUCT_H 1
  62
  63 #include <new>
  64
  65 namespace std
  66 {
  67
  68 // construct and destroy.  These functions are not part of the C++ standard,
  69 // and are provided for backward compatibility with the HP STL. We also
  70 // provide internal names _Construct and _Destroy that can be used within
  71 // the library, so that standard-conforming pieces don't have to rely on
  72 // non-standard extensions.
  73
  74 // Internal names
  75
  76 template <class _T1, class _T2>
  77 inline void _Construct(_T1* __p, const _T2& __value) {
  78 new ((void*) __p) _T1(__value);
  79 }
  80
  81 template <class _T1>
  82 inline void _Construct(_T1* __p) {
  83   new ((void*) __p) _T1();
  84 }
  85
  86 template <class _Tp>
  87 inline void _Destroy(_Tp* __pointer) {
  88   __pointer->~_Tp();
  89 }
  90
  91 template <class _ForwardIterator>
  92 void
  93 __destroy_aux(_ForwardIterator __first, _ForwardIterator __last, __false_type)
  94 {
  95   for ( ; __first != __last; ++__first)
  96     destroy(&*__first);
  97 }
  98
  99 template <class _ForwardIterator>
 100 inline void __destroy_aux(_ForwardIterator, _ForwardIterator, __true_type) {}
 101
 102 template <class _ForwardIterator, class _Tp>
 103 inline void
 104 __destroy(_ForwardIterator __first, _ForwardIterator __last, _Tp*)
 105 {
 106   typedef typename __type_traits<_Tp>::has_trivial_destructor
 107           _Trivial_destructor;
 108   __destroy_aux(__first, __last, _Trivial_destructor());
 109 }
 110
 111 template <class _ForwardIterator>
 112 inline void _Destroy(_ForwardIterator __first, _ForwardIterator __last) {
 113   __destroy(__first, __last, __value_type(__first));
 114 }
 115
 116 inline void _Destroy(char*, char*) {}
 117 inline void _Destroy(int*, int*) {}
 118 inline void _Destroy(long*, long*) {}
 119 inline void _Destroy(float*, float*) {}
 120 inline void _Destroy(double*, double*) {}
 121 inline void _Destroy(wchar_t*, wchar_t*) {}
 122
 123 // --------------------------------------------------
 124 // Old names from the HP STL.
 125
 126 template <class _T1, class _T2>
 127 inline void construct(_T1* __p, const _T2& __value) {
 128   _Construct(__p, __value);
 129 }
 130
 131 template <class _T1>
 132 inline void construct(_T1* __p) {
 133   _Construct(__p);
 134 }
 135
 136 template <class _Tp>
 137 inline void destroy(_Tp* __pointer) {
 138   _Destroy(__pointer);
 139 }
 140
 141 template <class _ForwardIterator>
 142 inline void destroy(_ForwardIterator __first, _ForwardIterator __last) {
 143   _Destroy(__first, __last);
 144 }
 145
 146 } // namespace std
 147
 148 #endif /* _CPP_BITS_STL_CONSTRUCT_H */
 149
 150 // Local Variables:
 151 // mode:C++
 152 // End: