Struct Field

pub struct Field {
    pub range: Range<usize>,
    pub repeats: Vec<Repeat>,
}

Represents an HL7v2 field

Fields

range: Range<usize>

The range (in char indices) in the original message where the field is located

repeats: Vec<Repeat>

The repeats found within the component. This will always be at least 1 element long, and the vast majority of the time will only be 1 element long. However, in the case of field repeats (“arrays”, really), all of the repeat data will be stored here

Implementations

impl Field

pub fn repeat(&self, repeat: NonZeroUsize) -> Option<&Repeat>

Access a repeat via 1-based HL7 repeat index

Returns

A reference to the repeat

pub fn repeat_mut(&mut self, repeat: NonZeroUsize) -> Option<&mut Repeat>

Mutably access a repeat via 1-based HL7 repeat index

Returns

A mutable reference to the repeat

pub fn source<'s>(&self, message_source: &'s str) -> &'s str

Given the source for the original message, extract the (raw) string for this field

Arguments

• message_source - A string slice representing the original message source that was parsed

Examples

let message = include_str!("../test_assets/sample_oru_r01_generic.hl7");
let message = ParsedMessage::parse(&message, true).expect("can parse message");

let segment = message.segment("PID").expect("can get PID segment");
let field = segment.field(NonZeroUsize::new(3).unwrap()).expect("can get field 3");

assert_eq!(field.source(message.source), "12345^^^MIE&1.2.840.114398.1.100&ISO^MR");

pub fn repeat_at_cursor(&self, cursor: usize) -> Option<(NonZeroUsize, &Repeat)>

Locate a repeat at the cursor position

Arguments

• cursor - The cursor location (0-based character index of the original message)

Returns

A tuple containing the HL7 repeat index (1-based) and a reference to the repeat. If the field doesn’t contain the cursor, returns None

Trait Implementations

impl Clone for Field

fn clone(&self) -> Field

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Field

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Field

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<I: Into<usize>> Index<I> for &Field

type Output = Repeat

The returned type after indexing.

fn index(&self, index: I) -> &Self::Output

Performs the indexing (container[index]) operation.

impl PartialEq for Field

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Field

impl StructuralPartialEq for Field