dpp::guild Class Reference

Represents a guild on Discord (AKA a server) More...

#include <guild.h>

Inheritance diagram for dpp::guild:

Collaboration diagram for dpp::guild:

Public Member Functions
	guild ()
virtual	~guild ()=default
	Destroy the guild object. More...
guild &	fill_from_json (class discord_client *shard, nlohmann::json *j)
std::string	build_json (bool with_id=false) const
uint64_t	base_permissions (const class user *member) const
	Get the base permissions for a member on this guild, before permission overwrites are applied. More...
uint64_t	permission_overwrites (const uint64_t base_permissions, const user *member, const channel *channel) const
	Get the permission overwrites for a member merged into a bitmask. More...
void	rehash_members ()
	Rehash members map. More...
bool	connect_member_voice (snowflake user_id, bool self_mute=false, bool self_deaf=false)
	Connect to a voice channel another guild member is in. More...
guild &	set_name (const std::string &n)
	Set the name of the guild in the object Min length: 2, Max length: 100 (not including leading/trailing spaces) More...
bool	is_large () const
	Is a large server (>250 users) More...
bool	is_unavailable () const
	Is unavailable due to outage (most other fields will be blank or outdated. More...
bool	widget_enabled () const
	Widget is enabled for this server. More...
bool	has_invite_splash () const
	Guild has an invite splash. More...
bool	has_vip_regions () const
	Guild has VIP voice regions. More...
bool	has_vanity_url () const
	Guild can have a vanity url. More...
bool	is_verified () const
	Guild is a verified server. More...
bool	is_partnered () const
	Guild is a discord partnered server. More...
bool	is_community () const
	Has enabled community. More...
bool	has_commerce () const
	Guild has commerce channels. More...
bool	has_news () const
	Guild has news channels. More...
bool	is_discoverable () const
	Guild is discoverable. More...
bool	is_featureable () const
	Guild is featurable. More...
bool	has_animated_icon () const
	Guild can have an animated icon. More...
bool	has_banner () const
	Guild has a banner image. More...
bool	is_welcome_screen_enabled () const
	Guild has enabled the welcome screen. More...
bool	has_member_verification_gate () const
	Guild has membership screening. More...
bool	is_preview_enabled () const
	Guild has preview enabled. More...
bool	has_animated_icon_hash () const
	Guild icon is actually an animated gif. More...
bool	has_animated_banner_icon_hash () const
	Guild banner is animated gif. More...
bool	has_monetization_enabled () const
	guild has access to monetization features More...
bool	has_more_stickers () const
	guild has increased custom sticker slots More...
bool	has_private_threads () const
	guild has access to create private threads More...
bool	has_role_icons () const
	guild is able to set role icons More...
bool	has_seven_day_thread_archive () const
	guild has access to the seven day archive time for threads More...
bool	has_three_day_thread_archive () const
	guild has access to the three day archive time for threads More...
bool	has_ticketed_events () const
	guild has enabled ticketed events More...
bool	has_channel_banners () const
	guild has access to channel banners feature More...
double	get_creation_time () const
	Get the creation time of this object according to Discord. More...

Public Attributes
uint16_t	shard_id
uint32_t	flags
std::string	name
std::string	description
std::string	vanity_url_code
	Vanity url code for verified or partnered servers and boost level 3. More...
utility::iconhash	icon
utility::iconhash	splash
utility::iconhash	discovery_splash
snowflake	owner_id
snowflake	afk_channel_id
uint8_t	afk_timeout
snowflake	widget_channel_id
verification_level_t	verification_level
uint8_t	default_message_notifications
guild_explicit_content_t	explicit_content_filter
mfa_level_t	mfa_level
snowflake	application_id
snowflake	system_channel_id
snowflake	rules_channel_id
uint32_t	member_count
utility::iconhash	banner
uint8_t	premium_tier
uint16_t	premium_subscription_count
snowflake	public_updates_channel_id
uint16_t	max_video_channel_users
std::vector< snowflake >	roles
std::vector< snowflake >	channels
std::vector< snowflake >	threads
members_container	members
std::map< snowflake, voicestate >	voice_members
std::vector< snowflake >	emojis
welcome_screen_t	welcome_screen
uint32_t	max_presences
	the maximum number of presences for the guild. More...
uint32_t	max_members
	the maximum number of members for the guild More...
guild_nsfw_level_t	nsfw_level
	Guild NSFW level. 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 relavent to us as useful metadata. More...

Detailed Description

Represents a guild on Discord (AKA a server)

Constructor & Destructor Documentation

guild()

dpp::guild::guild

(

)

Default constructor, zeroes all values

~guild()

virtual dpp::guild::~guild ( )

virtualdefault

Destroy the guild object.

Member Function Documentation

base_permissions()

uint64_t dpp::guild::base_permissions

(

const class user *

member

)

const

Get the base permissions for a member on this guild, before permission overwrites are applied.

Parameters

member

member to get permissions for

Returns

uint64_t permissions bitmask

build_json()

std::string dpp::guild::build_json

(

bool

with_id = false

)

const

Build a JSON string from this object.

Parameters

with_id

True if an ID is to be included in the JSON

Returns

JSON string

connect_member_voice()

bool dpp::guild::connect_member_voice	(	snowflake	user_id,
		bool	self_mute = false,
		bool	self_deaf = false
	)

Connect to a voice channel another guild member is in.

Parameters

user_id	User id to join
self_mute	True if the bot should mute itself
self_deaf	True if the bot should deafen itself

Returns

True if the user specified is in a vc, false if they aren't

fill_from_json()

guild & dpp::guild::fill_from_json	(	class discord_client *	shard,
		nlohmann::json *	j
	)

Read class values from json object

Parameters

shard	originating shard
j	A json object to read from

Returns

A reference to self

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.

has_animated_banner_icon_hash()

bool dpp::guild::has_animated_banner_icon_hash

(

)

const

Guild banner is animated gif.

Returns

bool is animated gif

has_animated_icon()

bool dpp::guild::has_animated_icon

(

)

const

Guild can have an animated icon.

Returns

bool can have animated icon

has_animated_icon_hash()

bool dpp::guild::has_animated_icon_hash

(

)

const

Guild icon is actually an animated gif.

Returns

bool is animated gif

has_banner()

bool dpp::guild::has_banner

(

)

const

Guild has a banner image.

Returns

bool has banner image

has_channel_banners()

bool dpp::guild::has_channel_banners

(

)

const

guild has access to channel banners feature

Returns

bool has channel banners

has_commerce()

bool dpp::guild::has_commerce

(

)

const

Guild has commerce channels.

Returns

bool has commerce guilds

has_invite_splash()

bool dpp::guild::has_invite_splash

(

)

const

Guild has an invite splash.

Returns

bool has an invite splash

has_member_verification_gate()

bool dpp::guild::has_member_verification_gate

(

)

const

Guild has membership screening.

Returns

bool has membership screening

has_monetization_enabled()

bool dpp::guild::has_monetization_enabled

(

)

const

guild has access to monetization features

Returns

bool

has_more_stickers()

bool dpp::guild::has_more_stickers

(

)

const

guild has increased custom sticker slots

Returns

bool has more stickers

has_news()

bool dpp::guild::has_news

(

)

const

Guild has news channels.

Returns

bool has news channels

has_private_threads()

bool dpp::guild::has_private_threads

(

)

const

guild has access to create private threads

Returns

bool has private threads

has_role_icons()

bool dpp::guild::has_role_icons

(

)

const

guild is able to set role icons

Returns

bool has role icons

has_seven_day_thread_archive()

bool dpp::guild::has_seven_day_thread_archive

(

)

const

guild has access to the seven day archive time for threads

Returns

bool has seven day thread archive

has_three_day_thread_archive()

bool dpp::guild::has_three_day_thread_archive

(

)

const

guild has access to the three day archive time for threads

Returns

bool has three day thread archive

has_ticketed_events()

bool dpp::guild::has_ticketed_events

(

)

const

guild has enabled ticketed events

Returns

bool has ticketed events

has_vanity_url()

bool dpp::guild::has_vanity_url

(

)

const

Guild can have a vanity url.

Returns

bool can have vanity url

has_vip_regions()

bool dpp::guild::has_vip_regions

(

)

const

Guild has VIP voice regions.

Returns

bool has vip regions

is_community()

bool dpp::guild::is_community

(

)

const

Has enabled community.

Returns

bool has enabled community

is_discoverable()

bool dpp::guild::is_discoverable

(

)

const

Guild is discoverable.

Returns

bool is discoverable

is_featureable()

bool dpp::guild::is_featureable

(

)

const

Guild is featurable.

Returns

bool is featurable

is_large()

bool dpp::guild::is_large

(

)

const

Is a large server (>250 users)

Returns

bool is a large guild

is_partnered()

bool dpp::guild::is_partnered

(

)

const

Guild is a discord partnered server.

Returns

bool is discord partnered

is_preview_enabled()

bool dpp::guild::is_preview_enabled

(

)

const

Guild has preview enabled.

Returns

bool has preview

is_unavailable()

bool dpp::guild::is_unavailable

(

)

const

Is unavailable due to outage (most other fields will be blank or outdated.

Returns

bool is unavailable

is_verified()

bool dpp::guild::is_verified

(

)

const

Guild is a verified server.

Returns

bool is verified

is_welcome_screen_enabled()

bool dpp::guild::is_welcome_screen_enabled

(

)

const

Guild has enabled the welcome screen.

Returns

bool enabled welcome screen

permission_overwrites()

uint64_t dpp::guild::permission_overwrites	(	const uint64_t	base_permissions,
		const user *	member,
		const channel *	channel
	)		const

Get the permission overwrites for a member merged into a bitmask.

Parameters

base_permissions	base permissions before overwrites, from channel::base_permissions
member	Member to fetch permissions for
channel	Channel to fetch permissions against

Returns

uint64_t Merged permissions bitmask of overwrites.

rehash_members()

void dpp::guild::rehash_members

(

)

Rehash members map.

set_name()

guild & dpp::guild::set_name

(

const std::string &

n

)

Set the name of the guild in the object Min length: 2, Max length: 100 (not including leading/trailing spaces)

Parameters

n	Guild name

Returns

guild& reference to self

Exceptions

dpp::length_exception

if guild name is too short

widget_enabled()

bool dpp::guild::widget_enabled

(

)

const

Widget is enabled for this server.

Returns

bool widget enabled

Member Data Documentation

afk_channel_id

snowflake dpp::guild::afk_channel_id

Snowflake ID of AFK voice channel or 0

afk_timeout

uint8_t dpp::guild::afk_timeout

Voice AFK timeout before moving users to AFK channel

application_id

snowflake dpp::guild::application_id

ID of creating application, if any, or 0

banner

utility::iconhash dpp::guild::banner

Server banner hash

channels

std::vector<snowflake> dpp::guild::channels

List of channels on this server

default_message_notifications

uint8_t dpp::guild::default_message_notifications

Setting for how notifications are to be delivered to users

description

std::string dpp::guild::description

Server description for communities

discovery_splash

utility::iconhash dpp::guild::discovery_splash

Guild discovery splash hash

emojis

std::vector<snowflake> dpp::guild::emojis

List of emojis

explicit_content_filter

guild_explicit_content_t dpp::guild::explicit_content_filter

Whether or not explicit content filtering is enable and what setting it is

flags

uint32_t dpp::guild::flags

Flags bitmask as defined by values within dpp::guild_flags

icon

utility::iconhash dpp::guild::icon

Guild icon hash

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 relavent to us as useful metadata.

max_members

uint32_t dpp::guild::max_members

the maximum number of members for the guild

max_presences

uint32_t dpp::guild::max_presences

the maximum number of presences for the guild.

Note

Generally Discord always fills this with 0, apart from for the largest of guilds

max_video_channel_users

uint16_t dpp::guild::max_video_channel_users

Maximum users in a video channel, or 0

member_count

uint32_t dpp::guild::member_count

Approximate member count. May be sent as zero

members

members_container dpp::guild::members

List of guild members. Note that when you first receive the guild create event, this may be empty or near empty. This depends upon your dpp::intents and the size of your bot. It will be filled by guild member chunk requests.

mfa_level

mfa_level_t dpp::guild::mfa_level

If multi factor authentication is required for moderators or not

name

std::string dpp::guild::name

Guild name

nsfw_level

guild_nsfw_level_t dpp::guild::nsfw_level

Guild NSFW level.

owner_id

snowflake dpp::guild::owner_id

Snowflake id of guild owner

premium_subscription_count

uint16_t dpp::guild::premium_subscription_count

Number of boosters

premium_tier

uint8_t dpp::guild::premium_tier

Boost level

public_updates_channel_id

snowflake dpp::guild::public_updates_channel_id

Public updates channel id or 0

roles

std::vector<snowflake> dpp::guild::roles

Roles defined on this server

rules_channel_id

snowflake dpp::guild::rules_channel_id

ID of rules channel for communities

shard_id

uint16_t dpp::guild::shard_id

Shard ID of the guild

splash

utility::iconhash dpp::guild::splash

Guild splash hash

system_channel_id

snowflake dpp::guild::system_channel_id

ID of system channel where discord update messages are sent

threads

std::vector<snowflake> dpp::guild::threads

List of threads on this server

vanity_url_code

std::string dpp::guild::vanity_url_code

Vanity url code for verified or partnered servers and boost level 3.

Note

This field cannot be set from the API. Attempts to change this value will be silently ignored even if the correct number of boosts or verified/partnered status exist. See: https://github.com/discord/discord-api-docs/issues/519

verification_level

verification_level_t dpp::guild::verification_level

Verification level of server

voice_members

std::map<snowflake, voicestate> dpp::guild::voice_members

List of members in voice channels in the guild.

welcome_screen

welcome_screen_t dpp::guild::welcome_screen

Welcome screen

widget_channel_id

snowflake dpp::guild::widget_channel_id

Snowflake ID of widget channel, or 0