Struct zalgo_codec_common::Error

pub struct Error { /* private fields */ }

The error returned by zalgo_encode, ZalgoString::new, and zalgo_wrap_python if they encounter a byte they can not encode.

Only implements the Error trait if the std feature is enabled.

Implementations

impl Error

pub const fn line(&self) -> usize

Returns the 1-indexed line number of the line on which the unencodable byte occured.

Examples

assert_eq!(zalgo_encode("❤️").map_err(|e| e.line()), Err(1));
assert_eq!(zalgo_encode("a\nb\nc\r\n").map_err(|e| e.line()), Err(3));

pub const fn column(&self) -> usize

Returns the 1-indexed column where the unencodable byte occured. Columns are counted from left to right and the count resets for each new line.

Example

assert_eq!(zalgo_encode("I ❤️ 🎂").map_err(|e| e.column()), Err(3));
assert_eq!(zalgo_encode("I\n❤️\n🎂").map_err(|e|e.column()), Err(1));

pub const fn char(&self) -> char

Returns the unencodable character that caused the error.

This may not match with what you see when you look at the unencoded string in a text editor since some grapheme clusters consist of many unicode characters.

Examples

assert_eq!(zalgo_encode("CRLF\r\n").map_err(|e| e.char()), Err('\r'));

The ❤️ emoji consists of two characters, the heart U+2764 and the color variant selector U+FE0F Since the heart is not encodable, that is the place where the error is generated:

assert_eq!(zalgo_encode("❤️").map_err(|e| e.char()), Err('❤'));

The grapheme cluster á consists of a normal a and a combining acute accent, U+301. The a can be encoded and the combining acute accent can not, so the error points only to the accent:

assert_eq!(zalgo_encode("á").map_err(|e| e.char()), Err('\u{301}'))

pub const fn index(&self) -> usize

Returns the index of the string where the unencodable character occured.

Example

assert_eq!(zalgo_encode("ab\ncdë").map_err(|e| e.index()), Err(5));

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy 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)>

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 Hash for Error

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Error

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Copy for Error

impl Eq for Error

impl StructuralPartialEq for Error