Struct UpdateChannel

pub struct UpdateChannel<'a> { /* private fields */ }

Update a channel.

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

Implementations

impl<'a> UpdateChannel<'a>

pub fn available_tags(self, available_tags: &'a [ForumTag]) -> Self

Set the available tags for the forum.

pub fn bitrate(self, bitrate: u32) -> Self

For voice and stage channels, set the bitrate of the channel.

Must be at least 8000.

Errors

Returns an error of type BitrateInvalid if the bitrate is invalid.

pub fn default_forum_layout(self, default_forum_layout: ForumLayout) -> Self

Set the default layout for forum channels.

pub fn default_reaction_emoji( self, default_reaction_emoji: Option<&'a DefaultReaction>, ) -> Self

Set the default reaction emoji for new forum threads.

pub fn default_sort_order( self, default_sort_order: Option<ForumSortOrder>, ) -> Self

Set the default sort order for forum channels.

pub fn default_thread_rate_limit_per_user( self, default_thread_rate_limit_per_user: Option<u16>, ) -> Self

Set the default number of seconds that a user must wait before before they are able to send another message in new forum threads.

The minimum is 0 and the maximum is 21600. This is also known as “Slow Mode”. See Discord Docs/Channel Object.

Errors

Returns an error of type RateLimitPerUserInvalid if the limit is invalid.

pub fn flags(self, flags: ChannelFlags) -> Self

Set the flags of the channel, if supported.

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

Set the forum topic.

The maximum length is 4096 UTF-16 characters. See Discord Docs/Channel Object.

Errors

Returns an error of type ForumTopicInvalid if the channel type is GuildForum and the topic is invalid.

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

Set the name.

The minimum length is 1 UTF-16 character and the maximum is 100 UTF-16 characters.

Errors

Returns an error of type NameInvalid if the name is invalid.

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

Set whether the channel is marked as NSFW.

pub fn parent_id(self, parent_id: Option<Id<ChannelMarker>>) -> Self

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

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

Set the permission overwrites of a channel. This will overwrite all permissions that the channel currently has, so use with caution!

pub 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 fn rate_limit_per_user(self, rate_limit_per_user: u16) -> Self

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. This is also known as “Slow Mode”. See Discord Docs/Channel Object.

Errors

Returns an error of type RateLimitPerUserInvalid if the limit is invalid.

pub fn rtc_region(self, rtc_region: Option<&'a str>) -> Self

For voice and stage channels, set the channel’s RTC region.

Set to None to clear.

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

Set the topic.

The maximum length is 1024 UTF-16 characters. See Discord Docs/Channel Object.

Errors

Returns an error of type TopicInvalid if the topic is invalid.

pub fn user_limit(self, user_limit: u16) -> Self

For voice channels, set the user limit.

Set to 0 for no limit. Limit can otherwise be between 1 and 99 inclusive. See Discord Docs/Modify Channel.

Errors

Returns an error of type UserLimitInvalid if the bitrate is invalid.

pub fn video_quality_mode(self, video_quality_mode: VideoQualityMode) -> Self

Set the VideoQualityMode for the voice channel.

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

Set the kind of channel.

Only conversion between ChannelType::GuildText and ChannelType::GuildAnnouncement is possible, and only if the guild has the NEWS feature enabled. See Discord Docs/Modify Channel.

Trait Implementations

impl<'a> AuditLogReason<'a> for UpdateChannel<'a>

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

Attach an audit log reason to the request.

impl IntoFuture for UpdateChannel<'_>

type Output = Result<Response<Channel>, Error>

The output that the future will produce on completion.

type IntoFuture = ResponseFuture<Channel>

Which kind of future are we turning this into?

fn into_future(self) -> Self::IntoFuture

Creates a future from a value.

impl TryIntoRequest for UpdateChannel<'_>

fn try_into_request(self) -> Result<Request, Error>

Try to convert a request builder into a raw Request.