Struct BorrowedElement 

pub struct BorrowedElement<'a>(/* private fields */);

Zero-allocation view of an OwnedElement.

Implements the same accessor methods as Element without constructing any intermediate SmallVec or Cow values. Use this when you hold an &OwnedSegment reference and want to inspect element data without the Vec<Element> allocation that OwnedSegment::as_borrowed incurs.

Construct via BorrowedElement::from(&owned_element) or through BorrowedSegment::get_element.

Implementations

impl<'a> BorrowedElement<'a>

pub fn get_component(&self, n: usize) -> Option<&'a str>

Return the component at position n (0-indexed), if it exists.

pub fn component_or_empty(&self, n: usize) -> &'a str

Return the component at position n, or "" if absent.

pub fn component_span(&self, n: usize) -> Option<Span>

Return the byte span of the component at position n, if it exists.

pub fn span(&self) -> Span

The byte span covering the whole element.

pub fn len(&self) -> usize

Number of components in this element.

pub fn is_empty(&self) -> bool

Returns true if this element has no components.

pub fn iter(&self) -> impl Iterator<Item = &'a str>

Iterate over all component strings.

pub fn repeat_count(&self) -> usize

Number of repetitions of this data element — always at least 1.

pub fn repetition(&self, n: usize) -> Option<&'a [(String, Span)]>

Components of repetition n (0-indexed), if it exists.

pub fn repetitions(&self) -> impl Iterator<Item = &'a [(String, Span)]>

Iterate over every repetition of this element, first one included.

Trait Implementations

impl<'a> Clone for BorrowedElement<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for BorrowedElement<'a>

impl<'a> Debug for BorrowedElement<'a>

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

Formats the value using the given formatter.

impl<'a> From<&'a OwnedElement> for BorrowedElement<'a>

fn from(elem: &'a OwnedElement) -> Self

Converts to this type from the input type.