Class: Discorb::CustomEmoji
Overview
Represents a custom emoji in discord.
Instance Attribute Summary collapse
-
#available -> Boolean
(also: #available?)
readonly
Whether the emoji is available.
-
#guild -> Boolean
readonly
Whether the emoji requires colons.
-
#id -> Discorb::Snowflake
readonly
The ID of the emoji.
-
#managed -> Boolean
(also: #managed?)
readonly
Whether the emoji is managed by integration (ex: Twitch).
-
#name -> String
readonly
The name of the emoji.
-
#require_colons -> Boolean
(also: #require_colons?)
readonly
Whether the emoji requires colons.
-
#roles -> Array<Discorb::Role>
readonly
The roles that can use this emoji.
-
#roles? -> Boolean
(also: #role?)
readonly
Whether or not this emoji is restricted to certain roles.
-
#user -> Discorb::User
readonly
The user that created this emoji.
Instance Method Summary collapse
-
#delete!(reason: nil) -> Async::Task<self>
(also: #destroy!)
Delete the emoji.
-
#edit(name: Discorb::Unset, roles: Discorb::Unset, reason: nil) -> Async::Task<self>
(also: #modify)
Edit the emoji.
- #inspect -> Object
-
#to_s -> String
Format the emoji for sending.
-
#to_uri -> String
Format the emoji for URI.
Methods inherited from Emoji
Instance Attribute Details
#available -> Boolean (readonly) Also known as: available?
Returns whether the emoji is available.
41 42 43 |
# File 'lib/discorb/emoji.rb', line 41 def available @available end |
#guild -> Boolean (readonly)
Returns Whether the emoji requires colons.
33 34 35 |
# File 'lib/discorb/emoji.rb', line 33 def guild @guild end |
#id -> Discorb::Snowflake (readonly)
Returns The ID of the emoji.
25 26 27 |
# File 'lib/discorb/emoji.rb', line 25 def id @id end |
#managed -> Boolean (readonly) Also known as: managed?
Returns whether the emoji is managed by integration (ex: Twitch).
35 36 37 |
# File 'lib/discorb/emoji.rb', line 35 def managed @managed end |
#name -> String (readonly)
Returns The name of the emoji.
27 28 29 |
# File 'lib/discorb/emoji.rb', line 27 def name @name end |
#require_colons -> Boolean (readonly) Also known as: require_colons?
Returns whether the emoji requires colons.
38 39 40 |
# File 'lib/discorb/emoji.rb', line 38 def require_colons @require_colons end |
#roles -> Array<Discorb::Role> (readonly)
Returns The roles that can use this emoji.
29 30 31 |
# File 'lib/discorb/emoji.rb', line 29 def roles @roles end |
#roles? -> Boolean (readonly) Also known as: role?
Returns whether or not this emoji is restricted to certain roles.
|
# File 'lib/discorb/emoji.rb', line 44
|
#user -> Discorb::User (readonly)
Returns The user that created this emoji.
31 32 33 |
# File 'lib/discorb/emoji.rb', line 31 def user @user end |
Instance Method Details
#delete!(reason: nil) -> Async::Task<self> Also known as: destroy!
Delete the emoji.
121 122 123 124 125 126 127 |
# File 'lib/discorb/emoji.rb', line 121 def delete!(reason: nil) Async do @client.http.request(Route.new("/guilds/#{@guild.id}/emojis/#{@id}", "//guilds/:guild_id/emojis/:emoji_id", :delete), audit_log_reason: reason).wait @available = false self end end |
#edit(name: Discorb::Unset, roles: Discorb::Unset, reason: nil) -> Async::Task<self> Also known as: modify
The arguments of this method are defaultly set to Discorb::Unset
. Specify value to set the value, if not don't specify or specify Discorb::Unset
.
Edit the emoji.
101 102 103 104 105 106 107 108 109 |
# File 'lib/discorb/emoji.rb', line 101 def edit(name: Discorb::Unset, roles: Discorb::Unset, reason: nil) Async do payload = {} payload[:name] = name if name != Discorb::Unset payload[:roles] = roles.map { |r| Discorb::Utils.try(r, :id) } if roles != Discorb::Unset @client.http.request(Route.new("/guilds/#{@guild.id}/emojis/#{@id}", "//guilds/:guild_id/emojis/:emoji_id", :patch), payload, audit_log_reason: reason) self end end |
#inspect -> Object
86 87 88 |
# File 'lib/discorb/emoji.rb', line 86 def inspect "#<#{self.class} id=#{@id} :#{@name}:>" end |
#to_s -> String
Format the emoji for sending.
67 68 69 |
# File 'lib/discorb/emoji.rb', line 67 def to_s "<#{@animated ? "a" : ""}:#{@name}:#{id}>" end |
#to_uri -> String
Format the emoji for URI.
76 77 78 |
# File 'lib/discorb/emoji.rb', line 76 def to_uri "#{@name}:#{@id}" end |