Class AtomicRefCounted

Abstract class that implements IAtomicRefCounted. Should be used over IAtomicRefCounted when practicable to avoid code duplication in the final executable.

class AtomicRefCounted
  : IAtomicRefCounted ;

Properties

NameTypeDescription
refCountShared[get] ulongAtomically loads the number of active references.
refCount[get] ulongAtomically loads the number of active references.

Methods

NameDescription
dispose () Dispose the underlying resource
rcLockShared () Returns whether the refCount >= 1. This increases the refCount by 1. rcLock should be used to keep weak reference and ensures that the resource is not disposed. The operation is atomic.
releaseShared (disposeOnZero) Atomically decrement the reference count. If refCount reaches zero, and disposeOnZero is set, the object is locked with its own mutex, and dispose is called. In most cases, the calling code should set disposeOnZero, unless it is intended to release the object to give it away. (such as at the end of a builder function)
retainShared () Atomically increment the reference count.
rcLock () Returns whether the refCount >= 1. This increases the refCount by 1. rcLock should be used to keep weak reference and ensures that the resource is not disposed. The operation is atomic.
release (disposeOnZero) Atomically decrement the reference count. If refCount reaches zero, and disposeOnZero is set, the object is locked with its own mutex, and dispose is called. In most cases, the calling code should set disposeOnZero, unless it is intended to release the object to give it away. (such as at the end of a builder function)
retain () Atomically increment the reference count.