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 ()
	Construct a new emoji object. More...
	emoji (const std::string n, const snowflake i=0, const uint8_t f=0)
	Construct a new emoji object with name, ID and flags. More...
virtual	~emoji ()
	Destroy the emoji object. More...
emoji &	fill_from_json (nlohmann::json *j)
	Read class values from json object. More...
virtual std::string	build_json (bool with_id=false) const
	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 (const std::string &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...
double	get_creation_time () const
	Get the creation time of this object according to Discord. More...
emoji &	parse_from_json (nlohmann::json *j)
	Convert object from nlohmann::json. More...

Public Attributes
std::string	name
	Emoji name. More...
snowflake	user_id
	User id who uploaded the emoji. More...
uint8_t	flags
	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/2]

dpp::emoji::emoji

(

)

Construct a new emoji object.

emoji() [2/2]

dpp::emoji::emoji	(	const std::string	n,
		const snowflake	i = 0,
		const uint8_t	f = 0
	)

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

Parameters

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

~emoji()

virtual dpp::emoji::~emoji ( )

virtual

Destroy the emoji object.

Member Function Documentation

build_json()

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

virtual

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()

std::string dpp::emoji::get_mention

(

)

const

Get the mention/ping for the emoji.

Returns

std::string mention

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	(	const std::string &	image_blob,
		const image_type	type
	)

Load an image into the object as base64.

Parameters

image_blob	Image binary data
type	Type of image

Returns

emoji& Reference to self

Exceptions

dpp::exception

Image content exceeds discord maximum of 256 kilobytes

parse_from_json()

emoji & dpp::json_interface< emoji >::parse_from_json ( nlohmann::json *  j )

inlineinherited

Convert object from nlohmann::json.

Parameters

j	nlohmann::json object

Returns

T& Reference to self for fluent calling

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

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

User id who uploaded the emoji.