[−][src]Struct ruma_identifiers::EventId
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().to_string(), "$h29iv0s8:example.com" ); // Room version 3 format assert_eq!( EventId::try_from("$acR1l0raoZnm60CBwAVgqbZqoO/mYU81xysh1u7XcJk").unwrap().to_string(), "$acR1l0raoZnm60CBwAVgqbZqoO/mYU81xysh1u7XcJk" ); // Room version 4 format assert_eq!( EventId::try_from("$Rqnc-F-dvnEYJTyHq_iKxU2bZ1CI92-kuZq3a5lr5Zg").unwrap().to_string(), "$Rqnc-F-dvnEYJTyHq_iKxU2bZ1CI92-kuZq3a5lr5Zg" );
Methods
impl EventId
[src]
pub fn new(homeserver_host: &str) -> Result<Self, Error>
[src]
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.
Fails if the homeserver cannot be parsed as a valid host.
pub fn hostname(&self) -> Option<&Host>
[src]
Returns a Host
for the event ID, containing the server name (minus the port) of the
originating homeserver. Only applicable to events in the original format as used by Matrix
room versions 1 and 2.
The host can be either a domain name, an IPv4 address, or an IPv6 address.
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 port(&self) -> Option<u16>
[src]
Returns the port the originating homeserver can be accessed on. Only applicable to events in the original format as used by Matrix room versions 1 and 2.
Trait Implementations
impl Clone for EventId
[src]
fn clone(&self) -> EventId
[src]
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl PartialEq<EventId> for EventId
[src]
impl Eq for EventId
[src]
impl Hash for EventId
[src]
fn hash<__H: Hasher>(&self, state: &mut __H)
[src]
fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
Feeds a slice of this type into the given [Hasher
]. Read more
impl Display for EventId
[src]
impl Debug for EventId
[src]
impl<'a> TryFrom<&'a str> for EventId
[src]
type Error = Error
The type returned in the event of a conversion error.
fn try_from(event_id: &'a str) -> Result<Self, Self::Error>
[src]
Attempts to create a new Matrix event ID from a string representation.
If using the original event format as used by Matrix room versions 1 and 2, the string must include the leading $ sigil, the localpart, a literal colon, and a valid homeserver hostname.
impl Serialize for EventId
[src]
impl<'de> Deserialize<'de> for EventId
[src]
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,
[src]
D: Deserializer<'de>,
Auto Trait Implementations
Blanket Implementations
impl<T> From<T> for T
[src]
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToString for T where
T: Display + ?Sized,
[src]
T: Display + ?Sized,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> DeserializeOwned for T where
T: Deserialize<'de>,
[src]
T: Deserialize<'de>,