Struct ScopedAllocCounter 

pub struct ScopedAllocCounter {}

Scoped helper that captures the calling thread’s allocation counters on construction and exposes the delta accumulated by the time you query it.

Per-thread accounting matters under parallel-rt: multiple worker threads run monitored steps concurrently, and a delta computed from the process-wide counters would attribute every other thread’s allocations to the local step. The counters this type snapshots are thread-local, so allocated() only reflects allocations performed on the same thread that constructed the counter.

When the runtime is built without feature = "memory_monitoring", this becomes a zero-sized no-op: allocated()/deallocated() return 0, the constructor performs no TLS load, and the type is fully eliminated by the optimizer. This lets the runtime macro emit the same code in both builds.

ScopedAllocCounter is intentionally pinned to the constructing thread — the macro always uses it as a stack-local within a single step, so this matches the only realistic usage pattern.

Example

use cu29_runtime::monitoring::ScopedAllocCounter;

let counter = ScopedAllocCounter::new();
let _vec = vec![0u8; 1024];
// With `memory_monitoring`: `counter.allocated() >= 1024`.
// Without: `counter.allocated() == 0`.
let _ = counter.allocated();

Implementations

impl ScopedAllocCounter

pub fn new() -> Self

pub fn allocated(&self) -> usize

Bytes allocated by the constructing thread since this counter was created. Always 0 when memory_monitoring is not enabled.

pub fn deallocated(&self) -> usize

Bytes deallocated by the constructing thread since this counter was created. Always 0 when memory_monitoring is not enabled.

Trait Implementations

impl Default for ScopedAllocCounter

fn default() -> Self

Returns the “default value” for a type.