RefCountedPtr< T > Class Template Reference

#include <RefCountedPtr.H>

Inheritance diagram for RefCountedPtr< T >:

[legend]

Collaboration diagram for RefCountedPtr< T >:

[legend]

List of all members.

---

Detailed Description

template<class T>
class RefCountedPtr< T >

A reference-counting handle class.

This is to be used as a pointer to class T. This will feel and smell just like a built-in pointer except:

1. There is no need to call delete on the pointer.
2. The default copy constructor and assignment implement ref-counting.
3. The user may call isNonUnique to determine if this pointer is the only pointer to the data. This can be used to hide the ref-counting behavior of a class.
4. Checks for dereference of a null pointer.

This class is completely inlined.

typical usage:

{
  Box b;
  IntVect a;
  //refCount() == 1
  RefCountedPtr<IntVectSet> set(new IntVectSet());

  // still just one IntVectSet, but refCount()==2
  RefCountedPtr<IntVectSet>  otherSet(set);

  // Like a pointer, modifying one modifies the other
  otherSet->define(b);
  (*set)|=a;
  {
    RefCountedPtr<IntVectSet> anotherSet; // null
    anotherSet = otherSet ;  //now all three have refCount()==3
  }//anotherSet out of scope, so deleted.  IntVectSet NOT deleted.

  // set.refCount() == 2
  // otherSet.refCount() == 2;
  // otherset == set;

}
// when all RefCountedPtr's for a given object are deleted, the last
// one calls 'delete' on the member pointer.

Public Member Functions
	RefCountedPtr (T *ptr=0)
	RefCountedPtr (const RefCountedPtr< T > &other)
	~RefCountedPtr ()
const RefCountedPtr< T > &	operator= (const RefCountedPtr< T > &rhs)
	assignement operator. copies pointer member
T *	operator-> ()
	dereference access operator. use like a pointer derefence access function.
const T *	operator-> () const
bool	isNull () const
T &	operator* ()
	pointer dereference.
const T &	operator* () const
	operator const T * () const
	auto conversion to regular const pointer where required.
bool	isNonUnique () const
	true when refcount is one.
int	refCount () const
void	swap (RefCountedPtr< T > &b)
template<class T2>
	operator RefCountedPtr< T2 > ()
	Template Conversion.
void	neverDelete ()
Protected Attributes
T *	ptr_
int *	refCount_
Friends
class	RefCountedPtr

---

Constructor & Destructor Documentation

template<class T>

RefCountedPtr< T >::RefCountedPtr

(

T *

ptr = 0

)

[inline, explicit]

References MayDay::Error(), RefCountedPtr< T >::ptr_, and RefCountedPtr< T >::refCount_.

template<class T>

RefCountedPtr< T >::RefCountedPtr

(

const RefCountedPtr< T > &

other

)

[inline]

References RefCountedPtr< T >::refCount_.

template<class T>

RefCountedPtr< T >::~RefCountedPtr

(

)

[inline]

References RefCountedPtr< T >::ptr_, and RefCountedPtr< T >::refCount_.

---

Member Function Documentation

template<class T>

const RefCountedPtr< T > & RefCountedPtr< T >::operator=

(

const RefCountedPtr< T > &

rhs

)

[inline]

assignement operator. copies pointer member

copies pointer member and integer pointer, decreases refcount of rhs member before assignment. this refcount increased my one.

References RefCountedPtr< T >::ptr_, and RefCountedPtr< T >::refCount_.

template<class T>

T * RefCountedPtr< T >::operator->

(

)

[inline]

dereference access operator. use like a pointer derefence access function.

References MayDay::Error(), and RefCountedPtr< T >::ptr_.

template<class T>

const T * RefCountedPtr< T >::operator->

(

)

const [inline]

References MayDay::Error(), and RefCountedPtr< T >::ptr_.

template<class T>

bool RefCountedPtr< T >::isNull

(

)

const [inline]

References RefCountedPtr< T >::ptr_.

template<class T>

T & RefCountedPtr< T >::operator*

(

)

[inline]

pointer dereference.

References MayDay::Error(), and RefCountedPtr< T >::ptr_.

template<class T>

const T & RefCountedPtr< T >::operator*

(

)

const [inline]

References MayDay::Error(), and RefCountedPtr< T >::ptr_.

template<class T>

RefCountedPtr< T >::operator const T *

(

)

const [inline]

auto conversion to regular const pointer where required.

References RefCountedPtr< T >::ptr_.

template<class T>

bool RefCountedPtr< T >::isNonUnique

(

)

const [inline]

true when refcount is one.

References RefCountedPtr< T >::refCount_.

template<class T>

int RefCountedPtr< T >::refCount

(

)

const [inline]

References RefCountedPtr< T >::refCount_.

Referenced by BoxLayout::refCount().

template<class T>

void RefCountedPtr< T >::swap

(

RefCountedPtr< T > &

b

)

[inline]

References RefCountedPtr< T >::ptr_, and RefCountedPtr< T >::refCount_.

template<class T>

template<class T2>

RefCountedPtr< T >::operator RefCountedPtr< T2 >

(

)

[inline]

Template Conversion.

provides a mechanism for the compiler to generate a conversion to a base class, like a real pointer would have

References RefCountedPtr< T >::ptr_, and RefCountedPtr< T >::refCount_.

template<class T>

void RefCountedPtr< T >::neverDelete

(

)

[inline]

References RefCountedPtr< T >::refCount_.

---

Friends And Related Function Documentation

template<class T>

friend class RefCountedPtr [friend]

---

Member Data Documentation

template<class T>

T* RefCountedPtr< T >::ptr_ [protected]

Referenced by RefCountedPtr< T >::isNull(), RefCountedPtr< T >::operator const T *(), RefCountedPtr< T >::operator RefCountedPtr< T2 >(), RefCountedPtr< T >::operator*(), RefCountedPtr< T >::operator->(), RefCountedPtr< T >::operator=(), RefCountedPtr< T >::RefCountedPtr(), RefCountedPtr< T >::swap(), and RefCountedPtr< T >::~RefCountedPtr().

template<class T>

int* RefCountedPtr< T >::refCount_ [protected]

Referenced by RefCountedPtr< T >::isNonUnique(), RefCountedPtr< T >::neverDelete(), RefCountedPtr< T >::operator RefCountedPtr< T2 >(), RefCountedPtr< T >::operator=(), RefCountedPtr< T >::refCount(), RefCountedPtr< T >::RefCountedPtr(), RefCountedPtr< T >::swap(), and RefCountedPtr< T >::~RefCountedPtr().

---

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

• RefCountedPtr.H