allocatorObject

Returns a dynamically-typed CAllocator built around a given statically- typed allocator a of type A. Passing a pointer to the allocator creates a dynamic allocator around the allocator pointed to by the pointer, without attempting to copy or move it. Passing the allocator by value or reference behaves as follows.

  • If A has no state, the resulting object is allocated in static shared storage.
  • If A has state and is copyable, the result will store a copy of it within. The result itself is allocated in its own statically-typed allocator.
  • If A has state and is not copyable, the result will move the passed-in argument into the result. The result itself is allocated in its own statically-typed allocator.
  1. CAllocatorImpl!A allocatorObject(A a)
    version(HasDRuntime)
    allocatorObject
    (
    A
    )
    (
    auto ref A a
    )
    if (
    !isPointer!A
    )
  2. CAllocatorImpl!(A, Yes.indirect) allocatorObject(A* pa)

Examples

import stdx.allocator.mallocator : Mallocator;
IAllocator a = allocatorObject(Mallocator.instance);
auto b = a.allocate(100);
assert(b.length == 100);
assert(a.deallocate(b));

// The in-situ region must be used by pointer
import stdx.allocator.building_blocks.region : InSituRegion;
auto r = InSituRegion!1024();
a = allocatorObject(&r);
b = a.allocate(200);
assert(b.length == 200);
// In-situ regions can deallocate the last allocation
assert(a.deallocate(b));

Meta