Enum dicom_encoding::adapters::EncodeError

#[non_exhaustive]
pub enum EncodeError {
    Custom {
        message: String,
        source: Option<Box<dyn Error + Send + Sync + 'static>>,
    },
    NotNative,
    FrameRangeOutOfBounds,
    MissingAttribute {
        name: &'static str,
    },
}

The possible error conditions when encoding (writing) pixel data.

Users of this type are free to handle errors based on their variant, but should not make decisions based on the display message, since that is not considered part of the API and may change on any new release.

Implementers of transfer syntaxes are recommended to choose the most fitting error variant for the tested condition. When no suitable variant is available, the Custom variant may be used. See also snafu for guidance on using context selectors.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Custom

Fields

message: String

The error message.

source: Option<Box<dyn Error + Send + Sync + 'static>>

The underlying error cause, if any.

A custom error when encoding fails. Read the message and the underlying source for more details.

NotNative

Input pixel data is not native, should be decoded first.

FrameRangeOutOfBounds

The requested frame range is outside the given object’s frame range.

MissingAttribute

Fields

name: &'static str

A required attribute is missing from the DICOM object representing the image.

Trait Implementations

impl Debug for EncodeError

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

Formats the value using the given formatter.

impl Display for EncodeError

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

Formats the value using the given formatter.

impl Error for EncodeErrorwhere Self: Debug + Display,

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 source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn provide<'a>(&'a self, demand: &mut Demand<'a>)

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

Provides type based access to context intended for error reports.

impl ErrorCompat for EncodeError

fn backtrace(&self) -> Option<&Backtrace>

Returns a Backtrace that may be printed.

fn iter_chain(&self) -> ChainCompat<'_>where Self: AsErrorSource,

Returns an iterator for traversing the chain of errors, starting with the current error and continuing with recursive calls to Error::source.

impl FromString for EncodeError

type Source = Box<dyn Error + Send + Sync, Global>

The underlying error

fn without_source(message: String) -> Self

Create a brand new error from the given string

fn with_source(error: Self::Source, message: String) -> Self

Wrap an existing error with the given string

impl IntoError<EncodeError> for FrameRangeOutOfBoundsSnafuwhere EncodeError: Error + ErrorCompat,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> EncodeError

Combine the information to produce the error

impl<__T0> IntoError<EncodeError> for MissingAttributeSnafu<__T0>where EncodeError: Error + ErrorCompat, __T0: Into<&'static str>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> EncodeError

Combine the information to produce the error

impl IntoError<EncodeError> for NotNativeSnafuwhere EncodeError: Error + ErrorCompat,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> EncodeError

Combine the information to produce the error