kord-core/dev.kord.core.entity.channel/TopGuildChannel

TopGuildChannel

interface TopGuildChannel : GuildChannel, TopGuildChannelBehavior(source)

An instance of a Discord channel associated to a guild.

Inheritors

CategorizableChannel

Properties

abstract val data: ChannelData

open val flags: ChannelFlags?

The flags of this channel, if present.

open val guild: GuildBehavior

The guild behavior this channel is associated to.

open override val guildId: Snowflake

The id of the guild this channel is associated to.

open override val id: Snowflake

The unique identifier of this entity.

abstract val kord: Kord

The kord instance that created this object.

open val mention: String

This channel formatted as a mention as used by the Discord API.

open val name: String

The name of this channel.

permissionOverwrites

open val permissionOverwrites: Set<PermissionOverwriteEntity>

The permission overwrites for this channel.

open val rawPosition: Int

The raw position of this channel in the guild as displayed by Discord.

abstract val supplier: EntitySupplier

The supplier used to request entities.

open val type: ChannelType

The type of this channel.

Functions

open suspend fun addOverwrite(overwrite: PermissionOverwrite, reason: String? = null)

Requests to add or replace a PermissionOverwrite to this entity.

open suspend fun asChannel(): Channel

Requests to get this behavior as a Channel .

inline suspend fun <T : Channel> ChannelBehavior.asChannelOf(): T

Requests to get the Channel represented by this ChannelBehavior.

asChannelOfOrNull

inline suspend fun <T : Channel> ChannelBehavior.asChannelOfOrNull(): T?

Requests to get the Channel represented by this ChannelBehavior, returns null if the Channel isn't present.

asChannelOrNull

open suspend fun asChannelOrNull(): Channel?

Requests to get this behavior as a Channel, returns null if the channel isn't present.

open operator override fun compareTo(other: Entity): Int

Compares entities on id.

open suspend fun delete(reason: String? = null)

Requests to delete a channel (or close it if this is a dm channel).

editMemberPermission

inline suspend fun TopGuildChannelBehavior.editMemberPermission(memberId: Snowflake, builder: ChannelPermissionModifyBuilder.() -> Unit)

Requests to add or replace a PermissionOverwrite for the memberId.

editRolePermission

inline suspend fun TopGuildChannelBehavior.editRolePermission(roleId: Snowflake, builder: ChannelPermissionModifyBuilder.() -> Unit)

Requests to add or replace a PermissionOverwrite for the roleId.

open suspend fun fetchChannel(): Channel

Retrieve the Channel associated with this behaviour from the provided EntitySupplier

fetchChannelOrNull

open suspend fun fetchChannelOrNull(): Channel?

Retrieve the Channel associated with this behaviour from the provided EntitySupplier returns null if the Channel isn't present.

getEffectivePermissions

open suspend fun getEffectivePermissions(memberId: Snowflake): Permissions

Calculates the effective permissions of the memberId in this channel, applying the overwrite for the member and their roles on top of the base permissions.

open suspend fun getGuild(): Guild

Requests to get this channel's Guild.

open suspend fun getGuildOrNull(): Guild?

Requests to get this channel's Guild, returns null if the guild isn't present.

getPermissionOverwritesForMember

open fun getPermissionOverwritesForMember(memberId: Snowflake): PermissionOverwriteEntity?

Gets the permission overwrite for the memberId in this channel, if present.

getPermissionOverwritesForRole

open fun getPermissionOverwritesForRole(roleId: Snowflake): PermissionOverwriteEntity?

Gets the permission overwrite for the roleId in this channel, if present.

open suspend fun getPosition(): Int

Requests to get the position of this channel in the guild, as displayed in Discord.

fun Channel.live(coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)): LiveChannel

fun TopGuildChannel.live(coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)): LiveGuildChannel

inline fun Channel.live(coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job), block: LiveChannel.() -> Unit): LiveChannel

inline fun TopGuildChannel.live(coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job), block: LiveGuildChannel.() -> Unit): LiveGuildChannel

abstract override fun withStrategy(strategy: EntitySupplyStrategy<*>): TopGuildChannel

Returns a new Channel with the given strategy.