Struct ruma_common::DeviceId

source · [−]

#[repr(transparent)]
pub struct DeviceId(_);

Expand description

A Matrix key ID.

Device identifiers in Matrix are completely opaque character sequences. This type is provided simply for its semantic value.

Example

use ruma_common::{device_id, DeviceId, OwnedDeviceId};

let random_id = DeviceId::new();
assert_eq!(random_id.as_str().len(), 8);

let static_id = device_id!("01234567");
assert_eq!(static_id.as_str(), "01234567");

let ref_id: &DeviceId = "abcdefghi".into();
assert_eq!(ref_id.as_str(), "abcdefghi");

let owned_id: OwnedDeviceId = "ijklmnop".into();
assert_eq!(owned_id.as_str(), "ijklmnop");

Implementations

impl DeviceId

pub fn as_str(&self) -> &str

Creates a string slice from this DeviceId.

pub fn as_bytes(&self) -> &[u8]ⓘNotable traits for &[u8]`impl<'_> Read for &[u8]impl<'_> Write for &mut [u8]`

Creates a byte slice from this DeviceId.

impl DeviceId

pub fn new() -> OwnedDeviceId

Generates a random DeviceId, suitable for assignment to a new device.

Trait Implementations

impl AsRef<DeviceId> for OwnedDeviceId

fn as_ref(&self) -> &DeviceId

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

impl AsRef<str> for DeviceId

fn as_ref(&self) -> &str

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

impl AsRef<str> for Box<DeviceId>

fn as_ref(&self) -> &str

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

impl Borrow<DeviceId> for OwnedDeviceId

fn borrow(&self) -> &DeviceId

Immutably borrows from an owned value. Read more

impl Clone for Box<DeviceId>

fn clone(&self) -> Self

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

impl Debug for DeviceId

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

Formats the value using the given formatter. Read more

impl<'de> Deserialize<'de> for Box<DeviceId>

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

impl Display for DeviceId

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

Formats the value using the given formatter. Read more

impl<'a> From<&'a str> for &'a DeviceId

fn from(s: &'a str) -> Self

Converts to this type from the input type.

impl From<&DeviceId> for OwnedDeviceId

fn from(id: &DeviceId) -> OwnedDeviceId

Converts to this type from the input type.

impl From<&DeviceId> for String

fn from(id: &DeviceId) -> Self

Converts to this type from the input type.

impl From<&DeviceId> for Box<DeviceId>

fn from(id: &DeviceId) -> Self

Converts to this type from the input type.

impl From<&DeviceId> for Rc<DeviceId>

fn from(s: &DeviceId) -> Rc<DeviceId>

Converts to this type from the input type.

impl From<&DeviceId> for Arc<DeviceId>

fn from(s: &DeviceId) -> Arc<DeviceId>

Converts to this type from the input type.

impl From<&str> for Box<DeviceId>

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<Box<str, Global>> for Box<DeviceId>

fn from(s: Box<str>) -> Self

Converts to this type from the input type.

impl From<String> for Box<DeviceId>

fn from(s: String) -> Self

Converts to this type from the input type.

impl Hash for DeviceId

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

Feeds this value into the given Hasher. Read more

1.3.0 · source

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

Feeds a slice of this type into the given Hasher. Read more

impl Ord for DeviceId

fn cmp(&self, other: &DeviceId) -> Ordering

This method returns an Ordering between self and other. Read more

1.21.0 · source

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

Compares and returns the maximum of two values. Read more

1.21.0 · source

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

Compares and returns the minimum of two values. Read more

1.50.0 · source

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

Restrict a value to a certain interval. Read more

impl PartialEq<&DeviceId> for OwnedDeviceId

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<&DeviceId> for Box<DeviceId>

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<&str> for DeviceId

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<&str> for Box<DeviceId>

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<Box<DeviceId, Global>> for DeviceId

fn eq(&self, other: &Box<DeviceId>) -> bool

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<Box<DeviceId, Global>> for &DeviceId

fn eq(&self, other: &Box<DeviceId>) -> bool

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<DeviceId> for DeviceId

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

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

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

This method tests for !=.

impl PartialEq<DeviceId> for OwnedDeviceId

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<DeviceId> for Box<DeviceId>

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<DeviceId> for str

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<DeviceId> for &str

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<DeviceId> for String

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<OwnedDeviceId> for DeviceId

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<OwnedDeviceId> for &DeviceId

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<OwnedDeviceId> for Box<DeviceId>

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<String> for DeviceId

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<String> for Box<DeviceId>

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<str> for DeviceId

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialEq<str> for Box<DeviceId>

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

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

1.0.0 · source

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

This method tests for !=.

impl PartialOrd<DeviceId> for DeviceId

fn partial_cmp(&self, other: &DeviceId) -> Option<Ordering>

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

1.0.0 · source

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

This method tests less than (for self and other) and is used by the < operator. Read more

1.0.0 · source

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

1.0.0 · source

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

This method tests greater than (for self and other) and is used by the > operator. Read more

1.0.0 · source

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

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

impl Serialize for DeviceId

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

Serialize this value into the given Serde serializer. Read more

impl ToOwned for DeviceId

type Owned = OwnedDeviceId

The resulting type after obtaining ownership.

fn to_owned(&self) -> Self::Owned

Creates owned data from borrowed data, usually by cloning. Read more

1.63.0 · source

fn clone_into(&self, target: &mut Self::Owned)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl Eq for DeviceId

impl StructuralEq for DeviceId

impl StructuralPartialEq for DeviceId

Auto Trait Implementations

impl RefUnwindSafe for DeviceId

impl Send for DeviceId

impl !Sized for DeviceId

impl Sync for DeviceId

impl Unpin for DeviceId

impl UnwindSafe for DeviceId

Blanket Implementations

impl<T> Any for T where
T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CallHasher for T where
T: Hash + ?Sized,

default fn get_hash<H, B>(value: &H, build_hasher: &B) -> u64 where
H: Hash + ?Sized,
B: BuildHasher,

impl<Q, K> Equivalent<K> for Q where
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.

impl<T> ToString for T where
T: Display + ?Sized,

default fn to_string(&self) -> String

Converts the given value to a String. Read more