dpp::emoji Class Reference

Represents an emoji for a dpp::guild. More...

#include <emoji.h>

Inheritance diagram for dpp::emoji:

Collaboration diagram for dpp::emoji:

Public Member Functions
	emoji ()=default
	Construct a new emoji object. More...
	emoji (const std::string_view name, const snowflake id=0, const uint8_t flags=0)
	Construct a new emoji object with name, ID and flags. More...
	emoji (const emoji &rhs)=default
	Copy constructor, copies another emoji's data. More...
	emoji (emoji &&rhs) noexcept=default
	Move constructor, moves another emoji's data to this. More...
	~emoji () override=default
	Destroy the emoji object. More...
emoji &	operator= (const emoji &rhs)=default
	Copy assignment operator, copies another emoji's data. More...
emoji &	operator= (emoji &&rhs) noexcept=default
	Move constructor, moves another emoji's data to this. More...
emoji &	fill_from_json (nlohmann::json *j)
	Read class values from json object. More...
std::string	build_json (bool with_id=false) const override
	Build the json for this object. More...
bool	requires_colons () const
	Emoji requires colons. More...
bool	is_managed () const
	Emoji is managed. More...
bool	is_animated () const
	Emoji is animated. More...
bool	is_available () const
	Is available. More...
emoji &	load_image (std::string_view image_blob, const image_type type)
	Load an image into the object as base64. More...
std::string	format () const
	Format to name if unicode, name:id if has id or a:name:id if animated. More...
std::string	get_mention () const
	Get the mention/ping for the emoji. More...
std::string	get_url (uint16_t size=0, const image_type format=i_png, bool prefer_animated=true) const
	Get the custom emoji url. More...
double	get_creation_time () const
	Get the creation time of this object according to Discord. More...
bool	operator== (const managed &other) const noexcept
	Comparison operator for comparing two managed objects by id. More...
bool	operator!= (const managed &other) const noexcept
	Comparison operator for comparing two managed objects by id. More...

Static Public Member Functions
static std::string	get_mention (std::string_view name, snowflake id, bool is_animated=false)
	Create a mentionable emoji. More...

Public Attributes
std::string	name {}
	Emoji name. More...
snowflake	user_id {0}
	User id who uploaded the emoji. More...
uint8_t	flags {0}
	Flags for the emoji from dpp::emoji_flags. More...
std::string	image_data {}
	Image data for the emoji if uploading. More...
snowflake	id
	Unique ID of object set by Discord. This value contains a timestamp, worker ID, internal server ID, and an incrementing value. Only the timestamp is relevant to us as useful metadata. More...

Detailed Description

Represents an emoji for a dpp::guild.

Constructor & Destructor Documentation

emoji() [1/4]

dpp::emoji::emoji ( )

default

Construct a new emoji object.

emoji() [2/4]

dpp::emoji::emoji	(	const std::string_view	name,
		const snowflake	id = 0,
		const uint8_t	flags = 0
	)

Construct a new emoji object with name, ID and flags.

Parameters

name	The emoji's name
id	ID, if it has one (unicode does not)
flags	Emoji flags (emoji_flags)

emoji() [3/4]

dpp::emoji::emoji ( const emoji &  rhs )

default

Copy constructor, copies another emoji's data.

Parameters

rhs	Emoji to copy

emoji() [4/4]

dpp::emoji::emoji ( emoji &&  rhs )

defaultnoexcept

Move constructor, moves another emoji's data to this.

Parameters

rhs	Emoji to move from

~emoji()

dpp::emoji::~emoji ( )

overridedefault

Destroy the emoji object.

Member Function Documentation

build_json()

std::string dpp::emoji::build_json ( bool  with_id = false ) const

overridevirtual

Build the json for this object.

Parameters

with_id

include the id in the JSON

Returns

std::string json data

Reimplemented from dpp::json_interface< emoji >.

fill_from_json()

emoji & dpp::emoji::fill_from_json

(

nlohmann::json *

j

)

Read class values from json object.

Parameters

j	A json object to read from

Returns

A reference to self

format()

std::string dpp::emoji::format

(

)

const

Format to name if unicode, name:id if has id or a:name:id if animated.

Returns

Formatted name for reactions

get_creation_time()

double dpp::managed::get_creation_time ( ) const

inherited

Get the creation time of this object according to Discord.

Returns

double creation time inferred from the snowflake ID. The minimum possible value is the first second of 2015.

get_mention() [1/2]

std::string dpp::emoji::get_mention

(

)

const

Get the mention/ping for the emoji.

Returns

std::string mention

get_mention() [2/2]

static std::string dpp::emoji::get_mention ( std::string_view  name, snowflake  id, bool  is_animated = false  )

static

Create a mentionable emoji.

Parameters

name	The name of the emoji.
id	The ID of the emoji.
is_animated	is emoji animated.

Returns

std::string The formatted mention of the emoji.

get_url()

std::string dpp::emoji::get_url	(	uint16_t	size = 0,
		const image_type	format = i_png,
		bool	prefer_animated = true
	)		const

Get the custom emoji url.

Parameters

size	The size of the emoji in pixels. It can be any power of two between 16 and 4096, otherwise the default sized emoji is returned.
format	The format to use for the emoji. It can be one of i_webp, i_jpg, i_png or i_gif. When passing i_gif, it returns an empty string for non-animated emojis. Consider using the prefer_animated parameter instead.
prefer_animated	Whether you prefer gif format. If true, it'll return gif format whenever the emoji is available as animated.

Returns

std::string emoji url or an empty string, if the id is not set

is_animated()

bool dpp::emoji::is_animated

(

)

const

Emoji is animated.

Returns

true Is animated

false Is noy animated

is_available()

bool dpp::emoji::is_available

(

)

const

Is available.

Returns

true Is available

false Is unavailable

is_managed()

bool dpp::emoji::is_managed

(

)

const

Emoji is managed.

Returns

true Is managed

false Is not managed

load_image()

emoji & dpp::emoji::load_image	(	std::string_view	image_blob,
		const image_type	type
	)

Load an image into the object as base64.

Parameters

image_blob	Image binary data
type	Type of image. It can be one of i_gif, i_jpg or i_png.

Returns

emoji& Reference to self

Exceptions

dpp::length_exception

Image content exceeds discord maximum of 256 kilobytes

operator!=()

bool dpp::managed::operator!= ( const managed &  other ) const

noexceptinherited

Comparison operator for comparing two managed objects by id.

Parameters

other

Other object to compare against

Returns

true objects are not the same id

false objects are the same id

operator=() [1/2]

emoji & dpp::emoji::operator= ( const emoji &  rhs )

default

Copy assignment operator, copies another emoji's data.

Parameters

rhs	Emoji to copy

operator=() [2/2]

emoji & dpp::emoji::operator= ( emoji &&  rhs )

defaultnoexcept

Move constructor, moves another emoji's data to this.

Parameters

rhs	Emoji to move from

operator==()

bool dpp::managed::operator== ( const managed &  other ) const

noexceptinherited

Comparison operator for comparing two managed objects by id.

Parameters

other

Other object to compare against

Returns

true objects are the same id

false objects are not the same id

requires_colons()

bool dpp::emoji::requires_colons

(

)

const

Emoji requires colons.

Returns

true Requires colons

false Does not require colons

Member Data Documentation

flags

uint8_t dpp::emoji::flags {0}

Flags for the emoji from dpp::emoji_flags.

id

snowflake dpp::managed::id

inherited

Unique ID of object set by Discord. This value contains a timestamp, worker ID, internal server ID, and an incrementing value. Only the timestamp is relevant to us as useful metadata.

image_data

std::string dpp::emoji::image_data {}

Image data for the emoji if uploading.

name

std::string dpp::emoji::name {}

Emoji name.

user_id

snowflake dpp::emoji::user_id {0}

User id who uploaded the emoji.