Panda3D
Public Member Functions | Static Public Member Functions | List of all members
NodeReferenceCount Class Reference

This class specializes ReferenceCount to add an additional counter, called node_ref_count, for the purposes of counting the number of times the object is referenced by a "node", whatever that may mean in context. More...

Inheritance diagram for NodeReferenceCount:
ReferenceCount MemoryBase

Public Member Functions

int getNodeRefCount ()
 Returns the current reference count. More...
 
 nodeRef ()
 Explicitly increments the node reference count and the normal reference count simultaneously. More...
 
bool nodeUnref ()
 Explicitly decrements the node reference count and the normal reference count simultaneously. More...
 
bool testRefCountIntegrity ()
 Does some easy checks to make sure that the reference count isn't completely bogus. More...
 
- Public Member Functions inherited from ReferenceCount
int getRefCount ()
 Returns the current reference count. More...
 
 ref ()
 Explicitly increments the reference count. User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically. More...
 
bool testRefCountIntegrity ()
 Does some easy checks to make sure that the reference count isn't completely bogus. Returns true if ok, false otherwise. More...
 
bool testRefCountNonzero ()
 Does some easy checks to make sure that the reference count isn't zero, or completely bogus. Returns true if ok, false otherwise. More...
 
bool unref ()
 Explicitly decrements the reference count. Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic.) However, see the helper function unref_delete(). More...
 

Static Public Member Functions

static TypeHandle getClassType ()
 
- Static Public Member Functions inherited from ReferenceCount
static TypeHandle getClassType ()
 

Detailed Description

This class specializes ReferenceCount to add an additional counter, called node_ref_count, for the purposes of counting the number of times the object is referenced by a "node", whatever that may mean in context.

The new methods node_ref() and node_unref() automatically increment and decrement the primary reference count as well. There also exists a NodePointerTo<> class to maintain the node_ref counters automatically.

See also CachedTypedWritableReferenceCount, which is similar in principle, as well as NodeCachedReferenceCount, which combines both of these.

Member Function Documentation

◆ getClassType()

static TypeHandle getClassType ( )
static

◆ getNodeRefCount()

int getNodeRefCount ( )

Returns the current reference count.

◆ nodeRef()

nodeRef ( )

Explicitly increments the node reference count and the normal reference count simultaneously.

◆ nodeUnref()

bool nodeUnref ( )

Explicitly decrements the node reference count and the normal reference count simultaneously.

The return value is true if the new reference count is nonzero, false if it is zero.

◆ testRefCountIntegrity()

bool testRefCountIntegrity ( )

Does some easy checks to make sure that the reference count isn't completely bogus.