stdx.allocator.building_blocks.scoped_allocator

  • ScopedAllocator

    Declaration

    struct ScopedAllocator(ParentAllocator);

    delegates all allocation requests to . When destroyed, the object automatically calls for all memory allocated through its lifetime. (The function is also implemented with the same semantics.)

    Discussion

    is also supported, which is where most implementation effort and overhead of go. If is not needed, a simpler design combining with is recommended.

    Examples

    1. import stdx.allocator.mallocator : Mallocator; import stdx.allocator.internal : Ternary; ScopedAllocator!Mallocator alloc; assert(alloc.empty == Ternary.yes); const b = alloc.allocate(10); assert(b.length == 10); assert(alloc.empty == Ternary.no);

    • parent

      Declaration

      Allocator parent;

      If is stateful, is a property giving access to an . Otherwise, is an alias for AffixAllocator!ParentAllocator.instance.

    • alignment

      Declaration

      enum auto alignment;

      Alignment offered

    • goodAllocSize

      Declaration

      size_t goodAllocSize(size_t n);

      Forwards to (which accounts for the management overhead).

    • allocate

      Declaration

      void[] allocate(size_t n);

      Allocates memory. For management it actually allocates extra memory from the parent.

    • expand

      Declaration

      bool expand(ref void[] b, size_t delta);

      Forwards to .

    • reallocate

      Declaration

      bool reallocate(ref void[] b, size_t s);

      Reallocates to new size .

    • owns

      Declaration

      Ternary owns(void[] b);

      Forwards to .

    • deallocate

      Declaration

      bool deallocate(void[] b);

      Deallocates .

    • deallocateAll

      Declaration

      bool deallocateAll();

      Deallocates all memory allocated.

    • empty

      Declaration

      const Ternary empty();

      Returns Ternary.yes if this allocator is not responsible for any memory, Ternary.no otherwise. (Never returns Ternary.unknown.)