epoc32/include/stdapis/boost/scoped_ptr.hpp
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h)
This is the epoc32/include tree with the "platform" subtrees removed, and
all but a selected few mbg and rsg files removed.
     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 public:
    51 
    52     typedef T element_type;
    53 
    54     explicit scoped_ptr(T * p = 0): ptr(p) // never throws
    55     {
    56 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
    57         boost::sp_scalar_constructor_hook(ptr);
    58 #endif
    59     }
    60 
    61 #ifndef BOOST_NO_AUTO_PTR
    62 
    63     explicit scoped_ptr(std::auto_ptr<T> p): ptr(p.release()) // never throws
    64     {
    65 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
    66         boost::sp_scalar_constructor_hook(ptr);
    67 #endif
    68     }
    69 
    70 #endif
    71 
    72     ~scoped_ptr() // never throws
    73     {
    74 #if defined(BOOST_SP_ENABLE_DEBUG_HOOKS)
    75         boost::sp_scalar_destructor_hook(ptr);
    76 #endif
    77         boost::checked_delete(ptr);
    78     }
    79 
    80     void reset(T * p = 0) // never throws
    81     {
    82         BOOST_ASSERT(p == 0 || p != ptr); // catch self-reset errors
    83         this_type(p).swap(*this);
    84     }
    85 
    86     T & operator*() const // never throws
    87     {
    88         BOOST_ASSERT(ptr != 0);
    89         return *ptr;
    90     }
    91 
    92     T * operator->() const // never throws
    93     {
    94         BOOST_ASSERT(ptr != 0);
    95         return ptr;
    96     }
    97 
    98     T * get() const // never throws
    99     {
   100         return ptr;
   101     }
   102 
   103     // implicit conversion to "bool"
   104 
   105 #if defined(__SUNPRO_CC) && BOOST_WORKAROUND(__SUNPRO_CC, <= 0x530)
   106 
   107     operator bool () const
   108     {
   109         return ptr != 0;
   110     }
   111 
   112 #elif defined(__MWERKS__) && BOOST_WORKAROUND(__MWERKS__, BOOST_TESTED_AT(0x3003))
   113     typedef T * (this_type::*unspecified_bool_type)() const;
   114     
   115     operator unspecified_bool_type() const // never throws
   116     {
   117         return ptr == 0? 0: &this_type::get;
   118     }
   119 
   120 #else 
   121     typedef T * this_type::*unspecified_bool_type;
   122 
   123     operator unspecified_bool_type() const // never throws
   124     {
   125         return ptr == 0? 0: &this_type::ptr;
   126     }
   127 
   128 #endif
   129 
   130     bool operator! () const // never throws
   131     {
   132         return ptr == 0;
   133     }
   134 
   135     void swap(scoped_ptr & b) // never throws
   136     {
   137         T * tmp = b.ptr;
   138         b.ptr = ptr;
   139         ptr = tmp;
   140     }
   141 };
   142 
   143 template<class T> inline void swap(scoped_ptr<T> & a, scoped_ptr<T> & b) // never throws
   144 {
   145     a.swap(b);
   146 }
   147 
   148 // get_pointer(p) is a generic way to say p.get()
   149 
   150 template<class T> inline T * get_pointer(scoped_ptr<T> const & p)
   151 {
   152     return p.get();
   153 }
   154 
   155 } // namespace boost
   156 
   157 #endif // #ifndef BOOST_SCOPED_PTR_HPP_INCLUDED