Represents an invite to a discord guild or channel. More...

Inheritance diagram for dpp::invite:

Collaboration diagram for dpp::invite:

Public Member Functions
	invite ()
	Constructor. More...

virtual	~invite ()=default
	Destructor. More...

invite &	set_max_age (const uint32_t max_age_)
	Set the max age after which the invite expires. More...

invite &	set_max_uses (const uint8_t max_uses_)
	Set the maximum number of uses for this invite. More...

invite &	set_target_user_id (const snowflake user_id)
	Set the target user id. More...

invite &	set_target_type (const invite_target_t type)
	Set the target type for this voice channel invite. More...

invite &	set_temporary (const bool is_temporary)
	Set temporary property of this invite object. More...

invite &	set_unique (const bool is_unique)
	Set unique property of this invite object. More...

invite &	fill_from_json (nlohmann::json *j)
	Convert object from nlohmann::json. More...

auto	to_json (bool with_id=false) const
	Convert object to nlohmann::json. More...

std::string	build_json (bool with_id=false) const
	Convert object to json string. More...

Public Attributes
std::string	code
	Invite code. More...

time_t	expires_at
	Readonly expiration timestamp of this invite or 0 if the invite doesn't expire. More...

snowflake	guild_id
	Guild ID this invite is for. More...

guild	destination_guild
	The partial guild this invite is for. More...

snowflake	channel_id
	Channel ID this invite is for. More...

channel	destination_channel
	The partial channel this invite is for. More...

snowflake	inviter_id
	User ID who created this invite. More...

user	inviter
	User who created this invite. More...

snowflake	target_user_id
	The user ID whose stream to display for this voice channel stream invite. More...

invite_target_t	target_type
	Target type for this voice channel invite. More...

uint32_t	approximate_presence_count
	Approximate number of online users. More...

uint32_t	approximate_member_count
	Approximate number of total users online and offline. More...

uint32_t	max_age
	Duration (in seconds) after which the invite expires, or 0 for no expiration. Defaults to 86400 (1 day). More...

uint8_t	max_uses
	Maximum number of uses, or 0 for unlimited. Defaults to 0. More...

bool	temporary
	Whether this invite only grants temporary membership. More...

bool	unique
	True if this invite should not replace or "attach to" similar invites. More...

uint32_t	uses
	How many times this invite has been used. More...

stage_instance	stage

time_t	created_at
	Timestamp at which the invite was created. More...

Protected Member Functions
invite &	fill_from_json_impl (nlohmann::json *j)

virtual json	to_json_impl (bool with_id=false) const

Friends
struct	json_interface< invite >

Detailed Description

Represents an invite to a discord guild or channel.

Constructor & Destructor Documentation

◆ invite()

dpp::invite::invite ( )

Constructor.

◆ ~invite()

virtual dpp::invite::~invite ( )

virtualdefault

Destructor.

Member Function Documentation

◆ build_json()

std::string dpp::json_interface< invite >::build_json ( bool with_id = false ) const

inlineinherited

Convert object to json string.

Parameters

with_id Whether to include the ID or not

Note: Some fields are conditionally filled, do not rely on all fields being present

Returns: std::string Json built from the structure

◆ fill_from_json()

invite & dpp::json_interface< invite >::fill_from_json ( nlohmann::json * j )

inlineinherited

Convert object from nlohmann::json.

Parameters

j	nlohmann::json object

Returns: T& Reference to self for fluent calling

◆ fill_from_json_impl()

invite& dpp::invite::fill_from_json_impl ( nlohmann::json * j )

protected

Read class values from json object

Parameters

j	A json object to read from

Returns: A reference to self

◆ set_max_age()

invite& dpp::invite::set_max_age ( const uint32_t max_age_ )

Set the max age after which the invite expires.

Parameters

max_age_ The duration in seconds, or 0 for no expiration. Must be between 0 and 604800 (7 days)

Returns: invite& reference to self for chaining of calls

◆ set_max_uses()

invite& dpp::invite::set_max_uses ( const uint8_t max_uses_ )

Set the maximum number of uses for this invite.

Parameters

max_uses_ Maximum number of uses, or 0 for unlimited. Must be between 0 and 100

Returns: invite& reference to self for chaining of calls

◆ set_target_type()

invite& dpp::invite::set_target_type ( const invite_target_t type )

Set the target type for this voice channel invite.

Parameters

type	invite_target_t Target type

Returns: invite& reference to self for chaining of calls

◆ set_target_user_id()

invite& dpp::invite::set_target_user_id ( const snowflake user_id )

Set the target user id.

Parameters

user_id The user ID whose stream to display for this voice channel stream invite

Returns: invite& reference to self for chaining of calls

◆ set_temporary()

invite& dpp::invite::set_temporary ( const bool is_temporary )

Set temporary property of this invite object.

Parameters

is_temporary Whether this invite only grants temporary membership

Returns: invite& reference to self for chaining of calls

◆ set_unique()

invite& dpp::invite::set_unique ( const bool is_unique )

Set unique property of this invite object.

Parameters

is_unique True if this invite should not replace or "attach to" similar invites

Returns: invite& reference to self for chaining of calls

◆ to_json()

auto dpp::json_interface< invite >::to_json ( bool with_id = false ) const

inlineinherited

Convert object to nlohmann::json.

Parameters

with_id Whether to include the ID or not

Note: Some fields are conditionally filled, do not rely on all fields being present

Returns: json Json built from the structure

◆ to_json_impl()

virtual json dpp::invite::to_json_impl ( bool with_id = false ) const

protectedvirtual

Build JSON from this object.

Parameters

with_id Include ID in JSON

Returns: The JSON of the invite

Friends And Related Function Documentation

◆ json_interface< invite >

friend struct json_interface< invite >

friend

Member Data Documentation

◆ approximate_member_count

uint32_t dpp::invite::approximate_member_count

Approximate number of total users online and offline.

Note: Only returned from cluster::invite_get.

◆ approximate_presence_count

uint32_t dpp::invite::approximate_presence_count

Approximate number of online users.

Note: Only returned from cluster::invite_get

◆ channel_id

snowflake dpp::invite::channel_id

Channel ID this invite is for.

◆ code

std::string dpp::invite::code

Invite code.

◆ created_at

time_t dpp::invite::created_at

Timestamp at which the invite was created.

◆ destination_channel

channel dpp::invite::destination_channel

The partial channel this invite is for.

Note: Only filled in retrieved invites.

◆ destination_guild

guild dpp::invite::destination_guild

The partial guild this invite is for.

Note: Only filled in retrieved invites.

◆ expires_at

time_t dpp::invite::expires_at

Readonly expiration timestamp of this invite or 0 if the invite doesn't expire.

Note: Only returned from cluster::invite_get

◆ guild_id

snowflake dpp::invite::guild_id

Guild ID this invite is for.

◆ inviter

user dpp::invite::inviter

User who created this invite.

◆ inviter_id

snowflake dpp::invite::inviter_id

User ID who created this invite.

Deprecated:: Use the inviter field instead

◆ max_age

uint32_t dpp::invite::max_age

Duration (in seconds) after which the invite expires, or 0 for no expiration. Defaults to 86400 (1 day).

Note: Must be between 0 and 604800 (7 days).

◆ max_uses

uint8_t dpp::invite::max_uses

Maximum number of uses, or 0 for unlimited. Defaults to 0.

Note: Must be between 0 and 100.

◆ stage

stage_instance dpp::invite::stage

Note: The stage instance data if there is a public stage instance in the stage channel this invite is for.

Deprecated:: Deprecated

◆ target_type

invite_target_t dpp::invite::target_type

Target type for this voice channel invite.

◆ target_user_id

snowflake dpp::invite::target_user_id

The user ID whose stream to display for this voice channel stream invite.

◆ temporary

bool dpp::invite::temporary

Whether this invite only grants temporary membership.

◆ unique

bool dpp::invite::unique

True if this invite should not replace or "attach to" similar invites.

◆ uses

uint32_t dpp::invite::uses

How many times this invite has been used.

Public Member Functions

Public Attributes

Protected Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ invite()

◆ ~invite()

Member Function Documentation

◆ build_json()

◆ fill_from_json()

◆ fill_from_json_impl()

◆ set_max_age()

◆ set_max_uses()

◆ set_target_type()

◆ set_target_user_id()

◆ set_temporary()

◆ set_unique()

◆ to_json()

◆ to_json_impl()

Friends And Related Function Documentation

◆ json_interface< invite >

Member Data Documentation

◆ approximate_member_count

◆ approximate_presence_count

◆ channel_id

◆ code

◆ created_at

◆ destination_channel

◆ destination_guild

◆ expires_at

◆ guild_id

◆ inviter

◆ inviter_id

◆ max_age

◆ max_uses

◆ stage

◆ target_type

◆ target_user_id

◆ temporary

◆ unique

◆ uses