Struct ruma_identifiers::EventId [−][src]
pub struct EventId { /* fields omitted */ }
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().as_ref(), "$h29iv0s8:example.com" ); // Room version 3 format assert_eq!( EventId::try_from("$acR1l0raoZnm60CBwAVgqbZqoO/mYU81xysh1u7XcJk").unwrap().as_ref(), "$acR1l0raoZnm60CBwAVgqbZqoO/mYU81xysh1u7XcJk" ); // Room version 4 format assert_eq!( EventId::try_from("$Rqnc-F-dvnEYJTyHq_iKxU2bZ1CI92-kuZq3a5lr5Zg").unwrap().as_ref(), "$Rqnc-F-dvnEYJTyHq_iKxU2bZ1CI92-kuZq3a5lr5Zg" );
Implementations
impl EventId
[src]
impl EventId
[src]pub fn new(server_name: &ServerName) -> Self
[src]
This is supported on crate feature rand
only.
pub fn new(server_name: &ServerName) -> Self
[src]rand
only.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.
Does not currently ever fail, but may fail in the future if the homeserver cannot be parsed parsed as a valid host.
impl EventId
[src]
impl EventId
[src]pub fn localpart(&self) -> &str
[src]
pub fn localpart(&self) -> &str
[src]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.
pub fn server_name(&self) -> Option<&ServerName>
[src]
pub fn server_name(&self) -> Option<&ServerName>
[src]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
impl<'de> Deserialize<'de> for EventId
[src]
impl<'de> Deserialize<'de> for EventId
[src]fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,
[src]
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,
[src]Deserialize this value from the given Serde deserializer. Read more
impl Ord for EventId
[src]
impl Ord for EventId
[src]impl PartialOrd<EventId> for EventId
[src]
impl PartialOrd<EventId> for EventId
[src]fn partial_cmp(&self, other: &Self) -> Option<Ordering>
[src]
fn partial_cmp(&self, other: &Self) -> Option<Ordering>
[src]This method returns an ordering between self
and other
values if one exists. Read more
#[must_use]fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]fn lt(&self, other: &Rhs) -> bool
1.0.0[src]This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]fn le(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]fn le(&self, other: &Rhs) -> bool
1.0.0[src]This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
impl Eq for EventId
[src]
Auto Trait Implementations
impl RefUnwindSafe for EventId
impl Send for EventId
impl Sync for EventId
impl Unpin for EventId
impl UnwindSafe for EventId
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
[src]type Owned = T
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn to_owned(&self) -> T
[src]Creates owned data from borrowed data, usually by cloning. Read more
pub fn clone_into(&self, target: &mut T)
[src]
pub fn clone_into(&self, target: &mut T)
[src]🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
pub fn vzip(self) -> V
impl<T> DeserializeOwned for T where
T: for<'de> Deserialize<'de>,
[src]
T: for<'de> Deserialize<'de>,