Struct MemoryUsage

pub struct MemoryUsage {
    pub current_bytes: usize,
    pub peak_bytes: usize,
    pub active_allocations: usize,
    pub total_allocations: usize,
}

Memory usage tracking and reporting

Fields

current_bytes: usize

Current memory usage in bytes

peak_bytes: usize

Peak memory usage in bytes

active_allocations: usize

Number of active allocations

total_allocations: usize

Total allocations made

Implementations

impl MemoryUsage

pub fn new() -> Self

Create a new memory usage tracker

Examples found in repository

examples/memory_efficient_example.rs (line 277)

fn demo_memory_usage_tracking() -> Result<()> {
    println!("\n📈 Memory Usage Tracking Demo");
    println!("-----------------------------");

    let mut usage = MemoryUsage::new();

    println!("Initial state:");
    print_memory_usage(&usage);

    // Simulate various allocation patterns
    println!("\nSimulating allocation patterns...");

    // Large allocation
    usage.allocate(50 * 1024 * 1024); // 50MB
    println!("After 50MB allocation:");
    print_memory_usage(&usage);

    // Multiple small allocations
    for i in 1..=10 {
        usage.allocate(1024 * 1024); // 1MB each
        if i % 3 == 0 {
            println!("After {} small allocations:", i);
            print_memory_usage(&usage);
        }
    }

    // Peak usage reached
    println!("Peak memory usage reached:");
    print_memory_usage(&usage);

    // Simulate deallocations
    println!("\nSimulating deallocations...");
    for i in 1..=8 {
        usage.deallocate(5 * 1024 * 1024); // 5MB each
        if i % 2 == 0 {
            println!("After {} deallocations:", i);
            print_memory_usage(&usage);
        }
    }

    println!("\nFinal state (note peak is preserved):");
    print_memory_usage(&usage);

    Ok(())
}

pub fn allocate(&mut self, bytes: usize)

Update memory usage statistics

Examples found in repository

examples/memory_efficient_example.rs (line 286)

fn demo_memory_usage_tracking() -> Result<()> {
    println!("\n📈 Memory Usage Tracking Demo");
    println!("-----------------------------");

    let mut usage = MemoryUsage::new();

    println!("Initial state:");
    print_memory_usage(&usage);

    // Simulate various allocation patterns
    println!("\nSimulating allocation patterns...");

    // Large allocation
    usage.allocate(50 * 1024 * 1024); // 50MB
    println!("After 50MB allocation:");
    print_memory_usage(&usage);

    // Multiple small allocations
    for i in 1..=10 {
        usage.allocate(1024 * 1024); // 1MB each
        if i % 3 == 0 {
            println!("After {} small allocations:", i);
            print_memory_usage(&usage);
        }
    }

    // Peak usage reached
    println!("Peak memory usage reached:");
    print_memory_usage(&usage);

    // Simulate deallocations
    println!("\nSimulating deallocations...");
    for i in 1..=8 {
        usage.deallocate(5 * 1024 * 1024); // 5MB each
        if i % 2 == 0 {
            println!("After {} deallocations:", i);
            print_memory_usage(&usage);
        }
    }

    println!("\nFinal state (note peak is preserved):");
    print_memory_usage(&usage);

    Ok(())
}

pub fn deallocate(&mut self, bytes: usize)

Record memory deallocation

Examples found in repository

examples/memory_efficient_example.rs (line 306)

fn demo_memory_usage_tracking() -> Result<()> {
    println!("\n📈 Memory Usage Tracking Demo");
    println!("-----------------------------");

    let mut usage = MemoryUsage::new();

    println!("Initial state:");
    print_memory_usage(&usage);

    // Simulate various allocation patterns
    println!("\nSimulating allocation patterns...");

    // Large allocation
    usage.allocate(50 * 1024 * 1024); // 50MB
    println!("After 50MB allocation:");
    print_memory_usage(&usage);

    // Multiple small allocations
    for i in 1..=10 {
        usage.allocate(1024 * 1024); // 1MB each
        if i % 3 == 0 {
            println!("After {} small allocations:", i);
            print_memory_usage(&usage);
        }
    }

    // Peak usage reached
    println!("Peak memory usage reached:");
    print_memory_usage(&usage);

    // Simulate deallocations
    println!("\nSimulating deallocations...");
    for i in 1..=8 {
        usage.deallocate(5 * 1024 * 1024); // 5MB each
        if i % 2 == 0 {
            println!("After {} deallocations:", i);
            print_memory_usage(&usage);
        }
    }

    println!("\nFinal state (note peak is preserved):");
    print_memory_usage(&usage);

    Ok(())
}

pub fn current_mb(&self) -> f64

Get memory usage in MB

Examples found in repository

examples/memory_efficient_example.rs (line 331)

fn print_memory_usage(usage: &MemoryUsage) {
    println!("  Current: {:.2} MB", usage.current_mb());
    println!("  Peak: {:.2} MB", usage.peak_mb());
    println!("  Active allocations: {}", usage.active_allocations);
    println!("  Total allocations: {}", usage.total_allocations);
}

pub fn peak_mb(&self) -> f64

Get peak memory usage in MB

Examples found in repository

examples/memory_efficient_example.rs (line 332)

fn print_memory_usage(usage: &MemoryUsage) {
    println!("  Current: {:.2} MB", usage.current_mb());
    println!("  Peak: {:.2} MB", usage.peak_mb());
    println!("  Active allocations: {}", usage.active_allocations);
    println!("  Total allocations: {}", usage.total_allocations);
}

Trait Implementations

impl Clone for MemoryUsage

fn clone(&self) -> MemoryUsage

Returns a duplicate of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MemoryUsage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MemoryUsage

fn default() -> Self

Returns the “default value” for a type.