Poco::SharedPtr< C, RC, RP > Class Template Reference

#include <SharedPtr.h>

Public Member Functions
template<class Other , class OtherRP >
SharedPtr &	assign (const SharedPtr< Other, RC, OtherRP > &ptr)
SharedPtr &	assign (const SharedPtr &ptr)
SharedPtr &	assign (C *ptr)
template<class Other >
SharedPtr< Other, RC, RP >	cast () const
const C *	get () const
C *	get ()
bool	isNull () const
	operator C * ()
	operator const C * () const
bool	operator! () const
bool	operator!= (C *ptr) const
bool	operator!= (const C *ptr) const
bool	operator!= (const SharedPtr &ptr) const
const C &	operator* () const
C &	operator* ()
const C *	operator-> () const
C *	operator-> ()
bool	operator< (C *ptr) const
bool	operator< (const C *ptr) const
bool	operator< (const SharedPtr &ptr) const
bool	operator<= (C *ptr) const
bool	operator<= (const C *ptr) const
bool	operator<= (const SharedPtr &ptr) const
template<class Other , class OtherRP >
SharedPtr &	operator= (const SharedPtr< Other, RC, OtherRP > &ptr)
SharedPtr &	operator= (const SharedPtr &ptr)
SharedPtr &	operator= (C *ptr)
bool	operator== (C *ptr) const
bool	operator== (const C *ptr) const
bool	operator== (const SharedPtr &ptr) const
bool	operator> (C *ptr) const
bool	operator> (const C *ptr) const
bool	operator> (const SharedPtr &ptr) const
bool	operator>= (C *ptr) const
bool	operator>= (const C *ptr) const
bool	operator>= (const SharedPtr &ptr) const
int	referenceCount () const
	SharedPtr (const SharedPtr &ptr)
template<class Other , class OtherRP >
	SharedPtr (const SharedPtr< Other, RC, OtherRP > &ptr)
	SharedPtr (C *ptr)
	SharedPtr ()
void	swap (SharedPtr &ptr)
template<class Other >
SharedPtr< Other, RC, RP >	unsafeCast () const
	~SharedPtr ()
Private Member Functions
C *	deref () const
void	release ()
	SharedPtr (RC pCounter, C ptr)
Private Attributes
RC *	_pCounter
C *	_ptr
Friends
class	SharedPtr

Detailed Description

template<class C, class RC = ReferenceCounter, class RP = ReleasePolicy<C>>
class Poco::SharedPtr< C, RC, RP >

SharedPtr is a "smart" pointer for classes implementing reference counting based garbage collection. SharedPtr is thus similar to AutoPtr. Unlike the AutoPtr template, which can only be used with classes that support reference counting, SharedPtr can be used with any class. For this to work, a SharedPtr manages a reference count for the object it manages.

SharedPtr works in the following way: If an SharedPtr is assigned an ordinary pointer to an object (via the constructor or the assignment operator), it takes ownership of the object and the object's reference count is initialized to one. If the SharedPtr is assigned another SharedPtr, the object's reference count is incremented by one. The destructor of SharedPtr decrements the object's reference count by one and deletes the object if the reference count reaches zero. SharedPtr supports dereferencing with both the -> and the * operator. An attempt to dereference a null SharedPtr results in a NullPointerException being thrown. SharedPtr also implements all relational operators and a cast operator in case dynamic casting of the encapsulated data types is required.

Definition at line 96 of file SharedPtr.h.