Struct serenity::model::guild::Emoji

#[non_exhaustive]pub struct Emoji {
    pub animated: bool,
    pub id: EmojiId,
    pub name: String,
    pub managed: bool,
    pub require_colons: bool,
    pub roles: Vec<RoleId>,
}

Represents a custom guild emoji, which can either be created using the API, or via an integration. Emojis created using the API only work within the guild it was created in.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

animated: bool

Whether the emoji is animated.

id: EmojiId

The Id of the emoji.

name: String

The name of the emoji. It must be at least 2 characters long and can only contain alphanumeric characters and underscores.

managed: bool

Whether the emoji is managed via an Integration service.

require_colons: bool

Whether the emoji name needs to be surrounded by colons in order to be used by the client.

roles: Vec<RoleId>

A list of Roles that are allowed to use the emoji. If there are no roles specified, then usage is unrestricted.

Implementations

impl Emoji

pub async fn delete<T: AsRef<Cache> + AsRef<Http>>(
    &self,
    cache_http: T
) -> Result<()>

Deletes the emoji. This method requires the cache to fetch the guild ID.

Note: The Manage Emojis permission is required.

Note: Only user accounts may use this method.

Examples

Delete a given emoji:

// assuming emoji has been set already
match emoji.delete(&ctx).await {
    Ok(()) => println!("Emoji deleted."),
    Err(_) => println!("Could not delete emoji.")
}

pub async fn edit<T: AsRef<Cache> + AsRef<Http>>(
    &mut self,
    cache_http: T,
    name: &str
) -> Result<()>

Edits the emoji by updating it with a new name. This method requires the cache to fetch the guild ID.

Note: The Manage Emojis permission is required.

Note: Only user accounts may use this method.

pub async fn find_guild_id(&self, cache: impl AsRef<Cache>) -> Option<GuildId>

Finds the Guild that owns the emoji by looking through the Cache.

Examples

Print the guild id that owns this emoji:

// assuming emoji has been set already
if let Some(guild_id) = emoji.find_guild_id(&cache).await {
    println!("{} is owned by {}", emoji.name, guild_id);
}

pub fn url(&self) -> String

Generates a URL to the emoji's image.

Examples

Print the direct link to the given emoji:

// assuming emoji has been set already
println!("Direct link to emoji image: {}", emoji.url());

Trait Implementations

impl Clone for Emoji

pub fn clone(&self) -> Emoji

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Emoji

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Emoji

pub fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for Emoji

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

Formats the emoji into a string that will cause Discord clients to render the emoji.

This is in the format of either <:NAME:EMOJI_ID> for normal emojis, or <a:NAME:EMOJI_ID> for animated emojis.

impl From<&'_ Emoji> for Mention

pub fn from(value: &Emoji) -> Self

Performs the conversion.

impl<'a> From<&'a Emoji> for EmojiId

pub fn from(emoji: &Emoji) -> EmojiId

Gets the Id of an Emoji.

impl From<Emoji> for ReactionType

pub fn from(emoji: Emoji) -> ReactionType

Performs the conversion.

impl From<Emoji> for EmojiId

pub fn from(emoji: Emoji) -> EmojiId

Gets the Id of an Emoji.

impl Mentionable for Emoji

pub fn mention(&self) -> Mention

Creates a Mention that will be able to notify or create a link to the item.

impl Serialize for Emoji

pub fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.