Enum ruma_identifiers::Error

pub enum Error {
    InvalidCharacters,
    InvalidKeyVersion,
    InvalidLocalPart,
    InvalidServerName,
    MaximumLengthExceeded,
    MinimumLengthNotSatisfied,
    MissingDelimiter,
    MissingDeviceKeyDelimiter,
    MissingServerKeyDelimiter,
    MissingSigil,
    UnknownKeyAlgorithm,
}

An error encountered when trying to parse an invalid ID string.

Variants

InvalidCharacters

The ID's localpart contains invalid characters.

Only relevant for user IDs.

InvalidKeyVersion

The key version contains outside of [a-zA-Z0-9_].

InvalidLocalPart

The localpart of the ID string is not valid (because it is empty).

InvalidServerName

The server name part of the the ID string is not a valid server name.

MaximumLengthExceeded

The ID exceeds 255 bytes (or 32 codepoints for a room version ID.)

MinimumLengthNotSatisfied

The ID is less than 4 characters (or is an empty room version ID.)

MissingDelimiter

The ID is missing the colon delimiter between localpart and server name.

MissingDeviceKeyDelimiter

The ID is missing the colon delimiter between key algorithm and device ID.

MissingServerKeyDelimiter

The ID is missing the colon delimiter between key algorithm and version.

MissingSigil

The ID is missing the leading sigil.

UnknownKeyAlgorithm

The key algorithm is not recognized.

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

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl Hash for Error

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

Feeds this value into the given [Hasher].

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

Feeds a slice of this type into the given [Hasher].

impl PartialEq<Error> for Error

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.