Struct Shape

#[non_exhaustive]
pub struct Shape {
    pub max_length: usize,
    pub max_depth: usize,
    pub count: NonZero<usize>,
    pub max_bits: u32,
}

Metadata about a TreeSchema namespace.

Metadata includes paths that may be crate::ValueError::Absent at runtime.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

max_length: usize

The maximum length of a path in bytes.

This is the exact maximum of the length of the concatenation of the node names in a crate::Path excluding the separators. See Self::max_length() for the maximum length including separators.

max_depth: usize

The maximum node depth.

This is equal to the exact maximum number of path hierarchy separators. It’s the exact maximum number of key indices.

count: NonZero<usize>

The exact total number of leaf nodes.

max_bits: u32

The maximum number of bits (see crate::Packed)

Implementations

impl Shape

pub const fn max_length(&self, separator: &str) -> usize

Add separator length to the maximum path length.

To obtain an upper bound on the maximum length of all paths including separators, this adds max_depth*separator_length.

pub const fn new(schema: &Schema) -> Self

Recursively compute Shape for a Schema.

Trait Implementations

impl Clone for Shape

fn clone(&self) -> Shape

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Shape

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Shape

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Shape

fn eq(&self, other: &Shape) -> 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 Serialize for Shape

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Shape

impl Eq for Shape

impl StructuralPartialEq for Shape