Struct Role

#[non_exhaustive]
pub struct Role {
    pub id: RoleId,
    pub guild_id: GuildId,
    pub colour: Colour,
    pub hoist: bool,
    pub managed: bool,
    pub mentionable: bool,
    pub name: String,
    pub permissions: Permissions,
    pub position: u16,
    pub tags: RoleTags,
    pub icon: Option<ImageHash>,
    pub unicode_emoji: Option<String>,
}

Information about a role within a guild.

A role represents a set of permissions, and can be attached to one or multiple users. A role has various miscellaneous configurations, such as being assigned a colour. Roles are unique per guild and do not cross over to other guilds in any way, and can have channel-specific permission overrides in addition to guild-level permissions.

Discord docs.

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.

id: RoleId

The Id of the role. Can be used to calculate the role’s creation date.

guild_id: GuildId

The Id of the Guild the Role is in.

colour: Colour

The colour of the role.

hoist: bool

Indicator of whether the role is pinned above lesser roles.

In the client, this causes Members in the role to be seen above those in roles with a lower Self::position.

managed: bool

Indicator of whether the role is managed by an integration service.

mentionable: bool

Indicator of whether the role can be mentioned, similar to mentioning a specific member or @everyone.

Only members of the role will be notified if a role is mentioned with this set to true.

name: String

The name of the role.

permissions: Permissions

A set of permissions that the role has been assigned.

See the permissions module for more information.

position: u16

The role’s position in the position list. Roles are considered higher in hierarchy if their position is higher.

The @everyone role is usually either -1 or 0.

tags: RoleTags

The tags this role has. It can be used to determine if this role is a special role in this guild such as guild subscriber role, or if the role is linked to an Integration or a bot.

icon: Option<ImageHash>

Role icon image hash.

unicode_emoji: Option<String>

Role unicoded image.

Implementations

impl Role

pub async fn delete(&mut self, http: impl AsRef<Http>) -> Result<()>

Deletes the role.

Note Requires the Manage Roles permission.

Errors

Returns Error::Http if the current user lacks permission to delete this role.

pub async fn edit( &mut self, http: impl AsRef<Http>, builder: EditRole<'_>, ) -> Result<()>

Edits a Role, optionally setting its new fields.

Requires the Manage Roles permission.

Examples

See the documentation of EditRole for details.

Errors

Returns Error::Http if the current user does not have permission to Manage Roles.

pub fn has_permission(&self, permission: Permissions) -> bool

Check that the role has the given permission.

pub fn has_permissions(&self, permissions: Permissions, precise: bool) -> bool

Checks whether the role has all of the given permissions.

The ‘precise’ argument is used to check if the role’s permissions are precisely equivalent to the given permissions. If you need only check that the role has at least the given permissions, pass false.

pub fn icon_url(&self) -> Option<String>

Generates a URL to the Role icon’s image.

Trait Implementations

impl ArgumentConvert for Role

Look up a Role by a string case-insensitively.

Requires the cache feature to be enabled.

The lookup strategy is as follows (in order):

1. Lookup by ID
2. Lookup by mention.
3. Lookup by name (case-insensitive)

type Err = RoleParseError

The associated error which can be returned from parsing.

fn convert<'life0, 'async_trait>( ctx: impl 'async_trait + CacheHttp, guild_id: Option<GuildId>, _channel_id: Option<ChannelId>, s: &'life0 str, ) -> Pin<Box<dyn Future<Output = Result<Self, Self::Err>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Parses a string s as a command parameter of this type.

impl Clone for Role

fn clone(&self) -> Role

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Role

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

Formats the value using the given formatter.

impl Default for Role

fn default() -> Role

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Role

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Role

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

Format a mention for the role, pinging its members.

impl From<&Role> for RoleId

fn from(role: &Role) -> RoleId

Gets the Id of a role.

impl From<Role> for RoleId

fn from(role: Role) -> RoleId

Gets the Id of a role.

impl Mentionable for Role

fn mention(&self) -> Mention

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

impl Ord for Role

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Role

fn eq(&self, other: &Role) -> 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 Role

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Role