Struct MemoryTracker 

pub struct MemoryTracker { /* private fields */ }

Core memory tracking functionality.

The MemoryTracker maintains records of all memory allocations and deallocations, provides statistics, and supports exporting data in various formats.

Performance Characteristics

• DashMap: Lock-free concurrent access for allocations
• Atomic counters: Lock-free statistics updates
• Thread-local: Zero-contention for per-thread tracking

Implementations

impl MemoryTracker

pub fn new() -> Self

Create a new memory tracker.

pub fn track_allocation(&self, ptr: usize, size: usize) -> TrackingResult<()>

Track a memory allocation.

Arguments

• ptr - Memory pointer address
• size - Allocation size in bytes

pub fn track_deallocation(&self, ptr: usize) -> TrackingResult<bool>

Track a memory deallocation.

Arguments

• ptr - Memory pointer address

Returns

• Ok(true) if the allocation was found and removed
• Ok(false) if the pointer was not tracked (possible double-free or untracked allocation)

pub fn get_allocation_size(&self, ptr: usize) -> Option<usize>

Get the size of an active allocation.

Arguments

• ptr - Memory pointer address

Returns

• Some(size) if the allocation exists
• None if the pointer is not tracked

pub fn associate_var( &self, ptr: usize, var_name: String, type_name: String, source_file: Option<&str>, source_line: Option<u32>, ) -> TrackingResult<()>

Associate a variable name and type with an allocation.

Arguments

• ptr - Memory pointer address
• var_name - Variable name
• type_name - Type name
• source_file - Source file (optional)
• source_line - Source line (optional)

pub fn fast_track_allocation( &self, ptr: usize, size: usize, var_name: String, ) -> TrackingResult<()>

Fast track allocation with variable name.

Arguments

• ptr - Memory pointer address
• size - Allocation size in bytes
• var_name - Variable name

pub fn get_stats(&self) -> TrackingResult<MemoryStats>

Get current memory statistics.

pub fn detect_leaks(&self) -> (usize, u64)

Detect memory leaks at program shutdown.

This should be called when the program is shutting down to detect allocations that were never freed. Returns the count and total size of allocations that are still active.

pub fn get_active_allocations(&self) -> TrackingResult<Vec<AllocationInfo>>

Get all currently active allocations.

pub fn get_memory_by_type(&self) -> TrackingResult<HashMap<String, usize>>

Get memory grouped by type.

pub fn set_fast_mode(&self, enabled: bool)

Enable or disable fast mode.

pub fn is_fast_mode(&self) -> bool

Check if fast mode is enabled.

pub fn enable_fast_mode(&self)

Enable fast mode for testing.

pub fn ensure_memory_analysis_path<P: AsRef<Path>>(&self, path: P) -> PathBuf

Ensure memory analysis path exists and return the full path.

pub fn ensure_memscope_path<P: AsRef<Path>>(&self, path: P) -> PathBuf

Ensure path uses .memscope extension and is in MemoryAnalysis directory.

pub fn export_to_memscope<P: AsRef<Path>>(&self, path: P) -> TrackingResult<()>

Export memory tracking data to .memscope file format (JSON content).

This method exports memory tracking data with a .memscope file extension. The content is serialized as JSON for human readability and interoperability.

pub fn export_to_json<P: AsRef<Path>>(&self, path: P) -> TrackingResult<()>

Export memory tracking data to JSON format.

Trait Implementations

impl Default for MemoryTracker

fn default() -> Self

Returns the “default value” for a type.

impl Drop for MemoryTracker

fn drop(&mut self)

Executes the destructor for this type.