dpp::embed Struct Reference

A rich embed for display within a dpp::message. More...

#include <message.h>

Collaboration diagram for dpp::embed:

Public Member Functions
	embed ()
	embed (nlohmann::json *j)
	~embed ()
embed &	set_title (const std::string &text)
embed &	set_description (const std::string &text)
embed &	set_footer (const embed_footer &f)
embed &	set_footer (const std::string &text, const std::string &icon_url)
embed &	set_color (uint32_t col)
embed &	set_timestamp (time_t tstamp)
embed &	set_url (const std::string &url)
embed &	add_field (const std::string &name, const std::string &value, bool is_inline=false)
embed &	set_author (const dpp::embed_author &a)
embed &	set_author (const std::string &name, const std::string &url, const std::string &icon_url)
embed &	set_provider (const std::string &name, const std::string &url)
embed &	set_image (const std::string &url)
embed &	set_video (const std::string &url)
embed &	set_thumbnail (const std::string &url)

Public Attributes
std::string	title
std::string	type
std::string	description
std::string	url
time_t	timestamp
uint32_t	color
std::optional< embed_footer >	footer
std::optional< embed_image >	image
std::optional< embed_image >	thumbnail
std::optional< embed_image >	video
std::optional< embed_provider >	provider
std::optional< embed_author >	author
std::vector< embed_field >	fields

Detailed Description

A rich embed for display within a dpp::message.

Constructor & Destructor Documentation

embed() [1/2]

dpp::embed::embed

(

)

Constructor

embed() [2/2]

dpp::embed::embed

(

nlohmann::json *

j

)

Constructor to build embed from json object

Parameters

j	JSON to read content from

~embed()

dpp::embed::~embed

(

)

Destructor

Member Function Documentation

add_field()

embed & dpp::embed::add_field	(	const std::string &	name,
		const std::string &	value,
		bool	is_inline = false
	)

Add an embed field. Returns the embed itself so these method calls may be "chained"

Parameters

name	The name of the field. It will be truncated to the maximum length of 256 UTF-8 characters.
value	The value of the field. It will be truncated to the maximum length of 1024 UTF-8 characters.
is_inline	Whether or not to display the field 'inline' or on its own line

Returns

A reference to self

set_author() [1/2]

embed & dpp::embed::set_author

(

const dpp::embed_author &

a

)

Set embed author. Returns the embed itself so these method calls may be "chained"

Parameters

a	The author to set

Returns

A reference to self

set_author() [2/2]

embed & dpp::embed::set_author	(	const std::string &	name,
		const std::string &	url,
		const std::string &	icon_url
	)

Set embed author. Returns the embed itself so these method calls may be "chained"

Parameters

name	The name of the author. It will be truncated to the maximum length of 256 UTF-8 characters.
url	The url of the author (only supports http(s))
icon_url	The icon URL of the author (only supports http(s) and attachments)

Returns

A reference to self

set_color()

embed & dpp::embed::set_color

(

uint32_t

col

)

Set embed colour. Returns the embed itself so these method calls may be "chained"

Parameters

col	The colour of the embed

Returns

A reference to self

set_description()

embed & dpp::embed::set_description

(

const std::string &

text

)

Set embed description. Returns the embed itself so these method calls may be "chained"

Parameters

text	The text of the title. It will be truncated to the maximum length of 4096 UTF-8 characters.

Returns

A reference to self

set_footer() [1/2]

embed & dpp::embed::set_footer

(

const embed_footer &

f

)

Set the footer of the embed. Returns the embed itself so these method calls may be "chained"

Parameters

f	the footer to set

Returns

A reference to self

set_footer() [2/2]

embed & dpp::embed::set_footer	(	const std::string &	text,
		const std::string &	icon_url
	)

Set the footer of the embed. Returns the embed itself so these method calls may be "chained"

Parameters

text	string to set as footer text. It will be truncated to the maximum length of 2048 UTF-8 characters.
icon_url	an url to set as footer icon url (only supports http(s) and attachments)

Returns

A reference to self

set_image()

embed & dpp::embed::set_image

(

const std::string &

url

)

Set embed image. Returns the embed itself so these method calls may be "chained"

Parameters

url	The embed image URL (only supports http(s) and attachments)

Returns

A reference to self

set_provider()

embed & dpp::embed::set_provider	(	const std::string &	name,
		const std::string &	url
	)

Set embed provider. Returns the embed itself so these method calls may be "chained"

Parameters

name	The provider name. It will be truncated to the maximum length of 256 UTF-8 characters.
url	The provider url

Returns

A reference to self

set_thumbnail()

embed & dpp::embed::set_thumbnail

(

const std::string &

url

)

Set embed thumbnail. Returns the embed itself so these method calls may be "chained"

Parameters

url	The embed thumbnail url (only supports http(s) and attachments)

Returns

A reference to self

set_timestamp()

embed & dpp::embed::set_timestamp

(

time_t

tstamp

)

Set embed timestamp. Returns the embed itself so these method calls may be "chained"

Parameters

tstamp

The timestamp to show in the footer, should be in UTC

Returns

A reference to self

set_title()

embed & dpp::embed::set_title

(

const std::string &

text

)

Set embed title. Returns the embed itself so these method calls may be "chained"

Parameters

text	The text of the title. It will be truncated to the maximum length of 256 UTF-8 characters.

Returns

A reference to self

set_url()

embed & dpp::embed::set_url

(

const std::string &

url

)

Set embed url. Returns the embed itself so these method calls may be "chained"

Parameters

url	the url of the embed

Returns

A reference to self

set_video()

embed & dpp::embed::set_video

(

const std::string &

url

)

Set embed video. Returns the embed itself so these method calls may be "chained"

Parameters

url	The embed video url

Returns

A reference to self

Member Data Documentation

author

std::optional<embed_author> dpp::embed::author

Optional: author information

color

uint32_t dpp::embed::color

Optional: color code of the embed

description

std::string dpp::embed::description

Optional: description of embed

fields

std::vector<embed_field> dpp::embed::fields

Optional: fields information

footer

std::optional<embed_footer> dpp::embed::footer

Optional: footer information

image

std::optional<embed_image> dpp::embed::image

Optional: image information

provider

std::optional<embed_provider> dpp::embed::provider

Optional: provider information (can't send these)

thumbnail

std::optional<embed_image> dpp::embed::thumbnail

Optional: thumbnail information

timestamp

time_t dpp::embed::timestamp

Optional: timestamp of embed content

title

std::string dpp::embed::title

Optional: title of embed

type

std::string dpp::embed::type

Optional: type of embed (always "rich" for webhook embeds)

url

std::string dpp::embed::url

Optional: url of embed

video

std::optional<embed_image> dpp::embed::video

Optional: video information (can't send these)