SaneCppMemory.h is library tracking and limiting runtime / dynamic allocations through the use of custom allocators.

All libraries are designed to let you use your favorite externally provided string / vector classes BUT if you've been sold on using also the Containers library then here you will find scoped allocator / arena infrastructure used by them.

Note: See Tests/InteropSTL/*.cpp for an example of externally provided Container classes.

The "owned" String class is here and not in Strings library because it needs allocator support.

Note: If a library doesn't directly or indirectly depend on the Memory library, you can assume that it will not do any runtime / dynamic allocation.

Dependencies

• Dependencies: (none)
• All dependencies: (none)

Features

Classes

Status

Usable The library is solid. The Buffer implementation has been evolved and fine tuned to be minimal but effective.

Description

Memory library helps tracking and limit runtime / dynamic allocations through the use of custom allocators. A classic dynamically expandable binary buffer SC::Buffer is provided and it's largely shared to form the more object model oriented SC::Vector class from Containers Library.

All allocations throughout all downstream dependant libraries are centrally tracked by the SC::Globals class, that also allows re-defining custom thread-local allocators.

Such allocators can be just fixed buffers, regular heap memory or reserved SC::VirtualMemory using only limited amounts of Physical memory.

Buffer

String

SmallString

Memory

VirtualMemory

Globals

Blog

These blogs have been written before the split from Foundation into the Memory library:

• February 2025 Update
• March 2025 Update
• April 2025 Update

These blog posts have been written after the split from foundation:

• June 2025 Update

Roadmap

Complete Features:

• Things will be added as needed

💡 Unplanned Features:

• SharedPtr
• UniquePtr

Note: In Principles there is a rule that discourages allocations of large number of tiny objects and also creating systems with unclear or shared memory ownership. For this reason this library is missing Smart Pointers.

Statistics