Struct OwnedSegment 

pub struct OwnedSegment {
    pub tag: String,
    pub span: Span,
    pub tag_span: Span,
    pub elements: Vec<OwnedElement>,
}

Owned segment used by reader-based parsing APIs.

Fields

tag: String

Segment tag, usually three uppercase letters.

span: Span

Span covering the whole segment payload.

tag_span: Span

Span covering only the segment tag.

elements: Vec<OwnedElement>

Owned segment elements in positional order.

Implementations

impl OwnedSegment

pub fn element_str(&self, n: usize) -> Option<&str>

Get the first component of element n, or None if absent.

This is the zero-allocation equivalent of as_borrowed().element_str(n). Used internally by crate::find_segment_owned and the derived crate::EdifactDeserialize::edifact_deserialize_owned implementations.

pub fn component_str(&self, elem: usize, comp: usize) -> Option<&str>

Get component comp of element elem, or None if absent.

Zero-allocation equivalent of as_borrowed().get_element(elem)?.get_component(comp).

pub fn offset(self, delta: usize) -> Self

Shift all stored spans by delta bytes.

pub fn as_borrowed(&self) -> Segment<'_>

View this owned segment as a borrowed Segment.

Performance note: allocates a Vec<Element<'_>> on every call. When only individual field access is needed, prefer OwnedSegment::borrow → BorrowedSegment which is O(1). as_borrowed remains necessary when the callee requires &[Segment<'_>].

pub fn borrow(&self) -> BorrowedSegment<'_>

Return a zero-allocation view of this segment.

Unlike as_borrowed, this is O(1) and performs no heap allocation. The view cannot be passed to APIs that require &[Segment<'_>]; use as_borrowed for those call sites.

pub fn value_at(&self, path: ElementPath) -> Option<&str>

Read the value at an already-resolved ElementPath.

pub fn span_at(&self, path: ElementPath) -> Option<Span>

Byte span of the value at an already-resolved ElementPath.

pub fn value_by_code<L: SegmentLayout + ?Sized>( &self, layout: &L, data_element: &str, ) -> Result<Option<&str>, EdifactError>

Read a value by its UN/EDIFACT data element identifier.

Owned-storage counterpart of Segment::value_by_code; allocates nothing.

Errors

As Segment::value_by_code.

pub fn span_by_code<L: SegmentLayout + ?Sized>( &self, layout: &L, data_element: &str, ) -> Result<Option<Span>, EdifactError>

Byte span of a value addressed by its UN/EDIFACT data element identifier.

Errors

As Segment::value_by_code.

pub fn element_by_code<L: SegmentLayout + ?Sized>( &self, layout: &L, data_element: &str, ) -> Result<Option<&OwnedElement>, EdifactError>

Return the whole OwnedElement addressed by a data element identifier.

When the identifier names a component inside a composite, the enclosing composite element is returned.

Errors

As Segment::value_by_code.

Trait Implementations

impl Clone for OwnedSegment

fn clone(&self) -> OwnedSegment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OwnedSegment

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

Formats the value using the given formatter.

impl Eq for OwnedSegment

impl<'a> From<&'a OwnedSegment> for BorrowedSegment<'a>

fn from(seg: &'a OwnedSegment) -> Self

Converts to this type from the input type.

impl<'a> From<Segment<'a>> for OwnedSegment

fn from(value: Segment<'a>) -> Self

Converts to this type from the input type.

impl PartialEq for OwnedSegment

fn eq(&self, other: &OwnedSegment) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for OwnedSegment