1 #ifndef BOOST_SCOPED_PTR_HPP_INCLUDED
2 #define BOOST_SCOPED_PTR_HPP_INCLUDED
4 // (C) Copyright Greg Colvin and Beman Dawes 1998, 1999.
5 // Copyright (c) 2001, 2002 Peter Dimov
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)
11 // http://www.boost.org/libs/smart_ptr/scoped_ptr.htm
14 #include <boost/assert.hpp>
15 #include <boost/checked_delete.hpp>
16 #include <boost/detail/workaround.hpp>
18 #ifndef BOOST_NO_AUTO_PTR
19 # include <memory> // for std::auto_ptr
27 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
29 void sp_scalar_constructor_hook(void * p);
30 void sp_scalar_destructor_hook(void * p);
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.
39 template<class T> class scoped_ptr // noncopyable
45 scoped_ptr(scoped_ptr const &);
46 scoped_ptr & operator=(scoped_ptr const &);
48 typedef scoped_ptr<T> this_type;
50 void operator==( scoped_ptr const& ) const;
51 void operator!=( scoped_ptr const& ) const;
55 typedef T element_type;
57 explicit scoped_ptr(T * p = 0): ptr(p) // never throws
59 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
60 boost::sp_scalar_constructor_hook(ptr);
64 #ifndef BOOST_NO_AUTO_PTR
66 explicit scoped_ptr(std::auto_ptr<T> p): ptr(p.release()) // never throws
68 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
69 boost::sp_scalar_constructor_hook(ptr);
75 ~scoped_ptr() // never throws
77 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
78 boost::sp_scalar_destructor_hook(ptr);
80 boost::checked_delete(ptr);
83 void reset(T * p = 0) // never throws
85 BOOST_ASSERT(p == 0 || p != ptr); // catch self-reset errors
86 this_type(p).swap(*this);
89 T & operator*() const // never throws
91 BOOST_ASSERT(ptr != 0);
95 T * operator->() const // never throws
97 BOOST_ASSERT(ptr != 0);
101 T * get() const // never throws
106 // implicit conversion to "bool"
108 #if defined(__SUNPRO_CC) && BOOST_WORKAROUND(__SUNPRO_CC, <= 0x530)
110 operator bool () const
115 #elif defined(__MWERKS__) && BOOST_WORKAROUND(__MWERKS__, BOOST_TESTED_AT(0x3003))
116 typedef T * (this_type::*unspecified_bool_type)() const;
118 operator unspecified_bool_type() const // never throws
120 return ptr == 0? 0: &this_type::get;
124 typedef T * this_type::*unspecified_bool_type;
126 operator unspecified_bool_type() const // never throws
128 return ptr == 0? 0: &this_type::ptr;
133 bool operator! () const // never throws
138 void swap(scoped_ptr & b) // never throws
146 template<class T> inline void swap(scoped_ptr<T> & a, scoped_ptr<T> & b) // never throws
151 // get_pointer(p) is a generic way to say p.get()
153 template<class T> inline T * get_pointer(scoped_ptr<T> const & p)
160 #endif // #ifndef BOOST_SCOPED_PTR_HPP_INCLUDED