Smart Pointer for UObject instances. More...

#include <uobject.hpp>

Inheritance diagram for ubit::UPtr:

Protected Member Functions
void	deferenceError () const

Detailed Description

Smart Pointer for UObject instances.

All classes that derive from UObject support UPtr SMART POINTERS (SP), which provide automatic memory management (based on reference counting). UObject(s) are automatically deleted when nothing reference them, i.e. when the last reference from a UPtr or from anoher UObject is removed.

UPtr is the base class for upr<> templates as shown in the examples below:

   uptr<UBox> box = new UBox();             // 'box' is a Ubit Smart Pointer
   uptr<UButton> btn = ubutton("Do It!");   // ubutton() == *new UButton()
   box->add(*btn);                    // the UButton is a child of the UBox

   box = null;  // destroys this UBox because it has no parent and no other
                // uptr<> pointing to it (its UButton child is not destroyed 
                // because 'btn' points to it)

   btn = null;  // destroys this UBox because it has no parent and no other
                // uptr<> pointing to it.

NOTES:

an arbitrary number of SPs can reference a given UObject
a UObject pointer by a UPtr cannot be destroyed by calling 'delete' (this would produce an error)
SP should point to objects allocated in the heap (i.e. by using 'new' or a shortcut creator function such as ubox() or ubutton() that calls 'new'). SP have no effect on objects allocated in the stack or in global memory.

See also: : class UObject and the uptr<> template.

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

src/ubit/uobject.hpp
src/ubit/uobject.cpp

Protected Member Functions

Detailed Description