---

vpr::RefCountMemory Class Reference

reference countable memory. More...

#include <RefCountMemory.h>

List of all members.

Public Types
enum	States { BAD = -69 }
Public Methods
	RefCountMemory ()
	Default constructor. More...
	RefCountMemory (const RefCountMemory &r)
	On creation, refcount == 0, so if you intend to own the memory created, you should ref it. More...
RefCountMemory &	operator= (const RefCountMemory &r)
const int &	ref ()
	Increases the reference count. More...
bool	unrefDelete ()
	Decreases the reference count by 1, then call checkDelete. More...
const int &	unref ()
	Decreases the reference count. More...
const int &	getRef () const
	Gets the reference count. More...
const int &	unrefGetRef ()
	Decreases the reference count by 1, return the new refcount. More...
virtual bool	checkDelete ()
	If refcount <= 0, then delete the memory. More...
Protected Methods
virtual	~RefCountMemory ()
	Destructor. More...

---

Detailed Description

reference countable memory.

(no, not radio controlled, sorry)

To use reference counting on your objects, inherit from this class.

NOTES:

• you MUST call unrefDelete or checkDelete to delete, do not call operator::delete() yourself!!!!!
• on creation, refcount == 0, so if you intend to own the memory created, you should call ref() on the object

EXAMPLE USAGE: Object obj; obj.ref(); // count == 1; obj.ref(); // count == 2; int count = obj.getRef(); obj.unrefDelete(); // count == 1, memory is not deleted obj.unrefDelete(); // count == 0, memory is deleted

class Object : public vpr::RefCountMemory

Definition at line 70 of file RefCountMemory.h.

---

Member Enumeration Documentation

enum vpr::RefCountMemory::States

Enumeration values: BAD  Definition at line 73 of file RefCountMemory.h. { BAD = -69, };

---

Constructor & Destructor Documentation

vpr::RefCountMemory::RefCountMemory (    )  [inline]

Default constructor. On creation, refcount == 0, so if you intend to own the memory created, you should ref it Definition at line 149 of file RefCountMemory.h. Referenced by operator=, and RefCountMemory. : ___mNumTimesReferenced( 0 ) { }

vpr::RefCountMemory::RefCountMemory (  const RefCountMemory &    r )  [inline]

On creation, refcount == 0, so if you intend to own the memory created, you should ref it. Definition at line 88 of file RefCountMemory.h. References RefCountMemory. : ___mNumTimesReferenced( 0 ) { //dont copy ref number. }

virtual vpr::RefCountMemory::~RefCountMemory (    )  [inline, protected, virtual]

Destructor. You MUST call checkDelete to delete, do not call delete!!!!! Definition at line 98 of file RefCountMemory.h. References BAD. { assert( ___mNumTimesReferenced != BAD && ___mNumTimesReferenced >= 0 && "this data has been dereferenced more times than referenced, someone is probably holding on to the data after they called deref(), or someone called deref too many times. also, make sure you use checkDelete, or unrefDelete." ); ___mNumTimesReferenced = BAD; }

---

Member Function Documentation

RefCountMemory& vpr::RefCountMemory::operator= (  const RefCountMemory &    r )  [inline]

Definition at line 105 of file RefCountMemory.h. References RefCountMemory. { //dont copy ref number. return *this; }

const int & vpr::RefCountMemory::ref (    )  [inline]

Increases the reference count. Definition at line 161 of file RefCountMemory.h. References BAD, and getRef. { assert( ___mNumTimesReferenced != BAD && "this data has been deleted, someone is probably holding on to the data after they called deref()" ); ++___mNumTimesReferenced; return this->getRef(); }

bool vpr::RefCountMemory::unrefDelete (    )  [inline]

Decreases the reference count by 1, then call checkDelete. This is equivalent to calling RefCountMemory::unref followed by RefCountMemory::checkDelete Returns: true if deleted; false if not. Definition at line 204 of file RefCountMemory.h. References checkDelete, and unref. { this->unref(); return this->checkDelete(); }

const int & vpr::RefCountMemory::unref (    )  [inline]

Decreases the reference count. Definition at line 169 of file RefCountMemory.h. References BAD, and getRef. Referenced by unrefDelete, and unrefGetRef. { assert( ___mNumTimesReferenced != BAD && ___mNumTimesReferenced >= 0 && "this data has been dereferenced more times than referenced, someone is probably holding on to the data after they called deref(), or someone called deref too many times. also, make sure you use checkDelete, or unrefDelete." ); --___mNumTimesReferenced; return this->getRef(); }

const int & vpr::RefCountMemory::getRef (    )  const [inline]

Gets the reference count. Definition at line 154 of file RefCountMemory.h. References BAD. Referenced by ref, unref, and unrefGetRef. { assert( ___mNumTimesReferenced != BAD && "this data has been deleted, someone is probably holding on to the data after they called deref()" ); return ___mNumTimesReferenced; }

const int & vpr::RefCountMemory::unrefGetRef (    )  [inline]

Decreases the reference count by 1, return the new refcount. Definition at line 211 of file RefCountMemory.h. References getRef, and unref. { this->unref(); return this->getRef(); }

bool vpr::RefCountMemory::checkDelete (    )  [inline, virtual]

If refcount <= 0, then delete the memory. If the object has any refcountable children, then they will have RefCountMemory::unrefDelete() called on them. Returns: true if deleted, false if not Definition at line 183 of file RefCountMemory.h. References BAD. Referenced by unrefDelete. { assert( ___mNumTimesReferenced != BAD && ___mNumTimesReferenced >= 0 && "this data has been dereferenced more times than referenced, someone is probably holding on to the data after they called deref(), or someone called deref too many times. also, make sure you use checkDelete, or unrefDelete." ); if (___mNumTimesReferenced <= 0) { delete this; return true; } else { return false; } }

---

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

• RefCountMemory.h

---