Version: 3.1.0
wxSharedPtr< T > Class Template Reference

#include <wx/sharedptr.h>

+ Inheritance diagram for wxSharedPtr< T >:

Detailed Description

template<typename T>
class wxSharedPtr< T >

A smart pointer with non-intrusive reference counting.

It is modelled after boost::shared_ptr<> and can be used with STL containers and wxVector<T> unlike std::auto_ptr<> and wxScopedPtr<T>.

Library:  wxBase
Category:  Smart Pointers
See also
wxScopedPtr<T>, wxWeakRef<T>, wxObjectDataPtr<T>

Public Member Functions

wxEXPLICIT wxSharedPtr (T *ptr=NULL)
 Constructor. More...
 
template<typename Deleter >
wxEXPLICIT wxSharedPtr (T *ptr, Deleter d)
 Constructor. More...
 
 wxSharedPtr (const wxSharedPtr< T > &tocopy)
 Copy constructor. More...
 
 ~wxSharedPtr ()
 Destructor. More...
 
T * get () const
 Returns pointer to its object or NULL. More...
 
 operator unspecified_bool_type () const
 Conversion to a boolean expression (in a variant which is not convertible to anything but a boolean expression). More...
 
operator* () const
 Returns a reference to the object. More...
 
T * operator-> () const
 Smart pointer member access. More...
 
wxSharedPtr< T > & operator= (T *ptr)
 Assignment operator. More...
 
wxSharedPtr< T > & operator= (const wxSharedPtr< T > &tocopy)
 Assignment operator. More...
 
void reset (T *ptr=NULL)
 Reset pointer to ptr. More...
 
template<typename Deleter >
void reset (T *ptr, Deleter d)
 Reset pointer to ptr. More...
 
bool unique () const
 Returns true if this is the only pointer pointing to its object. More...
 
long use_count () const
 Returns the number of pointers pointing to its object. More...
 

Constructor & Destructor Documentation

template<typename T >
wxEXPLICIT wxSharedPtr< T >::wxSharedPtr ( T *  ptr = NULL)

Constructor.

Creates shared pointer from the raw pointer ptr and takes ownership of it.

template<typename T >
template<typename Deleter >
wxEXPLICIT wxSharedPtr< T >::wxSharedPtr ( T *  ptr,
Deleter  d 
)

Constructor.

Creates shared pointer from the raw pointer ptr and deleter d and takes ownership of it.

Parameters
ptrThe raw pointer.
dDeleter - a functor that is called instead of delete to free the ptr raw pointer when its reference count drops to zero.
Since
3.0
template<typename T >
wxSharedPtr< T >::wxSharedPtr ( const wxSharedPtr< T > &  tocopy)

Copy constructor.

template<typename T >
wxSharedPtr< T >::~wxSharedPtr ( )

Destructor.

Member Function Documentation

template<typename T >
T* wxSharedPtr< T >::get ( ) const

Returns pointer to its object or NULL.

template<typename T >
wxSharedPtr< T >::operator unspecified_bool_type ( ) const

Conversion to a boolean expression (in a variant which is not convertible to anything but a boolean expression).

If this class contains a valid pointer it will return true, if it contains a NULL pointer it will return false.

template<typename T >
T wxSharedPtr< T >::operator* ( ) const

Returns a reference to the object.

If the internal pointer is NULL this method will cause an assert in debug mode.

template<typename T >
T* wxSharedPtr< T >::operator-> ( ) const

Smart pointer member access.

Returns pointer to its object.

If the internal pointer is NULL this method will cause an assert in debug mode.

template<typename T >
wxSharedPtr<T>& wxSharedPtr< T >::operator= ( T *  ptr)

Assignment operator.

Releases any previously held pointer and creates a reference to ptr.

template<typename T >
wxSharedPtr<T>& wxSharedPtr< T >::operator= ( const wxSharedPtr< T > &  tocopy)

Assignment operator.

Releases any previously held pointer and creates a reference to the same object as topcopy.

template<typename T >
void wxSharedPtr< T >::reset ( T *  ptr = NULL)

Reset pointer to ptr.

If the reference count of the previously owned pointer was 1 it will be deleted.

template<typename T >
template<typename Deleter >
void wxSharedPtr< T >::reset ( T *  ptr,
Deleter  d 
)

Reset pointer to ptr.

If the reference count of the previously owned pointer was 1 it will be deleted.

Parameters
ptrThe new raw pointer.
dDeleter - a functor that is called instead of delete to free the ptr raw pointer when its reference count drops to zero.
Since
3.0
template<typename T >
bool wxSharedPtr< T >::unique ( ) const

Returns true if this is the only pointer pointing to its object.

template<typename T >
long wxSharedPtr< T >::use_count ( ) const

Returns the number of pointers pointing to its object.