boost/boost/scoped_ptr.hpp

   1 #ifndef BOOST_SCOPED_PTR_HPP_INCLUDED
   2 #define BOOST_SCOPED_PTR_HPP_INCLUDED
   3
   4 //  (C) Copyright Greg Colvin and Beman Dawes 1998, 1999.
   5 //  Copyright (c) 2001, 2002 Peter Dimov
   6 //
   7 //  Distributed under the Boost Software License, Version 1.0. (See
   8 //  accompanying file LICENSE_1_0.txt or copy at
   9 //  http://www.boost.org/LICENSE_1_0.txt)
  10 //
  11 //  http://www.boost.org/libs/smart_ptr/scoped_ptr.htm
  12 //
  13
  14 #include <boost/assert.hpp>
  15 #include <boost/checked_delete.hpp>
  16 #include <boost/detail/workaround.hpp>
  17
  18 #ifndef BOOST_NO_AUTO_PTR
  19 # include <memory>          // for std::auto_ptr
  20 #endif
  21
  22 namespace boost
  23 {
  24
  25 // Debug hooks
  26
  27 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
  28
  29 void sp_scalar_constructor_hook(void * p);
  30 void sp_scalar_destructor_hook(void * p);
  31
  32 #endif
  33
  34 //  scoped_ptr mimics a built-in pointer except that it guarantees deletion
  35 //  of the object pointed to, either on destruction of the scoped_ptr or via
  36 //  an explicit reset(). scoped_ptr is a simple solution for simple needs;
  37 //  use shared_ptr or std::auto_ptr if your needs are more complex.
  38
  39 template<class T> class scoped_ptr // noncopyable
  40 {
  41 private:
  42
  43     T * ptr;
  44
  45     scoped_ptr(scoped_ptr const &);
  46     scoped_ptr & operator=(scoped_ptr const &);
  47
  48     typedef scoped_ptr<T> this_type;
  49
  50     void operator==( scoped_ptr const& ) const;
  51     void operator!=( scoped_ptr const& ) const;
  52
  53 public:
  54
  55     typedef T element_type;
  56
  57     explicit scoped_ptr(T * p = 0): ptr(p) // never throws
  58     {
  59 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
  60         boost::sp_scalar_constructor_hook(ptr);
  61 #endif
  62     }
  63
  64 #ifndef BOOST_NO_AUTO_PTR
  65
  66     explicit scoped_ptr(std::auto_ptr<T> p): ptr(p.release()) // never throws
  67     {
  68 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
  69         boost::sp_scalar_constructor_hook(ptr);
  70 #endif
  71     }
  72
  73 #endif
  74
  75     ~scoped_ptr() // never throws
  76     {
  77 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
  78         boost::sp_scalar_destructor_hook(ptr);
  79 #endif
  80         boost::checked_delete(ptr);
  81     }
  82
  83     void reset(T * p = 0) // never throws
  84     {
  85         BOOST_ASSERT(p == 0 || p != ptr); // catch self-reset errors
  86         this_type(p).swap(*this);
  87     }
  88
  89     T & operator*() const // never throws
  90     {
  91         BOOST_ASSERT(ptr != 0);
  92         return *ptr;
  93     }
  94
  95     T * operator->() const // never throws
  96     {
  97         BOOST_ASSERT(ptr != 0);
  98         return ptr;
  99     }
 100
 101     T * get() const // never throws
 102     {
 103         return ptr;
 104     }
 105
 106     // implicit conversion to "bool"
 107
 108 #if defined(__SUNPRO_CC) && BOOST_WORKAROUND(__SUNPRO_CC, <= 0x530)
 109
 110     operator bool () const
 111     {
 112         return ptr != 0;
 113     }
 114
 115 #elif defined(__MWERKS__) && BOOST_WORKAROUND(__MWERKS__, BOOST_TESTED_AT(0x3003))
 116     typedef T * (this_type::*unspecified_bool_type)() const;
 117
 118     operator unspecified_bool_type() const // never throws
 119     {
 120         return ptr == 0? 0: &this_type::get;
 121     }
 122
 123 #else
 124     typedef T * this_type::*unspecified_bool_type;
 125
 126     operator unspecified_bool_type() const // never throws
 127     {
 128         return ptr == 0? 0: &this_type::ptr;
 129     }
 130
 131 #endif
 132
 133     bool operator! () const // never throws
 134     {
 135         return ptr == 0;
 136     }
 137
 138     void swap(scoped_ptr & b) // never throws
 139     {
 140         T * tmp = b.ptr;
 141         b.ptr = ptr;
 142         ptr = tmp;
 143     }
 144 };
 145
 146 template<class T> inline void swap(scoped_ptr<T> & a, scoped_ptr<T> & b) // never throws
 147 {
 148     a.swap(b);
 149 }
 150
 151 // get_pointer(p) is a generic way to say p.get()
 152
 153 template<class T> inline T * get_pointer(scoped_ptr<T> const & p)
 154 {
 155     return p.get();
 156 }
 157
 158 } // namespace boost
 159
 160 #endif // #ifndef BOOST_SCOPED_PTR_HPP_INCLUDED