phobos ~master (2023-10-10T16:11:09Z)

allocatorObject

std experimental allocator

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, the result will std.algorithm.mutation.move the supplied allocator A a within. The result itself is allocated in its own statically-typed allocator.
  1. RCIAllocator allocatorObject(A a)
    RCIAllocator
    allocatorObject
    (
    A
    )
    (
    auto ref A a
    )
    if (
    !isPointer!A
    )
  2. RCIAllocator allocatorObject(A* pa)

Examples

import std.experimental.allocator.mallocator : Mallocator;

RCIAllocator 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 std.experimental.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

Source

See Implementation

std experimental allocator modulesclassesfunctionsinterfacespropertiesstructs

Page generated by adrdox