Struct InvalidCharError 

pub struct InvalidCharError { /* private fields */ }

Invalid hex character.

Implementations

impl InvalidCharError

pub fn pos(&self) -> usize

Returns the position of the invalid character byte.

pub fn offset(self, by_bytes: usize) -> Self

Adds by_bytes to all character positions stored inside.

Important: if you have DecodeVariableLengthBytesError or DecodeFixedLengthBytesError you should call the method on them - do not match them and manually call this method. Doing so may lead to broken behavior in the future.

If you’re parsing a larger string that consists of multiple hex sub-strings and want to return InvalidCharError you may need to use this function so that the callers of your parsing function can tell the exact position where decoding failed relative to the start of the string passed into your parsing function.

Note that this function has the standard Rust overflow behavior because you should only ever pass in the position of the parsed hex string relative to the start of the entire input. In that case overflow is impossible.

This method consumes and returns self so that calling it inside a closure passed into Result::map_err is convenient.

Trait Implementations

impl Clone for InvalidCharError

fn clone(&self) -> InvalidCharError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InvalidCharError

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

Formats the value using the given formatter.

impl Display for InvalidCharError

Note that the implementation displays position as 1-based instead of 0-based to be more suitable to end users who might be non-programmers.

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

Formats the value using the given formatter.

impl Error for InvalidCharError

Available on crate feature std, or crate feature newer-rust-version and rust_version=>= 1.81.0 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<Infallible> for InvalidCharError

fn from(never: Infallible) -> Self

Converts to this type from the input type.

impl From<InvalidCharError> for DecodeFixedLengthBytesError

fn from(e: InvalidCharError) -> Self

Converts to this type from the input type.

impl From<InvalidCharError> for DecodeVariableLengthBytesError

fn from(e: InvalidCharError) -> Self

Converts to this type from the input type.

impl PartialEq for InvalidCharError

fn eq(&self, other: &InvalidCharError) -> 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.

impl Eq for InvalidCharError

impl StructuralPartialEq for InvalidCharError