crux_structs v0.2.2 Crux.Structs.Channel View Source

Represents a Discord Channel Object.

List of where every property can be present:

Property	Text (0)	DM (1)	Voice (2)	Group (3)	Category (4)	News (5)
application_id	no	no	no	yes	no	no
bitrate	no	no	yes	no	no	no
guild_id	yes	no	yes	no	yes	yes
icon	no	no	no	yes	no	no
id	yes	yes	yes	yes	yes	yes
last_message_id	yes	yes	no	yes	no	yes
last_pin_timestamp	yes	yes	no	yes	no	yes
name	yes	no	yes	yes	yes	yes
nsfw	yes	no	no	no	no	yes
owner_id	no	no	no	yes	no	no
parent_id	yes	no	yes	no	no	yes
permission_overwrites	yes	no	yes	no	yes	yes
position	yes	no	yes	no	yes	yes
rate_limit_per_user	yes	no	no	no	no	no
recipients	no	yes (One Element)	no	yes	no	no
topic	yes	no	yes	no	yes	yes
type	`0`	`1`	`2`	`3`	`4`	`5`
user_limit	no	no	yes	no	no	no

Differences opposed to the Discord API Object:

:recipients is a MapSet of user ids

Link to this section Summary

Types

id_resolvable()

All available types that can be resolved into a channel id.

position_resolvable()

All available types that can be resolved into a channel position.

t()

Functions

create(data)

Creates a Crux.Structs.Channel.t/0 struct from raw data.

resolve_id(resolvable)

Resolves the id of a Crux.Structs.Channel.t/0.

resolve_position(resolvable)

Resolves a position_resolvable/0 into a channel position.

to_mention(channel)

Converts a Crux.Structs.Channel.t/0 into its discord mention format.

Link to this section Types

id_resolvable() (since 0.2.1)

id_resolvable() ::
  Crux.Structs.Message.t()
  | Crux.Structs.Channel.t()
  | Crux.Structs.Snowflake.t()
  | String.t()

All available types that can be resolved into a channel id.

position_resolvable() (since 0.2.1)

position_resolvable() ::
  Crux.Structs.Channel.t()
  | %{channel: id_resolvable(), position: integer()}
  | {id_resolvable(), integer()}
  | %{id: id_resolvable(), position: integer()}

All available types that can be resolved into a channel position.

t() (since 0.1.0)

t() :: %Crux.Structs.Channel{
  application_id: Crux.Structs.Snowflake.t(),
  bitrate: integer(),
  guild_id: Crux.Structs.Snowflake.t(),
  icon: String.t(),
  id: Crux.Structs.Snowflake.t(),
  last_message_id: Crux.Structs.Snowflake.t(),
  last_pin_timestamp: String.t(),
  name: String.t(),
  nsfw: boolean(),
  owner_id: Crux.Structs.Snowflake.t(),
  parent_id: Crux.Structs.Snowflake.t(),
  permission_overwrites: %{
    optional(Crux.Structs.Snowflake.t()) => Crux.Structs.Overwrite.t()
  },
  position: integer(),
  rate_limit_per_user: integer(),
  recipients: MapSet.t(Crux.Structs.Snowflake.t()),
  topic: String.t(),
  type: integer(),
  user_limit: non_neg_integer()
}

Link to this section Functions

create(data) (since 0.1.0)

create(data :: map()) :: t()

Creates a Crux.Structs.Channel.t/0 struct from raw data.

Automatically invoked by Crux.Structs.create/2

resolve_id(resolvable) (since 0.2.1)

resolve_id(id_resolvable()) :: Crux.Structs.Snowflake.t() | nil

Resolves the id of a Crux.Structs.Channel.t/0.

Automatically invoked by Crux.Structs.resolve_id/2.

  iex> %Crux.Structs.Message{channel_id: 222079895583457280}
  ...> |> Crux.Structs.Channel.resolve_id()
  222079895583457280

  iex> %Crux.Structs.Channel{id: 222079895583457280}
  ...> |> Crux.Structs.Channel.resolve_id()
  222079895583457280

  iex> 222079895583457280
  ...> |> Crux.Structs.Channel.resolve_id()
  222079895583457280

  iex> "222079895583457280"
  ...> |> Crux.Structs.Channel.resolve_id()
  222079895583457280

resolve_position(resolvable) (since 0.2.1)

resolve_position(position_resolvable()) ::
  %{id: Crux.Structs.Snowflake.t(), position: integer()} | nil

Resolves a position_resolvable/0 into a channel position.

Examples

  iex> %Crux.Structs.Channel{id: 222079895583457280, position: 5}
  ...> |> Crux.Structs.Channel.resolve_position()
  %{id: 222079895583457280, position: 5}

  iex> {%Crux.Structs.Channel{id: 222079895583457280}, 5}
  ...> |> Crux.Structs.Channel.resolve_position()
  %{id: 222079895583457280, position: 5}

  iex> {222079895583457280, 5}
  ...> |> Crux.Structs.Channel.resolve_position()
  %{id: 222079895583457280, position: 5}

  iex> %{id: 222079895583457280, position: 5}
  ...> |> Crux.Structs.Channel.resolve_position()
  %{id: 222079895583457280, position: 5}

  iex> {nil, 5}
  ...> |> Crux.Structs.Channel.resolve_position()
  nil

to_mention(channel) (since 0.1.1)

to_mention(user :: Crux.Structs.Channel.t()) :: String.t()

Converts a Crux.Structs.Channel.t/0 into its discord mention format.

Example

iex> %Crux.Structs.Channel{id: 316880197314019329}
...> |> Crux.Structs.Channel.to_mention()
"<#316880197314019329>"

v0.2.2

crux_structs v0.2.2 Crux.Structs.Channel View Source

Link to this section Summary

Types

Functions

Link to this section Types

id_resolvable() View Source (since 0.2.1)

id_resolvable() :: Crux.Structs.Message.t() | Crux.Structs.Channel.t() | Crux.Structs.Snowflake.t() | String.t()

position_resolvable() View Source (since 0.2.1)

position_resolvable() :: Crux.Structs.Channel.t() | %{channel: id_resolvable(), position: integer()} | {id_resolvable(), integer()} | %{id: id_resolvable(), position: integer()}

Link to this section Functions

create(data) View Source (since 0.1.0)

create(data :: map()) :: t()

resolve_id(resolvable) View Source (since 0.2.1)

resolve_id(id_resolvable()) :: Crux.Structs.Snowflake.t() | nil

resolve_position(resolvable) View Source (since 0.2.1)

resolve_position(position_resolvable()) :: %{id: Crux.Structs.Snowflake.t(), position: integer()} | nil

Examples

to_mention(channel) View Source (since 0.1.1)

to_mention(user :: Crux.Structs.Channel.t()) :: String.t()

Example

v0.2.2

crux_structs v0.2.2 Crux.Structs.Channel View Source

Link to this section Summary

Types

Functions

Link to this section Types

id_resolvable() View Source (since 0.2.1) id_resolvable() :: Crux.Structs.Message.t() | Crux.Structs.Channel.t() | Crux.Structs.Snowflake.t() | String.t()

position_resolvable() View Source (since 0.2.1) position_resolvable() :: Crux.Structs.Channel.t() | %{channel: id_resolvable(), position: integer()} | {id_resolvable(), integer()} | %{id: id_resolvable(), position: integer()}

Link to this section Functions

create(data) View Source (since 0.1.0) create(data :: map()) :: t()

resolve_id(resolvable) View Source (since 0.2.1) resolve_id(id_resolvable()) :: Crux.Structs.Snowflake.t() | nil

resolve_position(resolvable) View Source (since 0.2.1) resolve_position(position_resolvable()) :: %{id: Crux.Structs.Snowflake.t(), position: integer()} | nil

Examples

to_mention(channel) View Source (since 0.1.1) to_mention(user :: Crux.Structs.Channel.t()) :: String.t()

Example

id_resolvable() View Source (since 0.2.1)

id_resolvable() :: Crux.Structs.Message.t() | Crux.Structs.Channel.t() | Crux.Structs.Snowflake.t() | String.t()

position_resolvable() View Source (since 0.2.1)

position_resolvable() :: Crux.Structs.Channel.t() | %{channel: id_resolvable(), position: integer()} | {id_resolvable(), integer()} | %{id: id_resolvable(), position: integer()}

create(data) View Source (since 0.1.0)

create(data :: map()) :: t()

resolve_id(resolvable) View Source (since 0.2.1)

resolve_id(id_resolvable()) :: Crux.Structs.Snowflake.t() | nil

resolve_position(resolvable) View Source (since 0.2.1)

resolve_position(position_resolvable()) :: %{id: Crux.Structs.Snowflake.t(), position: integer()} | nil

to_mention(channel) View Source (since 0.1.1)

to_mention(user :: Crux.Structs.Channel.t()) :: String.t()