Struct OwnedKeyId 

pub struct OwnedKeyId<A, K>
where
    A: KeyAlgorithm,
    K: KeyName + ?Sized,
{ /* private fields */ }

Owned variant of KeyId

Inner representation

By default, this type uses a Box<str> internally. The inner representation can be selected at compile time by using one of the following supported values:

• Arc – Use an Arc<str>.

The selected value can be set by using the ruma_identifiers_storage compile-time cfg setting. This setting can be configured using the RUSTFLAGS environment variable at build time, like this:

RUSTFLAGS="--cfg ruma_identifiers_storage=\"{value}\""

Or in .cargo/config.toml:

# General setting for all targets, overridden by per-target `rustflags` setting if set.
[build]
rustflags = ["--cfg", "ruma_identifiers_storage=\"{value}\""]

# Per-target setting.
[target.<triple/cfg>]
rustflags = ["--cfg", "ruma_identifiers_storage=\"{value}\""]

This setting can also be configured using the RUMA_IDENTIFIERS_STORAGE environment variable at compile time, which has the benefit of not requiring to re-compile the whole dependency chain when the value is changed, like this:

RUMA_IDENTIFIERS_STORAGE="{value}"

Implementations

impl<A, K> OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

pub fn zeroize(self)

Available on crate feature events only.

Securely zero memory (aka zeroize) of OwnedKeyId.

This method zeroizes this type by writing zeros in its memory location before freeing it. It internally uses the zeroize crate. Note that this type doesn’t implement the zeroize::Zeroize trait because the Zeroize::zeroize method takes a &mut self, which means we could put this type into an inconsistent state if it is used after calling that method. Instead, this method takes ownership of the type, ensuring it’s impossible to misuse it.

Implementation details

If the ruma_identifiers_storage configuration is set to Arc, this type will be zeroized if and only if Arc::get_mut returns Some reference, i.e. if there is no other Arc or Weak pointers to this same location.

Methods from Deref<Target = KeyId<A, K>>

pub fn as_str(&self) -> &str

Available on crate feature events only.

Extracts a string slice from this KeyId.

pub fn as_bytes(&self) -> &[u8]

Available on crate feature events only.

Extracts a byte slice from this KeyId.

pub fn algorithm(&self) -> A

Available on crate feature events only.

Returns key algorithm of the key ID - the part that comes before the colon.

Example

use ruma_common::{DeviceKeyAlgorithm, DeviceKeyId};

let k = DeviceKeyId::parse("ed25519:1").unwrap();
assert_eq!(k.algorithm(), DeviceKeyAlgorithm::Ed25519);

pub fn key_name<'a>(&'a self) -> &'a K

where &'a K: TryFrom<&'a str>,

Available on crate feature events only.

Returns the key name of the key ID - the part that comes after the colon.

Example

use ruma_common::{DeviceKeyId, device_id};

let k = DeviceKeyId::parse("ed25519:DEV1").unwrap();
assert_eq!(k.key_name(), device_id!("DEV1"));

Trait Implementations

impl<A, K> AsRef<KeyId<A, K>> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn as_ref(&self) -> &KeyId<A, K>

Converts this type into a shared reference of the (usually inferred) input type.

impl<A, K> AsRef<[u8]> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl<A, K> AsRef<str> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl<A, K> Borrow<KeyId<A, K>> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn borrow(&self) -> &KeyId<A, K>

Immutably borrows from an owned value.

impl<A, K> Borrow<str> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl<A, K> Clone for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn clone(&self) -> OwnedKeyId<A, K>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<A, K> Debug for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

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

Formats the value using the given formatter.

impl<A, K> Deref for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

type Target = KeyId<A, K>

The resulting type after dereferencing.

fn deref(&self) -> &<OwnedKeyId<A, K> as Deref>::Target

Dereferences the value.

impl<'de, A, K> Deserialize<'de> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn deserialize<D>( deserializer: D, ) -> Result<OwnedKeyId<A, K>, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<A, K> Display for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

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

Formats the value using the given formatter.

impl<A, K> Eq for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

impl<A, K> From<&KeyId<A, K>> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn from(id: &KeyId<A, K>) -> OwnedKeyId<A, K>

Converts to this type from the input type.

impl<A, K> From<OwnedKeyId<A, K>> for Box<str>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn from(id: OwnedKeyId<A, K>) -> Box<str>

Converts to this type from the input type.

impl<A, K> From<OwnedKeyId<A, K>> for String

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn from(id: OwnedKeyId<A, K>) -> String

Converts to this type from the input type.

impl<A, K> FromStr for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

type Err = Error

The associated error which can be returned from parsing.

fn from_str( s: &str, ) -> Result<OwnedKeyId<A, K>, <OwnedKeyId<A, K> as FromStr>::Err>

Parses a string s to return a value of this type.

impl<A, K> Hash for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<A, K> Ord for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn cmp(&self, other: &OwnedKeyId<A, K>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<A, K> PartialEq for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn eq(&self, other: &OwnedKeyId<A, K>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<A, K> PartialEq<&KeyId<A, K>> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn eq(&self, other: &&KeyId<A, K>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<A, K> PartialEq<&str> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

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

Equality operator ==.

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

Inequality operator !=.

impl<'a, A, K> PartialEq<Cow<'a, str>> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn eq(&self, other: &Cow<'a, str>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<A, K> PartialEq<KeyId<A, K>> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn eq(&self, other: &KeyId<A, K>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<A, K> PartialEq<OwnedKeyId<A, K>> for str

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn eq(&self, other: &OwnedKeyId<A, K>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<A, K> PartialEq<OwnedKeyId<A, K>> for &str

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn eq(&self, other: &OwnedKeyId<A, K>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<A, K> PartialEq<OwnedKeyId<A, K>> for KeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn eq(&self, other: &OwnedKeyId<A, K>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<A, K> PartialEq<OwnedKeyId<A, K>> for &KeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn eq(&self, other: &OwnedKeyId<A, K>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<A, K> PartialEq<String> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

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

Equality operator ==.

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

Inequality operator !=.

impl<A, K> PartialEq<str> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

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

Equality operator ==.

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

Inequality operator !=.

impl<A, K> PartialOrd for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn partial_cmp(&self, other: &OwnedKeyId<A, K>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<A, K> Serialize for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<A, K> TryFrom<&str> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

type Error = Error

The type returned in the event of a conversion error.

fn try_from( s: &str, ) -> Result<OwnedKeyId<A, K>, <OwnedKeyId<A, K> as TryFrom<&str>>::Error>

Performs the conversion.

impl<A, K> TryFrom<Box<str>> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

type Error = Error

The type returned in the event of a conversion error.

fn try_from( s: Box<str>, ) -> Result<OwnedKeyId<A, K>, <OwnedKeyId<A, K> as TryFrom<Box<str>>>::Error>

Performs the conversion.

impl<'a, A, K> TryFrom<Cow<'a, str>> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

type Error = Error

The type returned in the event of a conversion error.

fn try_from( s: Cow<'a, str>, ) -> Result<OwnedKeyId<A, K>, <OwnedKeyId<A, K> as TryFrom<Cow<'a, str>>>::Error>

Performs the conversion.

impl<A, K> TryFrom<String> for OwnedKeyId<A, K>

where A: KeyAlgorithm, K: KeyName + ?Sized,

type Error = Error

The type returned in the event of a conversion error.

fn try_from( s: String, ) -> Result<OwnedKeyId<A, K>, <OwnedKeyId<A, K> as TryFrom<String>>::Error>

Performs the conversion.