std.experimental.allocator.showcase - D Programming Language

Menu

- Learn
- Documentation
  - Language Reference
  - Library Reference
  - Command-line Reference
  - Feature Overview
  - Articles
- Downloads
- Packages
- Community
  - Blog
  - Orgs using D
  - Twitter
  - Calendar
  - Forums
  - IRC
  - Community Discord
  - Wiki
  - GitHub
  - Issues
  - Get involved
  - Contributors
  - Foundation
  - Security Team
  - Donate
  - Sponsors
- Resources
  - Tour
  - Books
  - Tutorials
  - Tools
  - Editors
  - IDEs
  - run.dlang.io
  - 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.showcase

Collection of typical and useful prebuilt allocators using the given components. User code would typically import this module and use its facilities, or import individual heap building blocks and assemble them.

Source std/experimental/allocator/showcase.d

template `StackFront`(size_t stackSize, Allocator = GCAllocator)
  Allocator that uses stack allocation for up to stackSize bytes and then falls back to Allocator. Defined as:

      alias StackFront(size_t stackSize, Allocator) =
          FallbackAllocator!(
              InSituRegion!(stackSize, Allocator.alignment,
                  hasMember!(Allocator, "deallocate")
                      ? Yes.defineDeallocate
                      : No.defineDeallocate),
              Allocator);

  Choosing stackSize is as always a compromise. Too small a size exhausts the stack storage after a few allocations, after which there are no gains over the backup allocator. Too large a size increases the stack consumed by the thread and may end up worse off because it explores cold portions of the stack.
  Examples:

      StackFront!4096 a;
      auto b = a.allocate(4000);
      writeln(b.length); // 4000
      auto c = a.allocate(4000);
      writeln(c.length); // 4000
      a.deallocate(b);
      a.deallocate(c);

auto `mmapRegionList`(size_t `bytesPerRegion`);
  Creates a scalable AllocatorList of Regions, each having at least `bytesPerRegion` bytes. Allocation is very fast. This allocator does not offer deallocate but does free all regions in its destructor. It is recommended for short-lived batch applications that count on never running out of memory.
  Examples:

      auto alloc = mmapRegionList(1024 * 1024);
      const b = alloc.allocate(100);
      writeln(b.length); // 100

Copyright © 1999-2020 by the D Language Foundation | Page generated by Ddoc on Sat Dec 19 12:48:31 2020