Enum Version 

pub enum Version {
    V2_1,
    V2_2,
    V2_3,
    V2_3_1,
    V2_4,
    V2_5,
    V2_5_1,
    V2_6,
    V2_7,
    V2_7_1,
    V2_8,
    V2_8_1,
    V2_8_2,
    V2_9,
}

A published release of HL7 v2.

Ordering follows release order, so Version::V2_3 < Version::V2_3_1, which is what makes “nearest older release” a comparison rather than a table.

Variants

V2_1

HL7 v2.1 (1990).

V2_2

HL7 v2.2 (1994).

V2_3

HL7 v2.3 (1997).

V2_3_1

HL7 v2.3.1 (1999), which introduced MSH-9.3, the message structure.

V2_4

HL7 v2.4 (2000).

V2_5

HL7 v2.5 (2003). This crate’s base dictionary and its default.

V2_5_1

HL7 v2.5.1 (2007), the release most US interfaces still speak.

V2_6

HL7 v2.6 (2007).

V2_7

HL7 v2.7 (2011).

V2_7_1

HL7 v2.7.1 (2012).

V2_8

HL7 v2.8 (2014).

V2_8_1

HL7 v2.8.1 (2014).

V2_8_2

HL7 v2.8.2 (2015).

V2_9

HL7 v2.9 (2019).

Implementations

impl Version

pub fn as_str(self) -> &'static str

The release string as MSH-12.1 spells it, e.g. "2.5.1".

pub fn parse(text: &str) -> Option<Version>

The release named exactly by text, or None. Use Version::nearest when reading a real message, where a version string this crate does not know should degrade rather than fail.

pub fn nearest(text: &str) -> Option<Version>

The best release to read text as: the exact match if there is one, otherwise the newest known release no newer than text, otherwise (for a version older than everything, or unreadable) None.

Reading 2.5.2 as 2.5.1 is right far more often than it is wrong: point releases are additive, so the older dictionary names what it knows and the rest degrades to generic positional names, which is exactly the fallback the unknown-segment case already takes.

pub fn from_message(message: &Message) -> Option<Version>

The release a parsed message declares in MSH-12.1, resolved through Version::nearest. None when MSH-12 is absent or unreadable.

pub fn dictionary(self) -> Arc<Dictionary>

The bundled dictionary for this release.

Parsed on first use and shared thereafter; the returned Arc is cheap to clone and is what a crate::Message holds.

Panics

Never in practice: the bundled dictionaries are embedded at compile time and parsed on first use, so a failure here would mean this crate shipped a malformed one.

Trait Implementations

impl Clone for Version

fn clone(&self) -> Version

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Version

impl Debug for Version

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

Formats the value using the given formatter.

impl Default for Version

fn default() -> Version

Returns the “default value” for a type.

impl Display for Version

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

Formats the value using the given formatter.

impl Eq for Version

impl FromStr for Version

type Err = UnknownVersion

The associated error which can be returned from parsing.

fn from_str(text: &str) -> Result<Version, UnknownVersion>

Parses a string s to return a value of this type.

impl Hash for Version

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Version

fn cmp(&self, other: &Version) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Version

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Version

fn partial_cmp(&self, other: &Version) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Version