Struct HeapStats 

pub struct HeapStats {
    pub allocated_objects: u64,
    pub allocated_bytes: u64,
    pub collections: u64,
    pub freed_objects: u64,
    pub live_bytes: u64,
    pub live_objects: u64,
    pub peak_bytes: u64,
    pub pause: Duration,
}

What a run’s heaps did in total.

cove run --stats prints this, and the trace’s heap_summary event carries it.

Fields

allocated_objects: u64

Collectable objects allocated over the whole run.

allocated_bytes: u64

Bytes those allocations asked for, at the size each object was born.

collections: u64

How many collections ran.

freed_objects: u64

Objects those collections reclaimed.

live_bytes: u64

Bytes live at the most recent collection.

live_objects: u64

Objects live at the most recent collection.

peak_bytes: u64

The largest live set any collection measured.

pause: Duration

Total time the program was stopped for collection.

Implementations

impl HeapStats

pub fn merge(&mut self, other: &HeapStats)

Folds one heap’s totals into these, which is what happens when a task’s thread ends and its heap is retired into the run’s.

The live figures are not merged: a live set is a present fact about one heap rather than a total over a run. At the end of a run every task’s heap has been swept and gone with its thread, so what is live is the entry’s own and crate::interp::Interpreter::heap_stats reads it from there.

Trait Implementations

impl Clone for HeapStats

fn clone(&self) -> HeapStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HeapStats

impl Debug for HeapStats

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

Formats the value using the given formatter.

impl Default for HeapStats

fn default() -> HeapStats

Returns the “default value” for a type.

impl Eq for HeapStats

impl PartialEq for HeapStats

fn eq(&self, other: &HeapStats) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for HeapStats