Struct RoomOrAliasId 

pub struct RoomOrAliasId(/* private fields */);

A Matrix room ID or a Matrix room alias ID.

RoomOrAliasId is useful for APIs that accept either kind of room identifier. It is converted from a string slice, and can be converted back into a string as needed. When converted from a string slice, the variant is determined by the leading sigil character.

assert_eq!(<&RoomOrAliasId>::try_from("#ruma:example.com").unwrap(), "#ruma:example.com");

assert_eq!(
    <&RoomOrAliasId>::try_from("!n8f893n9:example.com").unwrap(),
    "!n8f893n9:example.com"
);

It can be converted to a RoomId or a RoomAliasId using ::try_from() / .try_into(). For example, <&RoomId>::try_from(room_or_alias_id) returns either Ok(room_id) or Err(room_alias_id).

Implementations

impl RoomOrAliasId

pub fn as_str(&self) -> &str

Available on crate feature events only.

Extracts a string slice from this RoomOrAliasId.

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

Available on crate feature events only.

Extracts a byte slice from this RoomOrAliasId.

impl RoomOrAliasId

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

Available on crate feature events only.

Try parsing a &str into an OwnedRoomOrAliasId.

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

impl RoomOrAliasId

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

Available on crate feature events only.

Returns the server name of the room (alias) ID.

pub fn is_room_id(&self) -> bool

Available on crate feature events only.

Whether this is a room id (starts with '!')

pub fn is_room_alias_id(&self) -> bool

Available on crate feature events only.

Whether this is a room alias id (starts with '#')

Trait Implementations

impl AsRef<[u8]> for RoomOrAliasId

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

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

impl AsRef<RoomOrAliasId> for OwnedRoomOrAliasId

fn as_ref(&self) -> &RoomOrAliasId

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

impl AsRef<RoomOrAliasId> for RoomOrAliasId

fn as_ref(&self) -> &RoomOrAliasId

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

impl AsRef<str> for RoomOrAliasId

fn as_ref(&self) -> &str

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

impl Borrow<RoomOrAliasId> for OwnedRoomOrAliasId

fn borrow(&self) -> &RoomOrAliasId

Immutably borrows from an owned value.

impl Debug for RoomOrAliasId

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

Formats the value using the given formatter.

impl Display for RoomOrAliasId

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

Formats the value using the given formatter.

impl<'a> From<&'a RoomAliasId> for &'a RoomOrAliasId

fn from(room_alias_id: &'a RoomAliasId) -> &'a RoomOrAliasId

Converts to this type from the input type.

impl<'a> From<&'a RoomId> for &'a RoomOrAliasId

fn from(room_id: &'a RoomId) -> &'a RoomOrAliasId

Converts to this type from the input type.

impl From<&RoomOrAliasId> for OwnedRoomOrAliasId

fn from(id: &RoomOrAliasId) -> OwnedRoomOrAliasId

Converts to this type from the input type.

impl From<&RoomOrAliasId> for String

fn from(id: &RoomOrAliasId) -> String

Converts to this type from the input type.

impl Hash for RoomOrAliasId

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

where __H: Hasher,

Feeds this value into the given Hasher.

impl Ord for RoomOrAliasId

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

This method returns an Ordering between self and other.

impl PartialEq<&RoomOrAliasId> for OwnedRoomOrAliasId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<&str> for RoomOrAliasId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> PartialEq<Cow<'a, str>> for RoomOrAliasId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<OwnedRoomOrAliasId> for &RoomOrAliasId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<OwnedRoomOrAliasId> for RoomOrAliasId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<RoomOrAliasId> for &str

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<RoomOrAliasId> for OwnedRoomOrAliasId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<RoomOrAliasId> for str

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<String> for RoomOrAliasId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<str> for RoomOrAliasId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for RoomOrAliasId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for RoomOrAliasId

fn partial_cmp(&self, other: &RoomOrAliasId) -> 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 Serialize for RoomOrAliasId

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 ToOwned for RoomOrAliasId

type Owned = OwnedRoomOrAliasId

The resulting type after obtaining ownership.

fn to_owned(&self) -> <RoomOrAliasId as ToOwned>::Owned

Creates owned data from borrowed data, usually by cloning.

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

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

impl<'a> TryFrom<&'a RoomOrAliasId> for &'a RoomAliasId

type Error = &'a RoomId

The type returned in the event of a conversion error.

fn try_from(id: &'a RoomOrAliasId) -> Result<&'a RoomAliasId, &'a RoomId>

Performs the conversion.

impl<'a> TryFrom<&'a RoomOrAliasId> for &'a RoomId

type Error = &'a RoomAliasId

The type returned in the event of a conversion error.

fn try_from(id: &'a RoomOrAliasId) -> Result<&'a RoomId, &'a RoomAliasId>

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Eq for RoomOrAliasId

impl StructuralPartialEq for RoomOrAliasId