Struct twilight_model::guild::Role

source ·
pub struct Role {
    pub color: u32,
    pub hoist: bool,
    pub icon: Option<ImageHash>,
    pub id: Id<RoleMarker>,
    pub managed: bool,
    pub mentionable: bool,
    pub name: String,
    pub permissions: Permissions,
    pub position: i64,
    pub tags: Option<RoleTags>,
    pub unicode_emoji: Option<String>,
}

Fields§

§color: u32§hoist: bool§icon: Option<ImageHash>

Icon image hash.

Present if the guild has the ROLE_ICONS feature and if the role has one.

See Discord Docs/Image Formatting.

§id: Id<RoleMarker>§managed: bool§mentionable: bool§name: String§permissions: Permissions§position: i64§tags: Option<RoleTags>

Tags about the role.

§unicode_emoji: Option<String>

Icon unicode emoji.

Present if the guild has the ROLE_ICONS feature and if the role has one.

Trait Implementations§

Returns a copy of the value. Read more
Performs copy-assignment from source. Read more
Formats the value using the given formatter. Read more
Deserialize this value from the given Serde deserializer. Read more
Feeds this value into the given Hasher. Read more
Feeds a slice of this type into the given Hasher. Read more

Compare two roles to each other using their position and ID.

Roles are primarily ordered by their position in descending order. For example, a role with a position of 17 is considered a higher role than one with a position of 12.

Discord does not guarantee that role positions are positive, unique, or contiguous. When two or more roles have the same position then the order is based on the roles’ IDs in ascending order. For example, given two roles with positions of 10 then a role with an ID of 1 would be considered a higher role than one with an ID of 20.

Examples

Compare the position of two roles:

let role_a = Role {
    id: Id::new(123),
    position: 12,
    // ...
};
let role_b = Role {
    id: Id::new(456),
    position: 13,
    // ...
};
assert_eq!(Ordering::Less, role_a.cmp(&role_b));
assert_eq!(Ordering::Greater, role_b.cmp(&role_a));
assert_eq!(Ordering::Equal, role_a.cmp(&role_a));
assert_eq!(Ordering::Equal, role_b.cmp(&role_b));

Compare the position of two roles with the same position:

let role_a = Role {
    id: Id::new(123),
    position: 12,
};
let role_b = Role {
    id: Id::new(456),
    position: 12,
};
assert_eq!(Ordering::Less, role_a.cmp(&role_b));
assert_eq!(Ordering::Greater, role_b.cmp(&role_a));
assert_eq!(Ordering::Equal, role_a.cmp(&role_a));
assert_eq!(Ordering::Equal, role_b.cmp(&role_b));
Compares and returns the maximum of two values. Read more
Compares and returns the minimum of two values. Read more
Restrict a value to a certain interval. Read more
This method tests for self and other values to be equal, and is used by ==.
This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
This method returns an ordering between self and other values if one exists. Read more
This method tests less than (for self and other) and is used by the < operator. Read more
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
This method tests greater than (for self and other) and is used by the > operator. Read more
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
Serialize this value into the given Serde serializer. Read more

Auto Trait Implementations§

Blanket Implementations§

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.
Creates owned data from borrowed data, usually by cloning. Read more
Uses borrowed data to replace owned data, usually by cloning. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more