Enum Error 

pub enum Error {
    Empty,
    MissingMsh,
    BadMshHeader(String),
    Path(String),
    NoSuchSegment {
        name: String,
        occurrence: usize,
    },
    UnwritablePath(String),
    MissingField {
        path: String,
    },
    BadValue {
        path: String,
        expected: String,
        found: String,
    },
    Dictionary(Error),
    Invalid(Vec<Diagnostic>),
}

What can go wrong.

Reading is deliberately lenient below the MSH header: unknown segments, unknown data types, and structure mismatches are never errors — they degrade to positional names and a flat reading, and are reported by Message::validate if the caller wants to know. Only a message with no usable header, a path that is not a path, a dictionary that will not load, and (in struct mode) a value that does not fit its Rust type will fail a call.

Variants

Empty

Input contained no segments.

MissingMsh

The first segment is not MSH, so the message never declared its delimiters.

BadMshHeader(String)

The MSH header is malformed: no delimiters, or an unusable set.

Path(String)

A path such as PID-5.1 could not be read; carries the reason.

NoSuchSegment

A write named a segment the message does not have. Add it with Message::append_segment or build the message with Builder.

Fields

name: String

The segment name that was asked for.

occurrence: usize

Which occurrence of it.

UnwritablePath(String)

A write named something that cannot be written — a whole segment, or a repeating value without a field.

MissingField

Struct mode: a non-optional field’s path names nothing in the message.

Fields

path: String

The path that was empty.

BadValue

Struct mode: a value is present but does not fit the Rust type.

Fields

path: String

Where the value is.

expected: String

What was expected there.

found: String

The text that was found.

Dictionary(Error)

A dictionary could not be loaded; see dictionary::Error.

Invalid(Vec<Diagnostic>)

Options::strict was set and the message did not pass validation. Carries every Severity::Error diagnostic.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(error: Error) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(error: Error) -> Error

Converts to this type from the input type.

impl PartialEq for Error

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error