Smart pointer to protect a GCNode from garbage collection. More...
#include <GCStackRoot.hpp>
Public Types | |
| typedef T | type |
Public Member Functions | |
| GCStackRoot (T *node=0) | |
| GCStackRoot (const GCStackRoot &source) | |
| Copy constructor. | |
| GCStackRoot & | operator= (const GCStackRoot &source) |
| GCStackRoot & | operator= (T *node) |
| T * | operator-> () const |
| Access member via encapsulated pointer. | |
| T & | operator* () const |
| Dereference the encapsulated pointer. | |
| operator T * () const | |
| Implicit conversion to encapsulated pointer type. | |
| T * | get () const |
| Access the encapsulated pointer. | |
Additional Inherited Members | |
 Static Public Member Functions inherited from CXXR::GCStackRootBase | |
| static void | visitRoots (GCNode::const_visitor *v) |
| Conduct a const visitor to protected objects. | |
| Protected Member Functions inherited from CXXR::GCStackRootBase | |
| GCStackRootBase (const GCNode *node) | |
| Primary constructor. | |
| GCStackRootBase (const GCStackRootBase &source) | |
| Copy constructor. | |
| GCStackRootBase & | operator= (const GCStackRootBase &source) |
| void | retarget (const GCNode *node) |
| Change the node protected by this GCStackRootBase. | |
| const GCNode * | ptr () const |
| Access the encapsulated pointer. | |
Detailed Description
template<class T = RObject>
class CXXR::GCStackRoot< T >
Smart pointer to protect a GCNode from garbage collection.
This class encapsulates a pointer to an object of a type derived from GCNode. For as long as the GCStackRoot object exists, the GCNode that it points to will not be garbage collected.
GCStackRoot objects are intended to be allocated on the processor stack: specifically, the class implementation requires that GCStackRoot objects are destroyed in the reverse order of creation, and the destructor checks this.
- Template Parameters:
-
T GCNode or a type publicly derived from GCNode. This may be qualified by const, so for example a const String* may be encapsulated in a GCStackRoot using the type GCStackRoot<const String>.
- Caller protects:
- Suppose some code calls a function (or class method) that takes a pointer or reference to a class derived from GCNode as an argument, and/or returns a pointer to a class derived from GCNode as its return value. In CXXR, the preferred coding approach is that the calling code should take responsibility for protecting the arguments from the garbage collector before calling the function, and likewise take responsibility for protecting the returned value. This is because the calling code is in a better position to decide whether any additional steps are necessary to achieve this, and what they should be. (The calling code may also need to protect other objects: objects that are neither arguments to or values returned from the called function, but which would otherwise be vulnerable if the called function gave rise to a garbage collection.)
Constructor & Destructor Documentation
|
inlineexplicit |
- Parameters:
-
node Pointer the node to be pointed to, and protected from the garbage collector, or a null pointer.
|
inline |
Copy constructor.
The constructed GCStackRoot will protect the same GCNode as source. (There is probably no reason to use this constructor.)
Member Function Documentation
|
inline |
Access the encapsulated pointer.
- Returns:
- the pointer currently encapsulated by the node.
|
inline |
Implicit conversion to encapsulated pointer type.
- Returns:
- the pointer currently encapsulated by the node. The pointer is of type T* const to prevent its use as an lvalue, the effect of which would probably not be what the programmer wanted.
|
inline |
Dereference the encapsulated pointer.
- Returns:
- a reference to the object pointed to by the encapsulated pointer. The effect is undefined if this object encapsulates a null pointer.
|
inline |
Access member via encapsulated pointer.
- Returns:
- the pointer currently encapsulated by the node.
|
inline |
This will cause this GCStackRoot to protect the same GCNode as is protected by source. (There is probably no reason to use this method.)
|
inline |
This will cause this GCStackRoot to point to and protect node, instead of the node (if any) it currently points to and protects.
- Parameters:
-
node Pointer to the GCNode that is now to be pointed to and protected from the garbage collector.
The documentation for this class was generated from the following file:
