Struct ComponentRef 

pub struct ComponentRef { /* private fields */ }

Reference to a component data element within a composite data element.

Composites such as C507 (DTM date/time/period) are addressed by the identifier of their own components (2005, 2380, 2379), which is what makes code-addressed access — Segment::value_by_code and #[edifact(element = "2005")] — resolve to the right slot instead of a hand-counted index.

Fields are private to enforce the one-based position invariant.

Implementations

impl ComponentRef

pub const fn new( position: u8, data_element: &'static str, status: Status, ) -> Self

Construct a ComponentRef with compile-time position validation.

position must be ≥ 1 (one-based). In a const context a zero position is a compile-time error; at runtime it panics.

Panics

Panics if position == 0.

Example

use edifact_rs::{ComponentRef, Status};

const DTM_2005: ComponentRef = ComponentRef::new(1, "2005", Status::Mandatory);

pub const fn position(&self) -> u8

One-based component position within the composite.

pub const fn data_element(&self) -> &'static str

UN/EDIFACT component data element identifier.

pub const fn status(&self) -> Status

Requirement status of the component.

Trait Implementations

impl Clone for ComponentRef

fn clone(&self) -> ComponentRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ComponentRef

impl Debug for ComponentRef

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

Formats the value using the given formatter.