williamr@2: #ifndef BOOST_INTRUSIVE_PTR_HPP_INCLUDED
williamr@2: #define BOOST_INTRUSIVE_PTR_HPP_INCLUDED
williamr@2: 
williamr@2: //
williamr@2: //  intrusive_ptr.hpp
williamr@2: //
williamr@2: //  Copyright (c) 2001, 2002 Peter Dimov
williamr@2: //
williamr@2: // Distributed under the Boost Software License, Version 1.0. (See
williamr@2: // accompanying file LICENSE_1_0.txt or copy at
williamr@2: // http://www.boost.org/LICENSE_1_0.txt)
williamr@2: //
williamr@2: //  See http://www.boost.org/libs/smart_ptr/intrusive_ptr.html for documentation.
williamr@2: //
williamr@2: 
williamr@2: #include <boost/config.hpp>
williamr@2: 
williamr@2: #ifdef BOOST_MSVC  // moved here to work around VC++ compiler crash
williamr@2: # pragma warning(push)
williamr@2: # pragma warning(disable:4284) // odd return type for operator->
williamr@2: #endif
williamr@2: 
williamr@2: #include <boost/assert.hpp>
williamr@2: #include <boost/detail/workaround.hpp>
williamr@2: 
williamr@2: #include <functional>           // for std::less
williamr@2: #include <iosfwd>               // for std::basic_ostream
williamr@2: 
williamr@2: 
williamr@2: namespace boost
williamr@2: {
williamr@2: 
williamr@2: //
williamr@2: //  intrusive_ptr
williamr@2: //
williamr@2: //  A smart pointer that uses intrusive reference counting.
williamr@2: //
williamr@2: //  Relies on unqualified calls to
williamr@2: //  
williamr@2: //      void intrusive_ptr_add_ref(T * p);
williamr@2: //      void intrusive_ptr_release(T * p);
williamr@2: //
williamr@2: //          (p != 0)
williamr@2: //
williamr@2: //  The object is responsible for destroying itself.
williamr@2: //
williamr@2: 
williamr@2: template<class T> class intrusive_ptr
williamr@2: {
williamr@2: private:
williamr@2: 
williamr@2:     typedef intrusive_ptr this_type;
williamr@2: 
williamr@2: public:
williamr@2: 
williamr@2:     typedef T element_type;
williamr@2: 
williamr@2:     intrusive_ptr(): p_(0)
williamr@2:     {
williamr@2:     }
williamr@2: 
williamr@2:     intrusive_ptr(T * p, bool add_ref = true): p_(p)
williamr@2:     {
williamr@2:         if(p_ != 0 && add_ref) intrusive_ptr_add_ref(p_);
williamr@2:     }
williamr@2: 
williamr@2: #if !defined(BOOST_NO_MEMBER_TEMPLATES) || defined(BOOST_MSVC6_MEMBER_TEMPLATES)
williamr@2: 
williamr@2:     template<class U> intrusive_ptr(intrusive_ptr<U> const & rhs): p_(rhs.get())
williamr@2:     {
williamr@2:         if(p_ != 0) intrusive_ptr_add_ref(p_);
williamr@2:     }
williamr@2: 
williamr@2: #endif
williamr@2: 
williamr@2:     intrusive_ptr(intrusive_ptr const & rhs): p_(rhs.p_)
williamr@2:     {
williamr@2:         if(p_ != 0) intrusive_ptr_add_ref(p_);
williamr@2:     }
williamr@2: 
williamr@2:     ~intrusive_ptr()
williamr@2:     {
williamr@2:         if(p_ != 0) intrusive_ptr_release(p_);
williamr@2:     }
williamr@2: 
williamr@2: #if !defined(BOOST_NO_MEMBER_TEMPLATES) || defined(BOOST_MSVC6_MEMBER_TEMPLATES)
williamr@2: 
williamr@2:     template<class U> intrusive_ptr & operator=(intrusive_ptr<U> const & rhs)
williamr@2:     {
williamr@2:         this_type(rhs).swap(*this);
williamr@2:         return *this;
williamr@2:     }
williamr@2: 
williamr@2: #endif
williamr@2: 
williamr@2:     intrusive_ptr & operator=(intrusive_ptr const & rhs)
williamr@2:     {
williamr@2:         this_type(rhs).swap(*this);
williamr@2:         return *this;
williamr@2:     }
williamr@2: 
williamr@2:     intrusive_ptr & operator=(T * rhs)
williamr@2:     {
williamr@2:         this_type(rhs).swap(*this);
williamr@2:         return *this;
williamr@2:     }
williamr@2: 
williamr@2:     T * get() const
williamr@2:     {
williamr@2:         return p_;
williamr@2:     }
williamr@2: 
williamr@2:     T & operator*() const
williamr@2:     {
williamr@2:         return *p_;
williamr@2:     }
williamr@2: 
williamr@2:     T * operator->() const
williamr@2:     {
williamr@2:         return p_;
williamr@2:     }
williamr@2: 
williamr@2: #if defined(__SUNPRO_CC) && BOOST_WORKAROUND(__SUNPRO_CC, <= 0x530)
williamr@2: 
williamr@2:     operator bool () const
williamr@2:     {
williamr@2:         return p_ != 0;
williamr@2:     }
williamr@2: 
williamr@2: #elif defined(__MWERKS__) && BOOST_WORKAROUND(__MWERKS__, BOOST_TESTED_AT(0x3003))
williamr@2:     typedef T * (this_type::*unspecified_bool_type)() const;
williamr@2:     
williamr@2:     operator unspecified_bool_type() const // never throws
williamr@2:     {
williamr@2:         return p_ == 0? 0: &this_type::get;
williamr@2:     }
williamr@2: 
williamr@2: #else 
williamr@2: 
williamr@2:     typedef T * this_type::*unspecified_bool_type;
williamr@2: 
williamr@2:     operator unspecified_bool_type () const
williamr@2:     {
williamr@2:         return p_ == 0? 0: &this_type::p_;
williamr@2:     }
williamr@2: 
williamr@2: #endif
williamr@2: 
williamr@2:     // operator! is a Borland-specific workaround
williamr@2:     bool operator! () const
williamr@2:     {
williamr@2:         return p_ == 0;
williamr@2:     }
williamr@2: 
williamr@2:     void swap(intrusive_ptr & rhs)
williamr@2:     {
williamr@2:         T * tmp = p_;
williamr@2:         p_ = rhs.p_;
williamr@2:         rhs.p_ = tmp;
williamr@2:     }
williamr@2: 
williamr@2: private:
williamr@2: 
williamr@2:     T * p_;
williamr@2: };
williamr@2: 
williamr@2: template<class T, class U> inline bool operator==(intrusive_ptr<T> const & a, intrusive_ptr<U> const & b)
williamr@2: {
williamr@2:     return a.get() == b.get();
williamr@2: }
williamr@2: 
williamr@2: template<class T, class U> inline bool operator!=(intrusive_ptr<T> const & a, intrusive_ptr<U> const & b)
williamr@2: {
williamr@2:     return a.get() != b.get();
williamr@2: }
williamr@2: 
williamr@2: template<class T, class U> inline bool operator==(intrusive_ptr<T> const & a, U * b)
williamr@2: {
williamr@2:     return a.get() == b;
williamr@2: }
williamr@2: 
williamr@2: template<class T, class U> inline bool operator!=(intrusive_ptr<T> const & a, U * b)
williamr@2: {
williamr@2:     return a.get() != b;
williamr@2: }
williamr@2: 
williamr@2: template<class T, class U> inline bool operator==(T * a, intrusive_ptr<U> const & b)
williamr@2: {
williamr@2:     return a == b.get();
williamr@2: }
williamr@2: 
williamr@2: template<class T, class U> inline bool operator!=(T * a, intrusive_ptr<U> const & b)
williamr@2: {
williamr@2:     return a != b.get();
williamr@2: }
williamr@2: 
williamr@2: #if __GNUC__ == 2 && __GNUC_MINOR__ <= 96
williamr@2: 
williamr@2: // Resolve the ambiguity between our op!= and the one in rel_ops
williamr@2: 
williamr@2: template<class T> inline bool operator!=(intrusive_ptr<T> const & a, intrusive_ptr<T> const & b)
williamr@2: {
williamr@2:     return a.get() != b.get();
williamr@2: }
williamr@2: 
williamr@2: #endif
williamr@2: 
williamr@2: template<class T> inline bool operator<(intrusive_ptr<T> const & a, intrusive_ptr<T> const & b)
williamr@2: {
williamr@2:     return std::less<T *>()(a.get(), b.get());
williamr@2: }
williamr@2: 
williamr@2: template<class T> void swap(intrusive_ptr<T> & lhs, intrusive_ptr<T> & rhs)
williamr@2: {
williamr@2:     lhs.swap(rhs);
williamr@2: }
williamr@2: 
williamr@2: // mem_fn support
williamr@2: 
williamr@2: template<class T> T * get_pointer(intrusive_ptr<T> const & p)
williamr@2: {
williamr@2:     return p.get();
williamr@2: }
williamr@2: 
williamr@2: template<class T, class U> intrusive_ptr<T> static_pointer_cast(intrusive_ptr<U> const & p)
williamr@2: {
williamr@2:     return static_cast<T *>(p.get());
williamr@2: }
williamr@2: 
williamr@2: template<class T, class U> intrusive_ptr<T> const_pointer_cast(intrusive_ptr<U> const & p)
williamr@2: {
williamr@2:     return const_cast<T *>(p.get());
williamr@2: }
williamr@2: 
williamr@2: template<class T, class U> intrusive_ptr<T> dynamic_pointer_cast(intrusive_ptr<U> const & p)
williamr@2: {
williamr@2:     return dynamic_cast<T *>(p.get());
williamr@2: }
williamr@2: 
williamr@2: // operator<<
williamr@2: 
williamr@2: #if defined(__GNUC__) &&  (__GNUC__ < 3)
williamr@2: 
williamr@2: template<class Y> std::ostream & operator<< (std::ostream & os, intrusive_ptr<Y> const & p)
williamr@2: {
williamr@2:     os << p.get();
williamr@2:     return os;
williamr@2: }
williamr@2: 
williamr@2: #else
williamr@2: 
williamr@2: // in STLport's no-iostreams mode no iostream symbols can be used
williamr@2: #ifndef _STLP_NO_IOSTREAMS
williamr@2: 
williamr@2: # if defined(BOOST_MSVC) && BOOST_WORKAROUND(BOOST_MSVC, < 1300 && __SGI_STL_PORT)
williamr@2: // MSVC6 has problems finding std::basic_ostream through the using declaration in namespace _STL
williamr@2: using std::basic_ostream;
williamr@2: template<class E, class T, class Y> basic_ostream<E, T> & operator<< (basic_ostream<E, T> & os, intrusive_ptr<Y> const & p)
williamr@2: # else
williamr@2: template<class E, class T, class Y> std::basic_ostream<E, T> & operator<< (std::basic_ostream<E, T> & os, intrusive_ptr<Y> const & p)
williamr@2: # endif 
williamr@2: {
williamr@2:     os << p.get();
williamr@2:     return os;
williamr@2: }
williamr@2: 
williamr@2: #endif // _STLP_NO_IOSTREAMS
williamr@2: 
williamr@2: #endif // __GNUC__ < 3
williamr@2: 
williamr@2: } // namespace boost
williamr@2: 
williamr@2: #ifdef BOOST_MSVC
williamr@2: # pragma warning(pop)
williamr@2: #endif    
williamr@2: 
williamr@2: #endif  // #ifndef BOOST_INTRUSIVE_PTR_HPP_INCLUDED