Enum Error 

#[non_exhaustive]
pub enum Error {
    Io(Error),
    Core(Error),
    UnexpectedEof,
    InvalidHeader(String),
    MultiBufferLengthMismatch {
        declared: usize,
        actual: usize,
    },
    BufferSizeMismatch {
        index: usize,
        declared: u64,
        actual: u64,
    },
    FrameTooLarge {
        kind: &'static str,
        value: u64,
        limit: u64,
    },
    InvalidCrossMachineSyncMode {
        index: usize,
        actual: u8,
    },
    UnallocatableBuffer {
        index: usize,
        byte_size: u64,
        alignment: u32,
    },
    TornComposite {
        declared: u32,
        actual: u32,
    },
    CompositeNestingTooDeep {
        limit: usize,
    },
    NotAComposite(String),
    CoreUnusable(Unusable),
    CoreFailed,
    InvalidProgressReport {
        reported: usize,
        offered: usize,
    },
    ZeroLengthWrite,
    SinkClosed,
    HeaderNotWritten,
    InvalidFileMagic,
    InvalidTrailerMagic,
    UnsupportedContainerVersion {
        major: u8,
    },
    TensorNotFound(String),
    DuplicateTensorName(String),
    TensorNameEmpty,
    TensorNameTooLong {
        len: usize,
    },
    IndexCrc32cMismatch {
        stored: u32,
        computed: u32,
    },
    DuplicateKvKey(String),
    KvKeyEmpty,
    KvKeyTooLong {
        len: usize,
    },
    ReservedFileFlagBits {
        flags: u32,
    },
    IndexOverrunsTrailer,
}

Crate-level error type for hurray-io.

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.

Io(Error)

An I/O error from the underlying stream or file.

Core(Error)

A core format error.

UnexpectedEof

The stream ended before a complete record was read.

InvalidHeader(String)

A frame or record header is malformed.

MultiBufferLengthMismatch

The number of supplied buffer slices does not match the descriptor’s buffer table.

Fields

declared: usize

actual: usize

BufferSizeMismatch

A supplied buffer’s byte length does not match the corresponding handle’s byte_size.

Fields

index: usize

declared: u64

actual: u64

FrameTooLarge

A descriptor or buffer exceeded the configured size limit.

Fields

kind: &'static str

value: u64

limit: u64

InvalidCrossMachineSyncMode

A buffer handle’s sync_mode is invalid for a cross-machine transport.

Fields

index: usize

actual: u8

UnallocatableBuffer

A buffer handle’s declared size and alignment do not form an allocatable layout on this host (a byte_size beyond the address space, or a non-power-of-two alignment).

Fields

index: usize

byte_size: u64

alignment: u32

TornComposite

A composite head’s members were truncated: the stream ended before the head’s declared member_count members had been read.

Fields

declared: u32

actual: u32

CompositeNestingTooDeep

Composite nesting exceeded the configured maximum depth. Guards against stack exhaustion from a maliciously deep composite on an untrusted stream.

Fields

limit: usize

NotAComposite(String)

A composite read was requested for a tensor whose head is not a composite.

CoreUnusable(Unusable)

The core was marked unusable: a transport moved bytes whose count was lost, so the core’s position no longer matches the transport’s.

CoreFailed

A previous call returned an error and this core cannot continue. Distinct from Error::CoreUnusable: the position is known, the stream is simply over.

InvalidProgressReport

A driver reported more bytes than the core offered it.

Fields

reported: usize

offered: usize

ZeroLengthWrite

A driver reported a zero-length write, which is never progress.

SinkClosed

The sink was closed while an item was in flight, so a truncated item is on the wire. The core and the sink are both poisoned.

HeaderNotWritten

A tensor or footer was submitted to a file writer core before its header.

InvalidFileMagic

The file header magic is not HRRYFILE.

InvalidTrailerMagic

The trailer magic is not HRRY.

UnsupportedContainerVersion

The container major version is higher than this reader supports.

Fields

major: u8

TensorNotFound(String)

A tensor name was requested but is not in the file index.

DuplicateTensorName(String)

Two tensors in the same file share a name.

TensorNameEmpty

A tensor name is empty.

TensorNameTooLong

A tensor name exceeds the 65 535-byte uint16 limit.

Fields

len: usize

IndexCrc32cMismatch

The index CRC-32C does not match the stored value.

Fields

stored: u32

computed: u32

DuplicateKvKey(String)

Two KV entries share the same key.

KvKeyEmpty

A KV key is empty.

KvKeyTooLong

A KV key exceeds the 65 535-byte uint16 limit.

Fields

len: usize

ReservedFileFlagBits

A reserved flag bit was set in the file header.

Fields

flags: u32

IndexOverrunsTrailer

The index section overlaps the trailer.

Trait Implementations

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, __formatter: &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(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.