Object.usageCount Method

Returns the current number of references (the value of the reference counter) that the object has.

public int usageCount()

Run On

Called

Return Value

The current number of references that the object has.

Remarks

When an object is created, its reference counter equals one (1). When a new reference is created, its value increases. As a reference goes out of scope, its value decreases.

Example

The following example prints the number of references for objA to the output window.

static void Object_UsageCount(Args _args)
{
    Object objA = new Object();
    Object objB;
    ;

    print objA.usageCount();    // Prints 1.

    objB = objA;                // objB is a reference to objA.
    print objA.usageCount();    // prints 2
    pause;
}

See Also

Object Class