Struct Addressing 

pub struct Addressing<'a> {
    pub keyed_lists: &'a [KeyedList<'a>],
    pub array_rule: Option<ArrayRule<'a>>,
}

How a non-numeric path segment resolves against an array.

A non-empty ASCII-decimal segment is always an index and never consults this (overflow is an error, not a slug fallback). Everything else has two possible sources, tried in this order:

• keyed_lists — the caller’s own declarations, e.g. “the array at identities is keyed by each element’s identity field”. A JSON or TOML document does not say this about itself, so only the caller can, and it names one exact array by path.
• array_rule — the format’s rule, for a format whose value is a tree afdata synthesized and therefore knows the shape of. Only Markdown has one today; it applies to every array in the document rather than to one named path.

With neither, a non-numeric segment against an array is DocumentError::UnregisteredArray — afdata will not scan an array it was told nothing about.

Fields

keyed_lists: &'a [KeyedList<'a>]

array_rule: Option<ArrayRule<'a>>

Implementations

impl<'a> Addressing<'a>

pub const INDEX_ONLY: Addressing<'static>

Indices only: no keyed lists, no format rule.

pub const fn keyed(keyed_lists: &'a [KeyedList<'a>]) -> Self

Caller-declared keyed lists, with no format rule.

pub const fn with_array_rule(self, array_rule: Option<ArrayRule<'a>>) -> Self

The same addressing plus a format’s built-in array rule.

Trait Implementations

impl<'a> Clone for Addressing<'a>

fn clone(&self) -> Addressing<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Addressing<'a>

impl<'a> Debug for Addressing<'a>

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

Formats the value using the given formatter.

impl<'a> Default for Addressing<'a>

fn default() -> Addressing<'a>

Returns the “default value” for a type.