Struct bitstring_trees::map::RadixMap

pub struct RadixMap<S: BitString, V> { /* fields omitted */ }

RadixMap is a binary tree with path-shortening; leafs mark prefixes mapping to a value, inner nodes have no semantic meaning.

If a prefix maps to a value set, all strings prefixed by it are also considered to map to that value.

If an inner node would have only a single child, the paths to and from it could be shortened - therefor all inner nodes have two children.

Implementations

impl<S: BitString + Clone, V> RadixMap<S, V>

pub fn new() -> Self

New (empty) map.

pub fn insert_uncompressed(&mut self, key: S, value: V) where
    V: Clone, 

Add a new prefix => value mapping.

As values can’t be compared for equality it cannot merge neighbour prefixes that map to the same value.

pub fn insert(&mut self, key: S, value: V) where
    V: Clone + Eq, 

Add a new prefix => value mapping. (Partially) overwrites old mappings.

pub fn root(&self) -> Option<&Node<S, V>>

Read-only access to the tree.

An empty map doesn’t have any nodes (i.e. None).

pub fn iter(&self) -> Iter<'_, S, V>

Iterate over all values in the map

pub fn iter_full(&self) -> IterFull<'_, S, V>

Iterate over all values and missing values in the map

Trait Implementations

impl<S: Clone + BitString, V: Clone> Clone for RadixMap<S, V>

fn clone(&self) -> RadixMap<S, V>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S: BitString + Debug, V: Debug> Debug for RadixMap<S, V>

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

Formats the value using the given formatter.

impl<S: BitString, V> Default for RadixMap<S, V>

fn default() -> Self

Returns the “default value” for a type.