alloc-statistics

Small C++ library that overrides global new/delete and records process allocation statistics.

It tracks:

• new and delete call counts
• total allocated and deallocated bytes
• outstanding bytes (allocated_size() - deallocated_size())
• peak allocated bytes

Linking mb::alloc-statistics installs the global allocation hooks for that executable or shared object. Use it only when you intentionally want process-wide allocation accounting.

Usage

#include "mb/alloc-statistics/alloc-statistics.hpp"

#include <iostream>
#include <memory>

namespace as = mb::alloc_statistics;

int main() {
    auto& stats = as::Statistics::instance();
    stats.reset();

    auto value = std::make_unique<int>(42);

    std::cout << "new calls: " << stats.new_calls() << '\n';
    std::cout << "allocated bytes: " << stats.allocated_size() << '\n';
    std::cout << "peak bytes: " << stats.peak_size() << '\n';
}

With CMake:

target_link_libraries(your-target PRIVATE mb::alloc-statistics)

Build

This repository uses devenv as a submodule:

git submodule update --init --recursive

Or run ./devenv/scripts/git-sub.sh to update submodules and pull Git LFS files when the repo uses them.

Configure, build, and test with a preset:

cmake --preset gcc-debug
cmake --build build/gcc-debug
ctest --preset gcc-debug

Other presets include clang-debug, clang-release, appleclang-debug, appleclang-release, msvc-debug, and msvc-release.

CMake Options

Option	Default	Description
MB_ALLOC_STATISTICS_BUILD_TESTS	ON when top-level	Build tests.
MB_ALLOC_STATISTICS_BUILD_EXAMPLES	ON when top-level	Build example targets.

Notes

• The library is a static target named mb.alloc-statistics with alias mb::alloc-statistics.
• Public headers live under include/mb/alloc-statistics/.
• GCC, Clang, and AppleClang presets use C++26; MSVC presets use C++23.
• examples/usage.cpp contains a complete allocation report example.