Struct ruma::EventId

source ·
pub struct EventId(/* private fields */);
Expand description

A Matrix event ID.

An EventId is generated randomly or converted from a string slice, and can be converted back into a string as needed.

§Room versions

Matrix specifies multiple room versions and the format of event identifiers differ between them. The original format used by room versions 1 and 2 uses a short pseudorandom “localpart” followed by the hostname and port of the originating homeserver. Later room versions change event identifiers to be a hash of the event encoded with Base64. Some of the methods provided by EventId are only relevant to the original event format.

// Original format
assert_eq!(<&EventId>::try_from("$h29iv0s8:example.com").unwrap(), "$h29iv0s8:example.com");
// Room version 3 format
assert_eq!(
    <&EventId>::try_from("$acR1l0raoZnm60CBwAVgqbZqoO/mYU81xysh1u7XcJk").unwrap(),
    "$acR1l0raoZnm60CBwAVgqbZqoO/mYU81xysh1u7XcJk"
);
// Room version 4 format
assert_eq!(
    <&EventId>::try_from("$Rqnc-F-dvnEYJTyHq_iKxU2bZ1CI92-kuZq3a5lr5Zg").unwrap(),
    "$Rqnc-F-dvnEYJTyHq_iKxU2bZ1CI92-kuZq3a5lr5Zg"
);

Implementations§

source§

impl EventId

source

pub fn as_str(&self) -> &str

Creates a string slice from this EventId.

source

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

Creates a byte slice from this EventId.

source§

impl EventId

source

pub fn parse(s: impl AsRef<str>) -> Result<OwnedEventId, Error>

Try parsing a &str into an OwnedEventId.

The same can also be done using FromStr, TryFrom or TryInto. This function is simply more constrained and thus useful in generic contexts.

source

pub fn parse_box( s: impl AsRef<str> + Into<Box<str>>, ) -> Result<Box<EventId>, Error>

Try parsing a &str into a Box<EventId>.

The same can also be done using FromStr, TryFrom or TryInto. This function is simply more constrained and thus useful in generic contexts.

source

pub fn parse_rc( s: impl AsRef<str> + Into<Rc<str>>, ) -> Result<Rc<EventId>, Error>

Try parsing a &str into an Rc<EventId>.

source

pub fn parse_arc( s: impl AsRef<str> + Into<Arc<str>>, ) -> Result<Arc<EventId>, Error>

Try parsing a &str into an Arc<EventId>.

source§

impl EventId

source

pub fn new(server_name: &ServerName) -> OwnedEventId

Attempts to generate an EventId for the given origin server with a localpart consisting of 18 random ASCII characters.

This should only be used for events in the original format as used by Matrix room versions 1 and 2.

source

pub fn localpart(&self) -> &str

Returns the event’s unique ID.

For the original event format as used by Matrix room versions 1 and 2, this is the “localpart” that precedes the homeserver. For later formats, this is the entire ID without the leading $ sigil.

source

pub fn server_name(&self) -> Option<&ServerName>

Returns the server name of the event ID.

Only applicable to events in the original format as used by Matrix room versions 1 and 2.

Trait Implementations§

source§

impl AsRef<[u8]> for EventId

source§

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

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

impl AsRef<EventId> for EventId

source§

fn as_ref(&self) -> &EventId

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

impl AsRef<EventId> for OwnedEventId

source§

fn as_ref(&self) -> &EventId

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

impl AsRef<str> for EventId

source§

fn as_ref(&self) -> &str

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

impl Borrow<EventId> for OwnedEventId

source§

fn borrow(&self) -> &EventId

Immutably borrows from an owned value. Read more
source§

impl Clone for Box<EventId>

source§

fn clone(&self) -> Box<EventId>

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
source§

impl Debug for EventId

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

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

Deserialize this value from the given Serde deserializer. Read more
source§

impl Display for EventId

source§

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

Formats the value using the given formatter. Read more
source§

impl From<&EventId> for Arc<EventId>

source§

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

Converts to this type from the input type.
source§

impl From<&EventId> for Box<EventId>

source§

fn from(id: &EventId) -> Box<EventId>

Converts to this type from the input type.
source§

impl From<&EventId> for OwnedEventId

source§

fn from(id: &EventId) -> OwnedEventId

Converts to this type from the input type.
source§

impl From<&EventId> for Rc<EventId>

source§

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

Converts to this type from the input type.
source§

impl From<&EventId> for String

source§

fn from(id: &EventId) -> String

Converts to this type from the input type.
source§

impl From<OwnedEventId> for Box<EventId>

source§

fn from(a: OwnedEventId) -> Box<EventId>

Converts to this type from the input type.
source§

impl Hash for EventId

source§

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

Feeds this value into the given Hasher. Read more
source§

impl Ord for EventId

source§

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

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

impl PartialEq<&EventId> for OwnedEventId

source§

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

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

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.
source§

impl PartialEq<&str> for EventId

source§

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

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

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.
source§

impl PartialEq<Box<EventId>> for &EventId

source§

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

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

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.
source§

impl PartialEq<Box<EventId>> for EventId

source§

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

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

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.
source§

impl PartialEq<EventId> for &str

source§

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

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

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.
source§

impl PartialEq<EventId> for OwnedEventId

source§

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

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

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.
source§

impl PartialEq<EventId> for str

source§

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

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

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.
source§

impl PartialEq<OwnedEventId> for &EventId

source§

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

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

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.
source§

impl PartialEq<OwnedEventId> for EventId

source§

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

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

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.
source§

impl PartialEq<String> for EventId

source§

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

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

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.
source§

impl PartialEq<str> for EventId

source§

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

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

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.
source§

impl PartialEq for EventId

source§

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

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

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.
source§

impl PartialOrd for EventId

source§

fn partial_cmp(&self, other: &EventId) -> 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
source§

impl Serialize for EventId

source§

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. Read more
source§

impl ToOwned for EventId

§

type Owned = OwnedEventId

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> <EventId as ToOwned>::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
source§

impl<'a> TryFrom<&'a str> for &'a EventId

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from( s: &'a str, ) -> Result<&'a EventId, <&'a EventId as TryFrom<&'a str>>::Error>

Performs the conversion.
source§

impl TryFrom<&str> for Box<EventId>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from( s: &str, ) -> Result<Box<EventId>, <Box<EventId> as TryFrom<&str>>::Error>

Performs the conversion.
source§

impl TryFrom<String> for Box<EventId>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from( s: String, ) -> Result<Box<EventId>, <Box<EventId> as TryFrom<String>>::Error>

Performs the conversion.
source§

impl Eq for EventId

source§

impl StructuralPartialEq for EventId

Auto Trait Implementations§

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

source§

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

Mutably borrows from an owned value. Read more
source§

impl<Q, K> Comparable<K> for Q
where Q: Ord + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn compare(&self, key: &K) -> Ordering

Compare self to key and return their ordering.
source§

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

source§

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

Checks if this value is equivalent to the given key. Read more
source§

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

source§

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

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

impl<T, W> HasTypeWitness<W> for T
where W: MakeTypeWitness<Arg = T>, T: ?Sized,

source§

const WITNESS: W = W::MAKE

A constant of the type witness
source§

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

§

type Type = T

The same type as Self, used to emulate type equality bounds (T == U) with associated type equality constraints (T: Identity<Type = U>).
source§

const TYPE_EQ: TypeEq<T, <T as Identity>::Type> = TypeEq::NEW

Proof that Self is the same type as Self::Type, provides methods for casting between Self and Self::Type.
source§

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

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more