Struct BoundedNode

pub struct BoundedNode<V> { /* private fields */ }

A Node with a bounded number of child Nodes.

Child Nodes at indices [begin, end) are guaranteed to be fully constructed.

let inspector = Inspector::default();
let mut bounded_node =
    BoundedNode::from_node_and_capacity(inspector.root().create_child("bounded-node"), 2);

struct Item {
    _node: Node,
}
bounded_node.push(|n| {
    n.record_string("dropped-field", "dropped-value");
    Item { _node: n }
});
bounded_node.push(|n| {
    n.record_string("some-field", "some-value");
    Item { _node: n }
});
bounded_node.push(|n| {
    n.record_string("other-field", "other-value");
    Item { _node: n }
});

assert_data_tree!(
    inspector,
    root: {
        "bounded-node": {
            "capacity": 2u64,
            "begin": 1u64,
            "end": 3u64,
            "children": {
                "1": { "some-field": "some-value" },
                "2": { "other-field": "other-value" }
            }
        }
    }
)

Implementations

impl<V> BoundedNode<V>

pub fn from_node_and_capacity(node: Node, capacity: usize) -> Self

Creates a BoundedNode. BoundedNodes with capacity zero do not store any Vs.

pub fn push(&mut self, f: impl FnOnce(Node) -> V)

Push a child Node to the exported Inspect tree. f is called with the new Node and returns a type V that should contain that Node and any other desired Inspect objects. Drops oldest child Node if capacity would be exceeded.

Trait Implementations

impl<V: Debug> Debug for BoundedNode<V>

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

Formats the value using the given formatter.