Struct ruma_common::user_id::UserId
source · pub struct UserId(/* private fields */);
Expand description
A Matrix user ID.
A UserId
is generated randomly or converted from a string slice, and can be converted back
into a string as needed.
assert_eq!(<&UserId>::try_from("@carl:example.com").unwrap(), "@carl:example.com");
Implementations§
source§impl UserId
impl UserId
sourcepub fn parse(s: impl AsRef<str>) -> Result<OwnedUserId, IdParseError>
pub fn parse(s: impl AsRef<str>) -> Result<OwnedUserId, IdParseError>
Try parsing a &str
into an OwnedUserId
.
The same can also be done using FromStr
, TryFrom
or TryInto
.
This function is simply more constrained and thus useful in generic contexts.
sourcepub fn parse_box(
s: impl AsRef<str> + Into<Box<str>>,
) -> Result<Box<Self>, IdParseError>
pub fn parse_box( s: impl AsRef<str> + Into<Box<str>>, ) -> Result<Box<Self>, IdParseError>
Try parsing a &str
into a Box<UserId>
.
The same can also be done using FromStr
, TryFrom
or TryInto
.
This function is simply more constrained and thus useful in generic contexts.
source§impl UserId
impl UserId
sourcepub fn new(server_name: &ServerName) -> OwnedUserId
Available on crate feature rand
only.
pub fn new(server_name: &ServerName) -> OwnedUserId
rand
only.Attempts to generate a UserId
for the given origin server with a localpart consisting of
12 random ASCII characters.
sourcepub fn parse_with_server_name(
id: impl AsRef<str> + Into<Box<str>>,
server_name: &ServerName,
) -> Result<OwnedUserId, IdParseError>
pub fn parse_with_server_name( id: impl AsRef<str> + Into<Box<str>>, server_name: &ServerName, ) -> Result<OwnedUserId, IdParseError>
Attempts to complete a user ID, by adding the colon + server name and @
prefix, if not
present already.
This is a convenience function for the login API, where a user can supply either their full
user ID or just the localpart. It only supports a valid user ID or a valid user ID
localpart, not the localpart plus the @
prefix, or the localpart plus server name without
the @
prefix.
sourcepub fn parse_with_server_name_rc(
id: impl AsRef<str> + Into<Rc<str>>,
server_name: &ServerName,
) -> Result<Rc<Self>, IdParseError>
pub fn parse_with_server_name_rc( id: impl AsRef<str> + Into<Rc<str>>, server_name: &ServerName, ) -> Result<Rc<Self>, IdParseError>
Variation of parse_with_server_name
that returns Rc<Self>
.
sourcepub fn parse_with_server_name_arc(
id: impl AsRef<str> + Into<Arc<str>>,
server_name: &ServerName,
) -> Result<Arc<Self>, IdParseError>
pub fn parse_with_server_name_arc( id: impl AsRef<str> + Into<Arc<str>>, server_name: &ServerName, ) -> Result<Arc<Self>, IdParseError>
Variation of parse_with_server_name
that returns Arc<Self>
.
sourcepub fn server_name(&self) -> &ServerName
pub fn server_name(&self) -> &ServerName
Returns the server name of the user ID.
sourcepub fn is_historical(&self) -> bool
pub fn is_historical(&self) -> bool
Whether this user ID is a historical one.
A historical user ID is one that doesn’t conform to the latest specification of the user ID grammar but is still accepted because it was previously allowed.
sourcepub fn matrix_to_uri(&self) -> MatrixToUri
pub fn matrix_to_uri(&self) -> MatrixToUri
Create a matrix.to
URI for this user ID.
§Example
use ruma_common::user_id;
let message = format!(
r#"Thanks for the update <a href="{link}">{display_name}</a>."#,
link = user_id!("@jplatte:notareal.hs").matrix_to_uri(),
display_name = "jplatte",
);
sourcepub fn matrix_uri(&self, chat: bool) -> MatrixUri
pub fn matrix_uri(&self, chat: bool) -> MatrixUri
Create a matrix:
URI for this user ID.
If chat
is true
, a click on the URI should start a direct message
with the user.
§Example
use ruma_common::user_id;
let message = format!(
r#"Thanks for the update <a href="{link}">{display_name}</a>."#,
link = user_id!("@jplatte:notareal.hs").matrix_uri(false),
display_name = "jplatte",
);
Trait Implementations§
source§impl AsRef<UserId> for OwnedUserId
impl AsRef<UserId> for OwnedUserId
source§impl Borrow<UserId> for OwnedUserId
impl Borrow<UserId> for OwnedUserId
source§impl<'de> Deserialize<'de> for Box<UserId>
impl<'de> Deserialize<'de> for Box<UserId>
source§fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where
D: Deserializer<'de>,
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where
D: Deserializer<'de>,
source§impl From<&UserId> for OwnedUserId
impl From<&UserId> for OwnedUserId
source§fn from(id: &UserId) -> OwnedUserId
fn from(id: &UserId) -> OwnedUserId
source§impl PartialEq<&UserId> for OwnedUserId
impl PartialEq<&UserId> for OwnedUserId
source§impl PartialEq<OwnedUserId> for &UserId
impl PartialEq<OwnedUserId> for &UserId
source§impl PartialEq<OwnedUserId> for UserId
impl PartialEq<OwnedUserId> for UserId
source§impl PartialEq<UserId> for OwnedUserId
impl PartialEq<UserId> for OwnedUserId
source§impl PartialOrd for UserId
impl PartialOrd for UserId
source§impl ToOwned for UserId
impl ToOwned for UserId
source§type Owned = OwnedUserId
type Owned = OwnedUserId
source§fn to_owned(&self) -> Self::Owned
fn to_owned(&self) -> Self::Owned
1.63.0 · source§fn clone_into(&self, target: &mut Self::Owned)
fn clone_into(&self, target: &mut Self::Owned)
impl Eq for UserId
impl StructuralPartialEq for UserId
Auto Trait Implementations§
impl Freeze for UserId
impl RefUnwindSafe for UserId
impl Send for UserId
impl !Sized for UserId
impl Sync for UserId
impl Unpin for UserId
impl UnwindSafe for UserId
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<Q, K> Comparable<K> for Q
impl<Q, K> Comparable<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.