Enum Error 

#[non_exhaustive]
pub enum Error {
    InvalidTrackingId {
        reason: String,
    },
    IdPolicyMismatch {
        reason: String,
    },
    InvalidIdConfig(String),
    Entropy(String),
    InsufficientEntropy {
        needed: usize,
        got: usize,
    },
    Unencodable {
        symbology: &'static str,
        reason: String,
    },
    EmptyPayload,
    InvalidRenderOptions(String),
    Render(String),
    Decode(String),
    InvalidImage(String),
    NoSymbolFound(String),
    Io(Error),
}

Everything that can go wrong in this crate.

This enum is #[non_exhaustive]: new variants may be added in minor releases, so always include a _ arm when matching.

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.

InvalidTrackingId

A string did not have the shape of a tracking ID.

Fields

reason: String

Human-readable explanation of what failed validation.

IdPolicyMismatch

A tracking ID was structurally valid but did not match the policy of the IdGenerator it was checked against.

Fields

reason: String

Human-readable explanation of the mismatch.

InvalidIdConfig(String)

IdGenerator::builder was given contradictory or out-of-range settings.

Entropy(String)

The operating system’s randomness source was unavailable.

InsufficientEntropy

The caller-supplied entropy buffer was too small for the requested number of bits.

Fields

needed: usize

Bytes required for the configured entropy width.

got: usize

Bytes actually supplied.

Unencodable

The payload cannot be represented in the requested symbology.

Fields

symbology: &'static str

Name of the symbology that rejected the payload.

reason: String

Why the payload was rejected.

EmptyPayload

Symbologies in this crate reject empty payloads.

InvalidRenderOptions(String)

RenderOptions were internally inconsistent or would produce a degenerate image.

Render(String)

The renderer failed while producing output.

Decode(String)

A barcode could not be decoded back into a payload.

InvalidImage(String)

An image could not be interpreted as a pixel buffer.

NoSymbolFound(String)

Scanner found no readable barcode. A barcode that is present but unreadable is indistinguishable from one that is absent, so both report this.

Io(Error)

Available on crate feature std only.

An I/O error from one of the *_to_file helpers.

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.