ACE::Value_Ptr< T > Class Template Reference

Smart pointer implementation designed for use as a class member. More...

#include <Value_Ptr.h>

Public Member Functions
	Value_Ptr (T *p=0)
	Constructor.
	~Value_Ptr ()
	Destructor.
T &	operator* () const
	Deference operator.
T *	operator-> () const
	Pointer operator.
void	swap (Value_Ptr &other)
	Value_Ptr (Value_Ptr const &other)
	Copy constructor.
Value_Ptr &	operator= (Value_Ptr const &other)
	Assignment operator.
template<typename U >
	Value_Ptr (Value_Ptr< U > const &other)
	Converting copy constructor.
template<typename U >
Value_Ptr &	operator= (Value_Ptr< U > const &other)
	Converting assignment operator.

Private Member Functions
template<typename U >
T *	create_from (U const *p) const
	Copying method invoked when copy constructing.

Private Attributes
T *	p_
	Object owned by this Value_Ptr.

Friends
template<typename U >
class	Value_Ptr

Detailed Description

template<typename T>
class ACE::Value_Ptr< T >

Smart pointer implementation designed for use as a class member.

Using a std::auto_ptr<> as a class member is sometimes problematic since ownership of memory is transferred when copying such members. This Value_Ptr class is explicitly designed to avoid such problems by performing copies of the underlying object rather than transfer ownership. This, for example, allows it to be readily used as a member in classes placed inside STL containers.

See also

Item 31 in "More Exceptional C++" by Herb Sutter.

Constructor & Destructor Documentation

Value_Ptr() [1/3]

template<typename T >

ACE::Value_Ptr< T >::Value_Ptr ( T * p = 0 )

inlineexplicit

Constructor.

~Value_Ptr()

template<typename T >

ACE::Value_Ptr< T >::~Value_Ptr ( )

inline

Destructor.

Value_Ptr() [2/3]

template<typename T >

ACE::Value_Ptr< T >::Value_Ptr ( Value_Ptr< T > const & other )

inline

Copy constructor.

Value_Ptr() [3/3]

template<typename T >

template<typename U >

ACE::Value_Ptr< T >::Value_Ptr ( Value_Ptr< U > const & other )

inline

Converting copy constructor.

Member Function Documentation

create_from()

template<typename T >

template<typename U >

T * ACE::Value_Ptr< T >::create_from ( U const * p ) const

inlineprivate

Copying method invoked when copy constructing.

operator*()

template<typename T >

T & ACE::Value_Ptr< T >::operator* ( ) const

inline

Deference operator.

operator->()

template<typename T >

T * ACE::Value_Ptr< T >::operator-> ( ) const

inline

Pointer operator.

operator=() [1/2]

template<typename T >

Value_Ptr & ACE::Value_Ptr< T >::operator= ( Value_Ptr< T > const & other )

inline

Assignment operator.

operator=() [2/2]

template<typename T >

template<typename U >

Value_Ptr & ACE::Value_Ptr< T >::operator= ( Value_Ptr< U > const & other )

inline

Converting assignment operator.

swap()

template<typename T >

void ACE::Value_Ptr< T >::swap ( Value_Ptr< T > & other )

inline

Non-throwing swap operation used to make assignment strongly exception-safe.

Note

As implemented, the swap operation may not work correctly for auto_ptr<>s, but why would one use an auto_ptr<> as the template argument for this particular template class!?

Friends And Related Symbol Documentation

Value_Ptr

template<typename T >

template<typename U >

friend class Value_Ptr

friend

Member Data Documentation

p_

template<typename T >

T* ACE::Value_Ptr< T >::p_

private

Object owned by this Value_Ptr.

---

The documentation for this class was generated from the following file:

• Value_Ptr.h