IAtomicRefCounted

A atomic reference counted resource. Objects implementing this interface can be safely manipulated as shared. Implementing class should mixin atomicRcCode to use the provided implementation.

Members

Functions

dispose
void dispose()

Dispose the underlying resource

rcLock
bool rcLock()
rcLockShared
bool 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.

release
bool release(Flag!"disposeOnZero" disposeOnZero)
releaseShared
bool releaseShared(Flag!"disposeOnZero" 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
void retain()
retainShared
void retainShared()

Atomically increment the reference count.

Properties

refCount
size_t refCount [@property getter]
refCountShared
size_t refCountShared [@property getter]

Atomically loads the number of active references.

Meta