Struct serenity::builder::EditRole

pub struct EditRole(pub VecMap<&'static str, Value>);

A builder to create or edit a Role for use via a number of model methods.

These are:

• PartialGuild::create_role
• Guild::create_role
• Guild::edit_role
• GuildId::create_role
• GuildId::edit_role
• Role::edit

Defaults are provided for each parameter on role creation.

Examples

Create a hoisted, mentionable role named "a test role":

// assuming a `channel_id` and `guild_id` has been bound

let role = guild_id.create_role(|r| r
    .hoist(true)
    .mentionable(true)
    .name("a test role"));

Methods

impl EditRole

pub fn new(role: &Role) -> Self

Creates a new builder with the values of the given Role.

pub fn colour(self, colour: u64) -> Self

Sets the colour of the role.

pub fn hoist(self, hoist: bool) -> Self

Whether or not to hoist the role above lower-positioned role in the user list.

pub fn mentionable(self, mentionable: bool) -> Self

Whether or not to make the role mentionable, notifying its users.

pub fn name(self, name: &str) -> Self

The name of the role to set.

pub fn permissions(self, permissions: Permissions) -> Self

The set of permissions to assign the role.

pub fn position(self, position: u8) -> Self

The position to assign the role in the role list. This correlates to the role's position in the user list.

Trait Implementations

impl Default for EditRole

fn default() -> EditRole

Returns the "default value" for a type.

impl Clone for EditRole

fn clone(&self) -> EditRole

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for EditRole

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

Formats the value using the given formatter.