Enum Error 

pub enum Error {
    Io {
        path: String,
        source: Error,
    },
    Write {
        path: String,
        what: String,
    },
    Http {
        url: String,
        status: Option<u16>,
        message: String,
    },
    Closed {
        path: String,
    },
    UnknownChromosome {
        id: String,
        key_size: Option<usize>,
        truncated_match: Option<String>,
        available: Vec<String>,
    },
    InvalidArgument(String),
    Format {
        path: String,
        what: String,
    },
    Corrupt {
        path: String,
        offset: u64,
        what: String,
    },
    Unsupported(String),
}

Variants

Io

A read that did not happen: the file is missing, unreadable, or the device failed under it.

Fields

path: String

source: Error

Write

A write that did not land. Separate from Error::Io because a full device is usually only reported at the flush or the close — the writes before it having gone into a buffer — so the moment it surfaces is not the moment it happened, and what is what says which moment it was.

Fields

path: String

what: String

Http

A URL that did not answer, or answered with something unusable.

Fields

url: String

status: Option<u16>

message: String

Closed

Use of a reader or writer whose close() has already run. Every method checks this first.

Fields

path: String

UnknownChromosome

A name no chromosome in the file answers to.

The parts are here rather than a finished sentence, so that a caller can use them: available is what to offer as a suggestion, key_size is the width of the file’s own name field, and truncated_match is the chromosome the id’s first key_size characters spell when the file holds one — likely the same chromosome stored truncated, but only likely, which is why it is named rather than resolved to.

Fields

id: String

key_size: Option<usize>

truncated_match: Option<String>

available: Vec<String>

InvalidArgument(String)

The caller asked for something that cannot be served: a bin size of zero, an end before its start, a reduction that does not exist, an array of the wrong shape.

Format

The file is not what it claims to be: wrong magic, wrong version, byte-swapped, a bigBed where a bigWig was needed.

Fields

path: String

what: String

Corrupt

The file is the right format and its own bytes contradict each other: a count reaching past the block, an offset past the end, a truncated record.

Fields

path: String

offset: u64

what: String

Unsupported(String)

A real feature of the format that this library does not implement.

Implementations

impl Error

pub fn invalid(msg: impl Into<String>) -> Self

pub fn format(path: impl Into<String>, what: impl Into<String>) -> Self

pub fn corrupt( path: impl Into<String>, offset: u64, what: impl Into<String>, ) -> Self

pub fn write(path: impl Into<String>, what: impl Into<String>) -> Self

pub fn io(path: impl Into<String>, source: Error) -> Self

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.