std.experimental.allocator.mallocator - D Programming Language

Menu

- Learn
- Documentation
  - Language Reference
  - Library Reference
  - Command-line Reference
  - Feature Overview
  - Articles
- Packages
- Community
  - Blog
  - Orgs using D
  - Twitter
  - Forums
  - IRC
  - Wiki
  - GitHub
  - Issues
- Resources
  - Books
  - Tutorials
  - Tools
  - Editors
  - IDEs
  - Visual D
  - Acknowledgments
  - D Style
  - Glossary
  - Sitemap

Search
Report a bug
If you spot a problem with this page, click here to create a Bugzilla issue.
Improve this page
Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using a local clone.

# std.experimental.allocator.mallocator

struct Mallocator;
  The C heap allocator.
  Examples:

      auto buffer = Mallocator.instance.allocate(1024 * 1024 * 4);
      scope(exit) Mallocator.instance.deallocate(buffer);
      //...

  enum uint alignment;
    The alignment is a static constant equal to platformAlignment, which ensures proper alignment for any D data type.
  shared nothrow @nogc @trusted void[] allocate(size_t bytes);
  shared nothrow @nogc @system bool deallocate(void[] b);
  shared nothrow @nogc @system bool reallocate(ref void[] b, size_t s);
    Standard allocator methods per the semantics defined above. The deallocate and reallocate methods are @system because they may move memory around, leaving dangling pointers in user code. Somewhat paradoxically, malloc is @safe but that's only useful to safe programs that can afford to leak memory allocated.
  static shared Mallocator instance;
    Returns the global instance of this allocator type. The C heap allocator is thread-safe, therefore all of its methods and it itself are shared.
struct AlignedMallocator;
  Aligned allocator using OS-specific primitives, under a uniform API.
  Examples:

      auto buffer = AlignedMallocator.instance.alignedAllocate(1024 * 1024 * 4,
          128);
      scope(exit) AlignedMallocator.instance.deallocate(buffer);
      //...

  enum uint alignment;
    The default alignment is platformAlignment.
  shared nothrow @nogc @trusted void[] allocate(size_t bytes);
    Forwards to alignedAllocate(bytes, platformAlignment).
  shared nothrow @nogc @trusted void[] alignedAllocate(size_t bytes, uint a);
    Uses posix_memalign on Posix and _aligned_malloc on Windows.
  shared nothrow @nogc @system bool deallocate(void[] b);
    Calls free(b.ptr) on Posix and _aligned_free(b.ptr) on Windows.
  shared nothrow @nogc @system bool reallocate(ref void[] b, size_t newSize);
    On Posix, forwards to realloc. On Windows, forwards to alignedReallocate(b, newSize, platformAlignment).
  static shared AlignedMallocator instance;
    Returns the global instance of this allocator type. The C heap allocator is thread-safe, therefore all of its methods and instance itself are shared.

Copyright © 1999-2016 by the D Language Foundation | Page generated by Ddoc on Tue Dec 27 03:39:47 2016