Struct twilight_http::request::guild::create_guild_channel::CreateGuildChannel

pub struct CreateGuildChannel<'a> { /* fields omitted */ }

Create a new request to create a guild channel.

All fields are optional except for name. The minimum length of the name is 1 UTF-16 characters and the maximum is 100 UTF-16 characters.

Implementations

impl<'a> CreateGuildChannel<'a>

pub const fn bitrate(self, bitrate: u64) -> Self

Set the bitrate of the channel. Applicable to voice channels only.

pub const fn kind(self, kind: ChannelType) -> Self

Set the kind of channel.

pub const fn nsfw(self, nsfw: bool) -> Self

Set whether the channel is marked as NSFW.

pub const fn parent_id(self, parent_id: ChannelId) -> Self

If this is specified, and the parent ID is a ChannelType::CategoryChannel, create this channel as a child of the category channel.

pub const fn permission_overwrites(
    self,
    permission_overwrites: &'a [PermissionOverwrite]
) -> Self

Set the permission overwrites of a channel.

pub const fn position(self, position: u64) -> Self

Set the position of the channel.

Positions are numerical and zero-indexed. If you place a channel at position 2, channels 2-n will shift down one position and the initial channel will take its place.

pub const fn rate_limit_per_user(
    self,
    rate_limit_per_user: u64
) -> Result<Self, CreateGuildChannelError>

Set the number of seconds that a user must wait before before they are able to send another message.

The minimum is 0 and the maximum is 21600. Refer to the discord docs for more details. This is also known as “Slow Mode”.

Errors

Returns a CreateGuildChannelErrorType::RateLimitPerUserInvalid error type if the amount is greater than 21600.

pub fn topic(self, topic: &'a str) -> Result<Self, CreateGuildChannelError>

Set the topic.

The maximum length is 1024 UTF-16 characters. Refer to the discord docs for more details.

Errors

Returns a CreateGuildChannelErrorType::TopicInvalid error type if the topic length is too long.

pub const fn user_limit(self, user_limit: u64) -> Self

For voice channels, set the user limit.

Set to 0 for no limit. Limit can otherwise be between 1 and 99 inclusive. Refer to the discord docs for more details.

pub fn exec(self) -> ResponseFuture<GuildChannel>

Execute the request, returning a future resolving to a Response.

Trait Implementations

impl<'a> AuditLogReason<'a> for CreateGuildChannel<'a>

fn reason(self, reason: &'a str) -> Result<Self, AuditLogReasonError>