Struct serenity::model::guild::Emoji

pub struct Emoji {
    pub animated: bool,
    pub id: EmojiId,
    pub name: String,
    pub managed: bool,
    pub require_colons: bool,
    pub roles: Vec<RoleId>,
    // some fields omitted
}

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

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.

Methods

impl Emoji

pub fn delete<T>(&self, cache_and_http: T) -> Result<()> where
    T: AsRef<CacheRwLock> + AsRef<Http>, 

Deletes the emoji.

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) {
    Ok(()) => println!("Emoji deleted."),
    Err(_) => println!("Could not delete emoji.")
}

pub fn edit<T>(&mut self, cache_and_http: T, name: &str) -> Result<()> where
    T: AsRef<CacheRwLock> + AsRef<Http>, 

Edits the emoji by updating it with a new name.

Note: The Manage Emojis permission is required.

Note: Only user accounts may use this method.

pub fn find_guild_id(&self, cache: impl AsRef<CacheRwLock>) -> 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) {
    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

fn clone(&self) -> Emoji

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Emoji

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

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

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

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: <:NAME:EMOJI_ID>.

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

fn from(emoji: &Emoji) -> EmojiId

Gets the Id of an Emoji.

impl From<Emoji> for ReactionType

fn from(emoji: Emoji) -> ReactionType

Performs the conversion.

impl From<Emoji> for EmojiId

fn from(emoji: Emoji) -> EmojiId

Gets the Id of an Emoji.

impl Mentionable for Emoji

fn mention(&self) -> String

Creates a mentionable string, that will be able to notify and/or create a link to the item.

impl Serialize for Emoji

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

Serialize this value into the given Serde serializer.