discord.h

Go to the documentation of this file.

 
#ifndef DISCORD_H
#define DISCORD_H
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
#include <inttypes.h>
#include <stdbool.h>
 
#include "error.h"
#include "types.h"
#include "concord-once.h"
#include "io_poller.h"
 
#ifndef DISCORD_VERSION
#define DISCORD_VERSION "10"
#endif
 
#define DISCORD_API_BASE_URL       "https://discord.com/api/v" DISCORD_VERSION
#define DISCORD_GATEWAY_URL_SUFFIX "?v=" DISCORD_VERSION "&encoding=json"
 
/* forward declaration */
struct discord;
 
 
#include "discord_codecs.h"
#ifdef CCORD_VOICE
#include "discord-voice.h"
#endif /* CCORD_VOICE */
#include "discord-response.h"
 
#define DISCORD_MAX_NAME_LEN          4 * 100 + 1
#define DISCORD_MAX_TOPIC_LEN         4 * 1024 + 1
#define DISCORD_MAX_DESCRIPTION_LEN   4 * 2048 + 1
#define DISCORD_MAX_USERNAME_LEN      4 * 32 + 1
#define DISCORD_MAX_DISCRIMINATOR_LEN 4 + 1
#define DISCORD_MAX_REASON_LEN        4 * 512 + 1
#define DISCORD_MAX_MESSAGE_LEN       4 * 2000 + 1
#define DISCORD_MAX_PAYLOAD_LEN       4 * 4096 + 1
#define DISCORD_EMBED_TITLE_LEN       4 * 256 + 1
#define DISCORD_EMBED_DESCRIPTION_LEN 4 * 4096 + 1
#define DISCORD_EMBED_MAX_FIELDS      25
#define DISCORD_EMBED_FIELD_NAME_LEN  4 * 256 + 1
#define DISCORD_EMBED_FIELD_VALUE_LEN 4 * 1024 + 1
#define DISCORD_EMBED_FOOTER_TEXT_LEN 4 * 2048 + 1
#define DISCORD_EMBED_AUTHOR_NAME_LEN 4 * 256 + 1
#define DISCORD_WEBHOOK_NAME_LEN 4 * 80 + 1
CCORDcode discord_return_error(struct discord *client,
                               const char error[],
                               CCORDcode code);
 
const char *discord_strerror(CCORDcode code, struct discord *client);
 
#include "audit_log.h"
#include "auto_moderation.h"
#include "invite.h"
#include "channel.h"
#include "emoji.h"
#include "guild.h"
#include "guild_scheduled_event.h"
#include "guild_template.h"
#include "stage_instance.h"
#include "sticker.h"
#include "user.h"
#include "voice.h"
#include "webhook.h"
#include "gateway.h"
#include "oauth2.h"
#include "application_command.h"
#include "interaction.h"
#include "discord-cache.h"
#include "discord-events.h"
 
#define discord_claim(client, data) (__discord_claim(client, data), data)
void __discord_claim(struct discord *client, const void *data);
 
void discord_unclaim(struct discord *client, const void *data);
 
struct discord *discord_init(const char token[]);
 
struct discord *discord_config_init(const char config_file[]);
 
struct ccord_szbuf_readonly discord_config_get_field(struct discord *client,
                                                     char *const path[],
                                                     unsigned depth);
 
struct discord *discord_clone(const struct discord *orig);
 
void discord_cleanup(struct discord *client);
 
const struct discord_user *discord_get_self(struct discord *client);
 
CCORDcode discord_run(struct discord *client);
 
void discord_shutdown(struct discord *client);
 
void discord_reconnect(struct discord *client, bool resume);
 
void *discord_set_data(struct discord *client, void *data);
 
void *discord_get_data(struct discord *client);
 
int discord_get_ping(struct discord *client);
 
uint64_t discord_timestamp(struct discord *client);
 
uint64_t discord_timestamp_us(struct discord *client);
 
struct logconf *discord_get_logconf(struct discord *client);
 
struct io_poller *discord_get_io_poller(struct discord *client);
 
/* forward declaration */
struct discord_timer;
 
 
typedef void (*discord_ev_timer)(struct discord *client,
                                 struct discord_timer *ev);
 
enum discord_timer_flags {
    DISCORD_TIMER_MILLISECONDS = 0,
    DISCORD_TIMER_MICROSECONDS = 1 << 0,
    DISCORD_TIMER_DELETE = 1 << 1,
    DISCORD_TIMER_DELETE_AUTO = 1 << 2,
    DISCORD_TIMER_CANCELED = 1 << 3,
    DISCORD_TIMER_TICK = 1 << 4,
    DISCORD_TIMER_GET = 1 << 5,
    DISCORD_TIMER_INTERVAL_FIXED = 1 << 6,
};
 
struct discord_timer {
    unsigned id;
    enum discord_timer_flags flags;
    discord_ev_timer on_tick;
    discord_ev_timer on_status_changed;
    void *data;
    int64_t delay;
    int64_t interval;
    int64_t repeat;
};
 
unsigned discord_timer_ctl(struct discord *client,
                           struct discord_timer *timer);
 
unsigned discord_timer(struct discord *client,
                       discord_ev_timer on_tick_cb,
                       discord_ev_timer on_status_changed_cb,
                       void *data,
                       int64_t delay);
 
unsigned discord_timer_interval(struct discord *client,
                                discord_ev_timer on_tick_cb,
                                discord_ev_timer on_status_changed_cb,
                                void *data,
                                int64_t delay,
                                int64_t interval,
                                int64_t repeat);
 
bool discord_timer_get(struct discord *client,
                       unsigned id,
                       struct discord_timer *timer);
 
bool discord_timer_start(struct discord *client, unsigned id);
 
bool discord_timer_stop(struct discord *client, unsigned id);
 
bool discord_timer_cancel(struct discord *client, unsigned id);
 
bool discord_timer_delete(struct discord *client, unsigned id);
 
bool discord_timer_cancel_and_delete(struct discord *client, unsigned id);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* DISCORD_H */