Struct Error 

pub struct Error { /* private fields */ }

Errors that can occur during JPEG encoding/decoding.

Use Error::kind() to match on the specific error variant.

Implementations

impl Error

pub fn new(kind: ErrorKind) -> Self

Create a new error with the given kind, capturing the current location.

pub const fn new_untraced(kind: ErrorKind) -> Self

Create a new error without capturing a trace (for hot paths).

pub fn kind(&self) -> &ErrorKind

Get the kind of error.

pub fn into_kind(self) -> ErrorKind

Convert into the error kind, discarding the trace.

pub fn invalid_dimensions(width: u32, height: u32, reason: &'static str) -> Self

Create an invalid dimensions error.

pub fn invalid_color_format(reason: &'static str) -> Self

Create an invalid color format error.

pub fn invalid_buffer_size(expected: usize, actual: usize) -> Self

Create an invalid buffer size error.

pub fn unsupported_feature(feature: &'static str) -> Self

Create an unsupported feature error.

pub fn unsupported_pixel_format(format: PixelFormat) -> Self

Create an unsupported pixel format error.

pub fn allocation_failed(bytes: usize, context: &'static str) -> Self

Create an allocation failed error.

pub fn size_overflow(context: &'static str) -> Self

Create a size overflow error.

pub fn image_too_large(pixels: u64, limit: u64) -> Self

Create an image too large error.

pub fn io_error(reason: String) -> Self

Create an I/O error.

pub fn icc_error(reason: String) -> Self

Create an ICC error.

pub fn internal(reason: &'static str) -> Self

Create an internal error.

pub fn cancelled() -> Self

Create a cancelled error.

pub fn invalid_jpeg_data(reason: &'static str) -> Self

Create an invalid JPEG data error.

pub fn truncated_data(context: &'static str) -> Self

Create a truncated data error.

pub fn invalid_marker(marker: u8, context: &'static str) -> Self

Create an invalid marker error.

pub fn invalid_huffman_table(table_idx: u8, reason: &'static str) -> Self

Create an invalid Huffman table error.

pub fn invalid_quant_table(table_idx: u8, reason: &'static str) -> Self

Create an invalid quantization table error.

pub fn too_many_scans(count: usize, limit: usize) -> Self

Create a too many scans error.

pub fn decode_error(reason: String) -> Self

Create a decode error.

pub fn invalid_quality(value: f32, valid_range: &'static str) -> Self

Create an invalid quality error.

pub fn invalid_scan_script(reason: String) -> Self

Create an invalid scan script error.

pub fn invalid_config(reason: String) -> Self

Create an invalid config error.

pub fn stride_too_small(width: u32, stride: usize) -> Self

Create a stride too small error.

pub fn too_many_rows(height: u32, pushed: u32) -> Self

Create a too many rows error.

pub fn incomplete_image(height: u32, pushed: u32) -> Self

Create an incomplete image error.

Trait Implementations

impl AtTraceable for Error

fn trace_mut(&mut self) -> &mut AtTrace

Get a mutable reference to the embedded trace.

fn trace(&self) -> Option<&AtTrace>

Get an immutable reference to the trace, if allocated.

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

Format just the error message (without trace).

fn at(self) -> Self

Add the caller’s location to the trace.

fn at_str(self, msg: &'static str) -> Self

Add a static string context to the last location (or create one if empty).

fn at_string(self, f: impl FnOnce() -> String) -> Self

Add a lazily-computed string context to the last location (or create one if empty).

fn at_data<T>(self, f: impl FnOnce() -> T) -> Self

where T: Display + Send + Sync + 'static,

Add lazily-computed typed context (Display) to the last location (or create one if empty).

fn at_debug<T>(self, f: impl FnOnce() -> T) -> Self

where T: Debug + Send + Sync + 'static,

Add lazily-computed typed context (Debug) to the last location (or create one if empty).

fn at_error<E>(self, err: E) -> Self

where E: Error + Send + Sync + 'static,

Add an error as context to the last location (or create one if empty).

fn at_crate(self, info: &'static AtCrateInfo) -> Self

Add a crate boundary marker to the last location (or create one if empty).

fn at_fn<F>(self, _marker: F) -> Self

where F: Fn(),

Add a location frame with the caller’s function name as context.

fn at_named(self, name: &'static str) -> Self

Add a location frame with an explicit name as context.

fn at_pop(&mut self) -> Option<AtFrameOwned>

Pop the most recent location and its contexts from the trace.

fn at_push(&mut self, segment: AtFrameOwned)

Push a segment (location + contexts) to the end of the trace.

fn at_first_pop(&mut self) -> Option<AtFrameOwned>

Pop the oldest location and its contexts from the trace.

fn at_first_insert(&mut self, segment: AtFrameOwned)

Insert a segment (location + contexts) at the beginning of the trace.

fn map_traceable<E2, F>(self, f: F) -> E2

where F: FnOnce(Self) -> E2, E2: AtTraceable,

Convert to another AtTraceable type, transferring the trace.

fn into_at<E2, F>(self, f: F) -> At<E2>

where F: FnOnce(Self) -> E2,

Convert to At<E2>, transferring the trace.

fn full_trace(&self) -> impl Display

Format with full trace (message + all frames with contexts).

fn last_error_trace(&self) -> impl Display

Format with trace locations only (message + locations, no context strings).

fn last_error(&self) -> impl Display

Format just the error message (no trace).

impl Clone for Error

fn clone(&self) -> Self

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

Available on crate feature std only.

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

Available on crate feature std only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<StopReason> for Error

fn from(_: StopReason) -> Self

Converts to this type from the input type.

impl PartialEq for Error

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.