RefCountedNoGC

Defines a reference-counted object containing a T value as payload. RefCountedNoGC keeps track of all references of an object, and when the reference count goes down to zero, frees the underlying store. RefCountedNoGC uses malloc and free for operation.

RefCountedNoGC is unsafe and should be used with care. No references to the payload should be escaped outside the RefCountedNoGC object.

The autoInit option makes the object ensure the store is automatically initialized. Leaving autoInit == RefCountedAutoInitialize.yes (the default option) is convenient but has the cost of a test whenever the payload is accessed. If autoInit == RefCountedAutoInitialize.no, user code must call either refCountedStore.isInitialized or refCountedStore.ensureInitialized before attempting to access the payload. Not doing so results in null pointer dereference.

Constructors

this
this(auto ref A args)

Constructor that initializes the payload.

Destructor

~this
~this()

Destructor that tracks the reference count appropriately. If !refCountedStore.isInitialized, does nothing. When the reference count goes down to zero, calls destroy agaist the payload and calls free to deallocate the corresponding resource.

Postblit

this(this)
this(this)

Constructor that tracks the reference count appropriately. If !refCountedStore.isInitialized, does nothing.

Alias This

refCountedPayload

Returns a reference to the payload. If (autoInit == RefCountedAutoInitialize.yes), calls refCountedStore.ensureInitialized. Otherwise, just issues assert(refCountedStore.isInitialized).

Members

Functions

opAssign
void opAssign(T rhs)

Assignment operators

opAssign
void opAssign(typeof(this) rhs)

Assignment operators

Properties

refCountedPayload
T refCountedPayload [@property getter]
inout(T) refCountedPayload [@property getter]

Returns a reference to the payload. If (autoInit == RefCountedAutoInitialize.yes), calls refCountedStore.ensureInitialized. Otherwise, just issues assert(refCountedStore.isInitialized). Used with alias refCountedPayload this;, so callers can just use the RefCountedNoGC object as a T.

refCountedStore
inout(RefCountedStore) refCountedStore [@property getter]

Returns storage implementation struct.

Structs

RefCountedStore
struct RefCountedStore

RefCountedNoGC storage implementation.

Examples

1 // A pair of an $(D int) and a $(D size_t) - the latter being the
2 // reference count - will be dynamically allocated
3 auto rc1 = RefCountedNoGC!int(5);
4 assert(rc1 == 5);
5 // No more allocation, add just one extra reference count
6 auto rc2 = rc1;
7 // Reference semantics
8 rc2 = 42;
9 assert(rc1 == 42);
10 // the pair will be freed when rc1 and rc2 go out of scope

Meta