deltachat_8h_source.html

#ifndef __DELTACHAT_H__

#define __DELTACHAT_H__

#ifdef __cplusplus

extern "C" {

#endif


#ifndef PY_CFFI

#include <stdint.h>

#include <time.h>

#endif


typedef struct _dc_context   dc_context_t;

typedef struct _dc_accounts  dc_accounts_t;

typedef struct _dc_array     dc_array_t;

typedef struct _dc_chatlist  dc_chatlist_t;

typedef struct _dc_chat      dc_chat_t;

typedef struct _dc_msg       dc_msg_t;

typedef struct _dc_contact   dc_contact_t;

typedef struct _dc_lot       dc_lot_t;

typedef struct _dc_provider  dc_provider_t;

typedef struct _dc_event     dc_event_t;

typedef struct _dc_event_emitter dc_event_emitter_t;

typedef struct _dc_jsonrpc_instance dc_jsonrpc_instance_t;

typedef struct _dc_backup_provider dc_backup_provider_t;


// Alias for backwards compatibility, use dc_event_emitter_t instead.

typedef struct _dc_event_emitter dc_accounts_event_emitter_t;


// create/open/config/information


dc_context_t*   dc_context_new               (const char* os_name, const char* dbfile, const char* blobdir);


dc_context_t*   dc_context_new_closed        (const char* dbfile);


int             dc_context_open              (dc_context_t *context, const char* passphrase);


int             dc_context_change_passphrase (dc_context_t* context, const char* passphrase);


int             dc_context_is_open           (dc_context_t *context);


void            dc_context_unref             (dc_context_t* context);


uint32_t        dc_get_id                    (dc_context_t* context);


dc_event_emitter_t* dc_get_event_emitter(dc_context_t* context);


char*           dc_get_blobdir               (const dc_context_t* context);


int             dc_set_config                (dc_context_t* context, const char* key, const char* value);


char*           dc_get_config                (dc_context_t* context, const char* key);


int             dc_set_stock_translation(dc_context_t* context, uint32_t stock_id, const char* stock_msg);


int             dc_set_config_from_qr   (dc_context_t* context, const char* qr);


char*           dc_get_info                  (const dc_context_t* context);


char*           dc_get_oauth2_url            (dc_context_t* context, const char* addr, const char* redirect_uri);


#define DC_CONNECTIVITY_NOT_CONNECTED        1000

#define DC_CONNECTIVITY_CONNECTING           2000

#define DC_CONNECTIVITY_WORKING              3000

#define DC_CONNECTIVITY_CONNECTED            4000


int             dc_get_connectivity          (dc_context_t* context);


char*           dc_get_connectivity_html     (dc_context_t* context);


#define DC_PUSH_NOT_CONNECTED 0

#define DC_PUSH_HEARTBEAT     1

#define DC_PUSH_CONNECTED     2


int              dc_get_push_state           (dc_context_t* context);


// connect


void            dc_configure                 (dc_context_t* context);


int             dc_is_configured   (const dc_context_t* context);


void            dc_start_io     (dc_context_t* context);


void            dc_stop_io(dc_context_t* context);


void            dc_maybe_network             (dc_context_t* context);


int             dc_preconfigure_keypair        (dc_context_t* context, const char *secret_data);


// handle chatlists


#define         DC_GCL_ARCHIVED_ONLY         0x01

#define         DC_GCL_NO_SPECIALS           0x02

#define         DC_GCL_ADD_ALLDONE_HINT      0x04

#define         DC_GCL_FOR_FORWARDING        0x08


dc_chatlist_t*  dc_get_chatlist              (dc_context_t* context, int flags, const char* query_str, uint32_t query_id);


// handle chats


uint32_t        dc_create_chat_by_contact_id (dc_context_t* context, uint32_t contact_id);


uint32_t        dc_get_chat_id_by_contact_id (dc_context_t* context, uint32_t contact_id);


uint32_t        dc_send_msg                  (dc_context_t* context, uint32_t chat_id, dc_msg_t* msg);


uint32_t        dc_send_msg_sync                  (dc_context_t* context, uint32_t chat_id, dc_msg_t* msg);


uint32_t        dc_send_text_msg             (dc_context_t* context, uint32_t chat_id, const char* text_to_send);


void            dc_send_edit_request         (dc_context_t* context, uint32_t msg_id, const char* new_text);


 void            dc_send_delete_request       (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);


uint32_t dc_send_videochat_invitation (dc_context_t* context, uint32_t chat_id);


int dc_send_webxdc_status_update (dc_context_t* context, uint32_t msg_id, const char* json, const char* descr);


char* dc_get_webxdc_status_updates (dc_context_t* context, uint32_t msg_id, uint32_t serial);


void             dc_set_webxdc_integration (dc_context_t* context, const char* file);


uint32_t        dc_init_webxdc_integration    (dc_context_t* context, uint32_t chat_id);


void            dc_set_draft                 (dc_context_t* context, uint32_t chat_id, dc_msg_t* msg);


uint32_t        dc_add_device_msg            (dc_context_t* context, const char* label, dc_msg_t* msg);


int             dc_was_device_msg_ever_added (dc_context_t* context, const char* label);


dc_msg_t*       dc_get_draft                 (dc_context_t* context, uint32_t chat_id);


#define         DC_GCM_ADDDAYMARKER          0x01

#define         DC_GCM_INFO_ONLY             0x02


dc_array_t*     dc_get_chat_msgs             (dc_context_t* context, uint32_t chat_id, uint32_t flags, uint32_t marker1before);


int             dc_get_msg_cnt               (dc_context_t* context, uint32_t chat_id);


int             dc_get_fresh_msg_cnt         (dc_context_t* context, uint32_t chat_id);


dc_chatlist_t*     dc_get_similar_chatlist   (dc_context_t* context, uint32_t chat_id);


int             dc_estimate_deletion_cnt    (dc_context_t* context, int from_server, int64_t seconds);


dc_array_t*     dc_get_fresh_msgs            (dc_context_t* context);


dc_array_t*     dc_get_next_msgs             (dc_context_t* context);


dc_array_t*     dc_wait_next_msgs            (dc_context_t* context);


void            dc_marknoticed_chat          (dc_context_t* context, uint32_t chat_id);


dc_array_t*     dc_get_chat_media            (dc_context_t* context, uint32_t chat_id, int msg_type, int msg_type2, int msg_type3);


void            dc_set_chat_visibility       (dc_context_t* context, uint32_t chat_id, int visibility);


void            dc_delete_chat               (dc_context_t* context, uint32_t chat_id);


void            dc_block_chat                (dc_context_t* context, uint32_t chat_id);


void            dc_accept_chat               (dc_context_t* context, uint32_t chat_id);


dc_array_t*     dc_get_chat_contacts         (dc_context_t* context, uint32_t chat_id);


char*           dc_get_chat_encrinfo (dc_context_t* context, uint32_t chat_id);


uint32_t dc_get_chat_ephemeral_timer (dc_context_t* context, uint32_t chat_id);


dc_array_t*     dc_search_msgs               (dc_context_t* context, uint32_t chat_id, const char* query);


dc_chat_t*      dc_get_chat                  (dc_context_t* context, uint32_t chat_id);


// handle group chats


uint32_t        dc_create_group_chat         (dc_context_t* context, int protect, const char* name);


uint32_t        dc_create_broadcast_list     (dc_context_t* context);


int             dc_is_contact_in_chat        (dc_context_t* context, uint32_t chat_id, uint32_t contact_id);


int             dc_add_contact_to_chat       (dc_context_t* context, uint32_t chat_id, uint32_t contact_id);


int             dc_remove_contact_from_chat  (dc_context_t* context, uint32_t chat_id, uint32_t contact_id);


int             dc_set_chat_name             (dc_context_t* context, uint32_t chat_id, const char* name);


int dc_set_chat_ephemeral_timer (dc_context_t* context, uint32_t chat_id, uint32_t timer);


int             dc_set_chat_profile_image    (dc_context_t* context, uint32_t chat_id, const char* image);


int             dc_set_chat_mute_duration             (dc_context_t* context, uint32_t chat_id, int64_t duration);


// handle messages


char*           dc_get_msg_info              (dc_context_t* context, uint32_t msg_id);


char*           dc_get_msg_html              (dc_context_t* context, uint32_t msg_id);


void dc_download_full_msg (dc_context_t* context, int msg_id);


void            dc_delete_msgs               (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);


void            dc_forward_msgs              (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);


void            dc_save_msgs                 (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);


int             dc_resend_msgs               (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);


void            dc_markseen_msgs             (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);


dc_msg_t*       dc_get_msg                   (dc_context_t* context, uint32_t msg_id);


// handle contacts


int             dc_may_be_valid_addr         (const char* addr);


uint32_t        dc_lookup_contact_id_by_addr (dc_context_t* context, const char* addr);


uint32_t        dc_create_contact            (dc_context_t* context, const char* name, const char* addr);


// Deprecated 2025-05-20, setting this flag is a no-op.

#define         DC_GCL_DEPRECATED_VERIFIED_ONLY         0x01


#define         DC_GCL_ADD_SELF              0x02


int             dc_add_address_book          (dc_context_t* context, const char* addr_book);


char*           dc_make_vcard                (dc_context_t* context, uint32_t contact_id);


dc_array_t*     dc_import_vcard              (dc_context_t* context, const char* vcard);


dc_array_t*     dc_get_contacts              (dc_context_t* context, uint32_t flags, const char* query);


int             dc_get_blocked_cnt           (dc_context_t* context);


dc_array_t*     dc_get_blocked_contacts      (dc_context_t* context);


void            dc_block_contact             (dc_context_t* context, uint32_t contact_id, int block);


char*           dc_get_contact_encrinfo      (dc_context_t* context, uint32_t contact_id);


int             dc_delete_contact            (dc_context_t* context, uint32_t contact_id);


dc_contact_t*   dc_get_contact               (dc_context_t* context, uint32_t contact_id);


// import/export and tools


#define         DC_IMEX_EXPORT_SELF_KEYS      1 // param1 is a directory where the keys are written to

#define         DC_IMEX_IMPORT_SELF_KEYS      2 // param1 is a directory where the keys are searched in and read from

#define         DC_IMEX_EXPORT_BACKUP        11 // param1 is a directory where the backup is written to, param2 is a passphrase to encrypt the backup

#define         DC_IMEX_IMPORT_BACKUP        12 // param1 is the file with the backup to import, param2 is the backup's passphrase


void            dc_imex                      (dc_context_t* context, int what, const char* param1, const char* param2);


char*           dc_imex_has_backup           (dc_context_t* context, const char* dir);


char*           dc_initiate_key_transfer     (dc_context_t* context);


int             dc_continue_key_transfer     (dc_context_t* context, uint32_t msg_id, const char* setup_code);


void            dc_stop_ongoing_process      (dc_context_t* context);


// out-of-band verification


#define         DC_QR_ASK_VERIFYCONTACT      200 // id=contact

#define         DC_QR_ASK_VERIFYGROUP        202 // text1=groupname

#define         DC_QR_FPR_OK                 210 // id=contact

#define         DC_QR_FPR_MISMATCH           220 // id=contact

#define         DC_QR_FPR_WITHOUT_ADDR       230 // test1=formatted fingerprint

#define         DC_QR_ACCOUNT                250 // text1=domain

#define         DC_QR_BACKUP                 251 // deprecated

#define         DC_QR_BACKUP2                252

#define         DC_QR_BACKUP_TOO_NEW         255

#define         DC_QR_WEBRTC_INSTANCE        260 // text1=domain, text2=instance pattern

#define         DC_QR_PROXY                  271 // text1=address (e.g. "127.0.0.1:9050")

#define         DC_QR_ADDR                   320 // id=contact

#define         DC_QR_TEXT                   330 // text1=text

#define         DC_QR_URL                    332 // text1=URL

#define         DC_QR_ERROR                  400 // text1=error string

#define         DC_QR_WITHDRAW_VERIFYCONTACT 500

#define         DC_QR_WITHDRAW_VERIFYGROUP   502 // text1=groupname

#define         DC_QR_REVIVE_VERIFYCONTACT   510

#define         DC_QR_REVIVE_VERIFYGROUP     512 // text1=groupname

#define         DC_QR_LOGIN                  520 // text1=email_address


dc_lot_t*       dc_check_qr                  (dc_context_t* context, const char* qr);


char*           dc_get_securejoin_qr         (dc_context_t* context, uint32_t chat_id);


char*           dc_get_securejoin_qr_svg         (dc_context_t* context, uint32_t chat_id);


uint32_t        dc_join_securejoin           (dc_context_t* context, const char* qr);


// location streaming


void        dc_send_locations_to_chat       (dc_context_t* context, uint32_t chat_id, int seconds);


int         dc_is_sending_locations_to_chat (dc_context_t* context, uint32_t chat_id);


int         dc_set_location                 (dc_context_t* context, double latitude, double longitude, double accuracy);


dc_array_t* dc_get_locations                (dc_context_t* context, uint32_t chat_id, uint32_t contact_id, int64_t timestamp_begin, int64_t timestamp_end);


void        dc_delete_all_locations         (dc_context_t* context);


// misc


char*           dc_create_qr_svg             (const char* payload);


char* dc_get_last_error (dc_context_t* context);


void dc_str_unref (char* str);


dc_backup_provider_t* dc_backup_provider_new (dc_context_t* context);


char* dc_backup_provider_get_qr (const dc_backup_provider_t* backup_provider);


char* dc_backup_provider_get_qr_svg (const dc_backup_provider_t* backup_provider);


void dc_backup_provider_wait (dc_backup_provider_t* backup_provider);


void dc_backup_provider_unref (dc_backup_provider_t* backup_provider);


int dc_receive_backup (dc_context_t* context, const char* qr);


dc_accounts_t* dc_accounts_new                  (const char* dir, int writable);


void           dc_accounts_unref                (dc_accounts_t* accounts);


uint32_t       dc_accounts_add_account          (dc_accounts_t* accounts);


uint32_t       dc_accounts_add_closed_account   (dc_accounts_t* accounts);


uint32_t       dc_accounts_migrate_account      (dc_accounts_t* accounts, const char* dbfile);


int            dc_accounts_remove_account       (dc_accounts_t* accounts, uint32_t account_id);


dc_array_t*    dc_accounts_get_all              (dc_accounts_t* accounts);


dc_context_t*  dc_accounts_get_account          (dc_accounts_t* accounts, uint32_t account_id);


dc_context_t*  dc_accounts_get_selected_account (dc_accounts_t* accounts);


int            dc_accounts_select_account       (dc_accounts_t* accounts, uint32_t account_id);


void           dc_accounts_start_io             (dc_accounts_t* accounts);


void           dc_accounts_stop_io              (dc_accounts_t* accounts);


void           dc_accounts_maybe_network        (dc_accounts_t* accounts);


void           dc_accounts_maybe_network_lost    (dc_accounts_t* accounts);


int            dc_accounts_background_fetch    (dc_accounts_t* accounts, uint64_t timeout);


void           dc_accounts_set_push_device_token (dc_accounts_t* accounts, const char *token);


dc_event_emitter_t* dc_accounts_get_event_emitter (dc_accounts_t* accounts);


void             dc_array_unref              (dc_array_t* array);


size_t           dc_array_get_cnt            (const dc_array_t* array);


uint32_t         dc_array_get_id             (const dc_array_t* array, size_t index);


double           dc_array_get_latitude       (const dc_array_t* array, size_t index);


double           dc_array_get_longitude      (const dc_array_t* array, size_t index);


double           dc_array_get_accuracy       (const dc_array_t* array, size_t index);


int64_t           dc_array_get_timestamp      (const dc_array_t* array, size_t index);


uint32_t         dc_array_get_chat_id        (const dc_array_t* array, size_t index);


uint32_t         dc_array_get_contact_id     (const dc_array_t* array, size_t index);


uint32_t         dc_array_get_msg_id         (const dc_array_t* array, size_t index);


char*            dc_array_get_marker         (const dc_array_t* array, size_t index);


int              dc_array_is_independent     (const dc_array_t* array, size_t index);


int              dc_array_search_id          (const dc_array_t* array, uint32_t needle, size_t* ret_index);


void             dc_chatlist_unref           (dc_chatlist_t* chatlist);


size_t           dc_chatlist_get_cnt         (const dc_chatlist_t* chatlist);


uint32_t         dc_chatlist_get_chat_id     (const dc_chatlist_t* chatlist, size_t index);


uint32_t         dc_chatlist_get_msg_id      (const dc_chatlist_t* chatlist, size_t index);


dc_lot_t*        dc_chatlist_get_summary     (const dc_chatlist_t* chatlist, size_t index, dc_chat_t* chat);


dc_lot_t*        dc_chatlist_get_summary2    (dc_context_t* context, uint32_t chat_id, uint32_t msg_id);


dc_context_t*    dc_chatlist_get_context     (dc_chatlist_t* chatlist);


char*            dc_chat_get_info_json       (dc_context_t* context, size_t chat_id);


#define         DC_CHAT_ID_TRASH             3 // messages that should be deleted get this chat ID; the messages are deleted from the working thread later then. This is also needed as rfc724_mid should be preset as long as the message is not deleted on the server (otherwise it is downloaded again)

#define         DC_CHAT_ID_ARCHIVED_LINK     6 // only an indicator in a chatlist

#define         DC_CHAT_ID_ALLDONE_HINT      7 // only an indicator in a chatlist

#define         DC_CHAT_ID_LAST_SPECIAL      9 // larger chat IDs are "real" chats, their messages are "real" messages


void            dc_chat_unref                (dc_chat_t* chat);


uint32_t        dc_chat_get_id               (const dc_chat_t* chat);


int             dc_chat_get_type             (const dc_chat_t* chat);


char*           dc_chat_get_mailinglist_addr (const dc_chat_t* chat);


char*           dc_chat_get_name             (const dc_chat_t* chat);


char*           dc_chat_get_profile_image    (const dc_chat_t* chat);


uint32_t        dc_chat_get_color            (const dc_chat_t* chat);


int             dc_chat_get_visibility       (const dc_chat_t* chat);


int             dc_chat_is_contact_request   (const dc_chat_t* chat);


int             dc_chat_is_unpromoted        (const dc_chat_t* chat);


int             dc_chat_is_self_talk         (const dc_chat_t* chat);


int             dc_chat_is_device_talk       (const dc_chat_t* chat);


int             dc_chat_can_send              (const dc_chat_t* chat);


int             dc_chat_is_protected         (const dc_chat_t* chat);


int             dc_chat_is_encrypted         (const dc_chat_t *chat);


int             dc_chat_is_protection_broken (const dc_chat_t* chat);


int             dc_chat_is_sending_locations (const dc_chat_t* chat);


int             dc_chat_is_muted (const dc_chat_t* chat);


int64_t          dc_chat_get_remaining_mute_duration (const dc_chat_t* chat);


#define         DC_MSG_ID_MARKER1            1 // this is used by iOS to mark things in the message list

#define         DC_MSG_ID_DAYMARKER          9

#define         DC_MSG_ID_LAST_SPECIAL       9


dc_msg_t*       dc_msg_new                    (dc_context_t* context, int viewtype);


void            dc_msg_unref                  (dc_msg_t* msg);


uint32_t        dc_msg_get_id                 (const dc_msg_t* msg);


uint32_t        dc_msg_get_from_id            (const dc_msg_t* msg);


uint32_t        dc_msg_get_chat_id            (const dc_msg_t* msg);


int             dc_msg_get_viewtype           (const dc_msg_t* msg);


int             dc_msg_get_state              (const dc_msg_t* msg);


int64_t          dc_msg_get_timestamp          (const dc_msg_t* msg);


int64_t          dc_msg_get_received_timestamp (const dc_msg_t* msg);


int64_t          dc_msg_get_sort_timestamp     (const dc_msg_t* msg);


char*           dc_msg_get_text               (const dc_msg_t* msg);


char*           dc_msg_get_subject            (const dc_msg_t* msg);


char*           dc_msg_get_file               (const dc_msg_t* msg);


int             dc_msg_save_file              (const dc_msg_t* msg, const char* path);


char*           dc_msg_get_filename           (const dc_msg_t* msg);


char*           dc_msg_get_filemime           (const dc_msg_t* msg);


char*             dc_msg_get_webxdc_blob      (const dc_msg_t* msg, const char* filename, size_t* ret_bytes);


char*             dc_msg_get_webxdc_info      (const dc_msg_t* msg);


uint64_t        dc_msg_get_filebytes          (const dc_msg_t* msg);


int             dc_msg_get_width              (const dc_msg_t* msg);


int             dc_msg_get_height             (const dc_msg_t* msg);


int             dc_msg_get_duration           (const dc_msg_t* msg);


int             dc_msg_get_showpadlock        (const dc_msg_t* msg);


int             dc_msg_is_bot                 (const dc_msg_t* msg);


uint32_t        dc_msg_get_ephemeral_timer    (const dc_msg_t* msg);


int64_t          dc_msg_get_ephemeral_timestamp (const dc_msg_t* msg);


dc_lot_t*       dc_msg_get_summary            (const dc_msg_t* msg, const dc_chat_t* chat);


char*           dc_msg_get_summarytext        (const dc_msg_t* msg, int approx_characters);


char*           dc_msg_get_override_sender_name(const dc_msg_t* msg);


int             dc_msg_has_deviating_timestamp(const dc_msg_t* msg);


int             dc_msg_has_location           (const dc_msg_t* msg);


int             dc_msg_is_sent                (const dc_msg_t* msg);


int             dc_msg_is_forwarded           (const dc_msg_t* msg);


 int             dc_msg_is_edited             (const dc_msg_t* msg);


int             dc_msg_is_info                (const dc_msg_t* msg);


int             dc_msg_get_info_type          (const dc_msg_t* msg);


uint32_t        dc_msg_get_info_contact_id    (const dc_msg_t* msg);


// DC_INFO* uses the same values as SystemMessage in rust-land

#define         DC_INFO_UNKNOWN                    0

#define         DC_INFO_GROUP_NAME_CHANGED         2

#define         DC_INFO_GROUP_IMAGE_CHANGED        3

#define         DC_INFO_MEMBER_ADDED_TO_GROUP      4

#define         DC_INFO_MEMBER_REMOVED_FROM_GROUP  5

#define         DC_INFO_AUTOCRYPT_SETUP_MESSAGE    6

#define         DC_INFO_SECURE_JOIN_MESSAGE        7

#define         DC_INFO_LOCATIONSTREAMING_ENABLED  8

#define         DC_INFO_LOCATION_ONLY              9

#define         DC_INFO_EPHEMERAL_TIMER_CHANGED   10

#define         DC_INFO_PROTECTION_ENABLED        11

#define         DC_INFO_PROTECTION_DISABLED       12

#define         DC_INFO_INVALID_UNENCRYPTED_MAIL  13

#define         DC_INFO_WEBXDC_INFO_MESSAGE       32


char*           dc_msg_get_webxdc_href        (const dc_msg_t* msg);


int             dc_msg_is_setupmessage        (const dc_msg_t* msg);


char*           dc_msg_get_setupcodebegin     (const dc_msg_t* msg);


char*           dc_msg_get_videochat_url (const dc_msg_t* msg);


char*           dc_msg_get_error               (const dc_msg_t* msg);


int dc_msg_get_videochat_type (const dc_msg_t* msg);


#define DC_VIDEOCHATTYPE_UNKNOWN     0

#define DC_VIDEOCHATTYPE_BASICWEBRTC 1

#define DC_VIDEOCHATTYPE_JITSI       2


int dc_msg_has_html (dc_msg_t* msg);


int dc_msg_get_download_state (const dc_msg_t* msg);


void            dc_msg_set_text               (dc_msg_t* msg, const char* text);


void            dc_msg_set_html               (dc_msg_t* msg, const char* html);


void            dc_msg_set_subject            (dc_msg_t* msg, const char* subject);


void            dc_msg_set_override_sender_name(dc_msg_t* msg, const char* name);


void            dc_msg_set_file_and_deduplicate(dc_msg_t* msg, const char* file, const char* name, const char* filemime);


void            dc_msg_set_dimension          (dc_msg_t* msg, int width, int height);


void            dc_msg_set_duration           (dc_msg_t* msg, int duration);


void            dc_msg_set_location           (dc_msg_t* msg, double latitude, double longitude);


void            dc_msg_latefiling_mediasize   (dc_msg_t* msg, int width, int height, int duration);


void             dc_msg_set_quote             (dc_msg_t* msg, const dc_msg_t* quote);


char*           dc_msg_get_quoted_text        (const dc_msg_t* msg);


dc_msg_t*       dc_msg_get_quoted_msg         (const dc_msg_t* msg);


dc_msg_t*       dc_msg_get_parent             (const dc_msg_t* msg);


uint32_t        dc_msg_get_original_msg_id    (const dc_msg_t* msg);


uint32_t        dc_msg_get_saved_msg_id     (const dc_msg_t* msg);


void            dc_msg_force_plaintext        (dc_msg_t* msg);


#define         DC_CONTACT_ID_SELF           1

#define         DC_CONTACT_ID_INFO           2 // centered messages as "member added", used in all chats

#define         DC_CONTACT_ID_DEVICE         5 // messages "update info" in the device-chat

#define         DC_CONTACT_ID_LAST_SPECIAL   9


void            dc_contact_unref             (dc_contact_t* contact);


uint32_t        dc_contact_get_id            (const dc_contact_t* contact);


char*           dc_contact_get_addr          (const dc_contact_t* contact);


char*           dc_contact_get_name          (const dc_contact_t* contact);


char*           dc_contact_get_auth_name     (const dc_contact_t* contact);


char*           dc_contact_get_display_name  (const dc_contact_t* contact);


// dc_contact_get_first_name is removed,

// the following define is to make upgrading more smoothly.

#define         dc_contact_get_first_name    dc_contact_get_display_name


char*           dc_contact_get_name_n_addr   (const dc_contact_t* contact);


char*           dc_contact_get_profile_image (const dc_contact_t* contact);


uint32_t        dc_contact_get_color         (const dc_contact_t* contact);


char*           dc_contact_get_status        (const dc_contact_t* contact);


int64_t         dc_contact_get_last_seen     (const dc_contact_t* contact);


int             dc_contact_was_seen_recently (const dc_contact_t* contact);


int             dc_contact_is_blocked        (const dc_contact_t* contact);


int             dc_contact_is_verified       (dc_contact_t* contact);


int             dc_contact_is_bot            (dc_contact_t* contact);


int             dc_contact_is_key_contact    (dc_contact_t* contact);


uint32_t       dc_contact_get_verifier_id      (dc_contact_t* contact);


dc_provider_t*  dc_provider_new_from_email            (const dc_context_t* context, const char* email);


dc_provider_t*  dc_provider_new_from_email_with_dns    (const dc_context_t* context, const char* email);


char*           dc_provider_get_overview_page         (const dc_provider_t* provider);


char*           dc_provider_get_before_login_hint     (const dc_provider_t* provider);


int             dc_provider_get_status                (const dc_provider_t* provider);


void            dc_provider_unref                     (dc_provider_t* provider);


#define         DC_TEXT1_DRAFT     1

#define         DC_TEXT1_USERNAME  2

#define         DC_TEXT1_SELF      3


void            dc_lot_unref             (dc_lot_t* lot);


char*           dc_lot_get_text1         (const dc_lot_t* lot);


char*           dc_lot_get_text2         (const dc_lot_t* lot);


int             dc_lot_get_text1_meaning (const dc_lot_t* lot);


int             dc_lot_get_state         (const dc_lot_t* lot);


uint32_t        dc_lot_get_id            (const dc_lot_t* lot);


int64_t         dc_lot_get_timestamp     (const dc_lot_t* lot);


#define DC_MSG_TEXT      10


#define DC_MSG_IMAGE     20


#define DC_MSG_GIF       21


#define DC_MSG_STICKER     23


#define DC_MSG_AUDIO     40


#define DC_MSG_VOICE     41


#define DC_MSG_VIDEO     50


#define DC_MSG_FILE      60


#define DC_MSG_VIDEOCHAT_INVITATION 70


#define DC_MSG_WEBXDC    80


#define DC_MSG_VCARD     90


#define         DC_STATE_UNDEFINED           0


#define         DC_STATE_IN_FRESH            10


#define         DC_STATE_IN_NOTICED          13


#define         DC_STATE_IN_SEEN             16


#define         DC_STATE_OUT_PREPARING       18


#define         DC_STATE_OUT_DRAFT           19


#define         DC_STATE_OUT_PENDING         20


#define         DC_STATE_OUT_FAILED          24


#define         DC_STATE_OUT_DELIVERED       26


#define         DC_STATE_OUT_MDN_RCVD        28


#define         DC_CHAT_TYPE_UNDEFINED       0


#define         DC_CHAT_TYPE_SINGLE          100


#define         DC_CHAT_TYPE_GROUP           120


#define         DC_CHAT_TYPE_MAILINGLIST     140


#define         DC_CHAT_TYPE_BROADCAST       160


#define DC_SOCKET_AUTO 0


#define DC_SOCKET_SSL 1


#define DC_SOCKET_STARTTLS 2


#define DC_SOCKET_PLAIN 3


#define DC_LP_AUTH_OAUTH2                0x2


#define DC_LP_AUTH_NORMAL                0x4


#define DC_LP_AUTH_FLAGS        (DC_LP_AUTH_OAUTH2|DC_LP_AUTH_NORMAL) // if none of these flags are set, the default is chosen


#define DC_CERTCK_AUTO 0


#define DC_CERTCK_STRICT 1


#define DC_CERTCK_ACCEPT_INVALID 2


#define DC_CERTCK_ACCEPT_INVALID_CERTIFICATES 3


dc_jsonrpc_instance_t* dc_jsonrpc_init(dc_accounts_t* account_manager);


void dc_jsonrpc_unref(dc_jsonrpc_instance_t* jsonrpc_instance);


void dc_jsonrpc_request(dc_jsonrpc_instance_t* jsonrpc_instance, const char* request);


char* dc_jsonrpc_next_response(dc_jsonrpc_instance_t* jsonrpc_instance);


char* dc_jsonrpc_blocking_call(dc_jsonrpc_instance_t* jsonrpc_instance, const char *input);


dc_event_t* dc_get_next_event(dc_event_emitter_t* emitter);


// Alias for backwards compatibility, use dc_get_next_event instead.

#define dc_accounts_get_next_event dc_get_next_event


void  dc_event_emitter_unref(dc_event_emitter_t* emitter);


// Alias for backwards compatibility, use dc_event_emtitter_unref instead.

#define dc_accounts_event_emitter_unref dc_event_emitter_unref


int dc_event_get_id(dc_event_t* event);


int dc_event_get_data1_int(dc_event_t* event);


int dc_event_get_data2_int(dc_event_t* event);


char* dc_event_get_data1_str(dc_event_t* event);


char* dc_event_get_data2_str(dc_event_t* event);


uint32_t dc_event_get_account_id(dc_event_t* event);


void dc_event_unref(dc_event_t* event);


#define DC_EVENT_INFO                     100


#define DC_EVENT_SMTP_CONNECTED           101


#define DC_EVENT_IMAP_CONNECTED           102


#define DC_EVENT_SMTP_MESSAGE_SENT        103


#define DC_EVENT_IMAP_MESSAGE_DELETED   104


#define DC_EVENT_IMAP_MESSAGE_MOVED   105


#define DC_EVENT_IMAP_INBOX_IDLE 106


#define DC_EVENT_NEW_BLOB_FILE 150


#define DC_EVENT_DELETED_BLOB_FILE 151


#define DC_EVENT_WARNING                  300


#define DC_EVENT_ERROR                    400


#define DC_EVENT_ERROR_SELF_NOT_IN_GROUP  410


#define DC_EVENT_MSGS_CHANGED             2000


#define DC_EVENT_REACTIONS_CHANGED        2001


#define DC_EVENT_INCOMING_REACTION        2002


#define DC_EVENT_INCOMING_WEBXDC_NOTIFY   2003


#define DC_EVENT_INCOMING_MSG             2005


#define DC_EVENT_INCOMING_MSG_BUNCH       2006


#define DC_EVENT_MSGS_NOTICED             2008


#define DC_EVENT_MSG_DELIVERED            2010


#define DC_EVENT_MSG_FAILED               2012


#define DC_EVENT_MSG_READ                 2015


#define DC_EVENT_MSG_DELETED              2016


#define DC_EVENT_CHAT_MODIFIED            2020


#define DC_EVENT_CHAT_EPHEMERAL_TIMER_MODIFIED 2021


#define DC_EVENT_CHAT_DELETED             2023


#define DC_EVENT_CONTACTS_CHANGED         2030


#define DC_EVENT_LOCATION_CHANGED         2035


#define DC_EVENT_CONFIGURE_PROGRESS       2041


#define DC_EVENT_IMEX_PROGRESS            2051


#define DC_EVENT_IMEX_FILE_WRITTEN        2052


#define DC_EVENT_SECUREJOIN_INVITER_PROGRESS      2060


#define DC_EVENT_SECUREJOIN_JOINER_PROGRESS       2061


#define DC_EVENT_CONNECTIVITY_CHANGED             2100


#define DC_EVENT_SELFAVATAR_CHANGED               2110


#define DC_EVENT_CONFIG_SYNCED                    2111


#define DC_EVENT_WEBXDC_STATUS_UPDATE             2120


#define DC_EVENT_WEBXDC_INSTANCE_DELETED          2121


#define DC_EVENT_WEBXDC_REALTIME_DATA             2150


#define DC_EVENT_WEBXDC_REALTIME_ADVERTISEMENT    2151


#define DC_EVENT_ACCOUNTS_BACKGROUND_FETCH_DONE   2200


#define DC_EVENT_CHATLIST_CHANGED              2300


#define DC_EVENT_CHATLIST_ITEM_CHANGED         2301


#define DC_EVENT_ACCOUNTS_CHANGED              2302


#define DC_EVENT_ACCOUNTS_ITEM_CHANGED         2303


#define DC_EVENT_CHANNEL_OVERFLOW              2400


#define DC_EVENT_DATA1_IS_STRING(e)  0    // not used anymore

#define DC_EVENT_DATA2_IS_STRING(e)  ((e)==DC_EVENT_CONFIGURE_PROGRESS || (e)==DC_EVENT_IMEX_FILE_WRITTEN || ((e)>=100 && (e)<=499))


/*

 * Values for dc_get|set_config("show_emails")

 */

#define DC_SHOW_EMAILS_OFF               0

#define DC_SHOW_EMAILS_ACCEPTED_CONTACTS 1

#define DC_SHOW_EMAILS_ALL               2


/*

 * Values for dc_get|set_config("media_quality")

 */

#define DC_MEDIA_QUALITY_BALANCED 0

#define DC_MEDIA_QUALITY_WORSE    1


#define         DC_PROVIDER_STATUS_OK           1


#define         DC_PROVIDER_STATUS_PREPARATION  2


#define         DC_PROVIDER_STATUS_BROKEN       3


#define         DC_CHAT_VISIBILITY_NORMAL      0


#define         DC_CHAT_VISIBILITY_ARCHIVED    1


#define         DC_CHAT_VISIBILITY_PINNED      2


#define DC_DOWNLOAD_DONE           0


#define DC_DOWNLOAD_AVAILABLE      10


#define DC_DOWNLOAD_FAILURE        20


#define DC_DOWNLOAD_UNDECIPHERABLE 30


#define DC_DOWNLOAD_IN_PROGRESS    1000


#define DC_STR_NOMESSAGES                 1


#define DC_STR_SELF                       2


#define DC_STR_DRAFT                      3


#define DC_STR_VOICEMESSAGE               7


#define DC_STR_IMAGE                      9


#define DC_STR_VIDEO                      10


#define DC_STR_AUDIO                      11


#define DC_STR_FILE                       12


#define DC_STR_MSGGRPNAME                 15


#define DC_STR_MSGGRPIMGCHANGED           16


#define DC_STR_MSGADDMEMBER               17


#define DC_STR_MSGDELMEMBER               18


#define DC_STR_MSGGROUPLEFT               19


#define DC_STR_GIF                        23


#define DC_STR_ENCRYPTEDMSG               24


#define DC_STR_E2E_AVAILABLE              25


#define DC_STR_ENCR_TRANSP                27


#define DC_STR_ENCR_NONE                  28


#define DC_STR_CANTDECRYPT_MSG_BODY       29


#define DC_STR_FINGERPRINTS               30


#define DC_STR_READRCPT                   31


#define DC_STR_READRCPT_MAILBODY          32


#define DC_STR_MSGGRPIMGDELETED           33


#define DC_STR_E2E_PREFERRED              34


#define DC_STR_CONTACT_VERIFIED           35


#define DC_STR_CONTACT_NOT_VERIFIED       36


#define DC_STR_CONTACT_SETUP_CHANGED      37


#define DC_STR_ARCHIVEDCHATS              40


#define DC_STR_AC_SETUP_MSG_SUBJECT       42


#define DC_STR_AC_SETUP_MSG_BODY          43


#define DC_STR_CANNOT_LOGIN               60


#define DC_STR_MSGACTIONBYUSER            62


#define DC_STR_MSGACTIONBYME              63


#define DC_STR_MSGLOCATIONENABLED         64


#define DC_STR_MSGLOCATIONDISABLED        65


#define DC_STR_LOCATION                   66


#define DC_STR_STICKER                    67


#define DC_STR_DEVICE_MESSAGES            68


#define DC_STR_SAVED_MESSAGES             69


#define DC_STR_DEVICE_MESSAGES_HINT       70


#define DC_STR_WELCOME_MESSAGE            71


#define DC_STR_UNKNOWN_SENDER_FOR_CHAT    72


#define DC_STR_SUBJECT_FOR_NEW_CONTACT    73


#define DC_STR_FAILED_SENDING_TO          74


#define DC_STR_EPHEMERAL_DISABLED         75


#define DC_STR_EPHEMERAL_SECONDS          76


#define DC_STR_EPHEMERAL_MINUTE           77


#define DC_STR_EPHEMERAL_HOUR             78


#define DC_STR_EPHEMERAL_DAY              79


#define DC_STR_EPHEMERAL_WEEK             80


#define DC_STR_EPHEMERAL_FOUR_WEEKS       81


#define DC_STR_VIDEOCHAT_INVITATION       82


#define DC_STR_VIDEOCHAT_INVITE_MSG_BODY  83


#define DC_STR_CONFIGURATION_FAILED       84


#define DC_STR_BAD_TIME_MSG_BODY          85


#define DC_STR_UPDATE_REMINDER_MSG_BODY   86


#define DC_STR_ERROR_NO_NETWORK           87


#define DC_STR_REPLY_NOUN                 90


#define DC_STR_SELF_DELETED_MSG_BODY      91


#define DC_STR_SERVER_TURNED_OFF          92


#define DC_STR_EPHEMERAL_MINUTES          93


#define DC_STR_EPHEMERAL_HOURS            94


#define DC_STR_EPHEMERAL_DAYS             95


#define DC_STR_EPHEMERAL_WEEKS            96


#define DC_STR_FORWARDED                  97


#define DC_STR_QUOTA_EXCEEDING_MSG_BODY   98


#define DC_STR_PARTIAL_DOWNLOAD_MSG_BODY  99


#define DC_STR_DOWNLOAD_AVAILABILITY      100


#define DC_STR_SYNC_MSG_SUBJECT           101


#define DC_STR_SYNC_MSG_BODY              102


#define DC_STR_INCOMING_MESSAGES          103


#define DC_STR_OUTGOING_MESSAGES          104


#define DC_STR_STORAGE_ON_DOMAIN          105


#define DC_STR_ONE_MOMENT                 106


#define DC_STR_CONNECTED                  107


#define DC_STR_CONNTECTING                108


#define DC_STR_UPDATING                   109


#define DC_STR_SENDING                    110


#define DC_STR_LAST_MSG_SENT_SUCCESSFULLY 111


#define DC_STR_ERROR                      112


#define DC_STR_NOT_SUPPORTED_BY_PROVIDER  113


#define DC_STR_MESSAGES                   114


#define DC_STR_BROADCAST_LIST             115


#define DC_STR_PART_OF_TOTAL_USED         116


#define DC_STR_SECURE_JOIN_STARTED        117


#define DC_STR_SECURE_JOIN_REPLIES        118


#define DC_STR_SETUP_CONTACT_QR_DESC      119


#define DC_STR_SECURE_JOIN_GROUP_QR_DESC  120


#define DC_STR_NOT_CONNECTED              121


#define DC_STR_AEAP_ADDR_CHANGED          122


#define DC_STR_AEAP_EXPLANATION_AND_LINK  123


#define DC_STR_GROUP_NAME_CHANGED_BY_YOU 124


#define DC_STR_GROUP_NAME_CHANGED_BY_OTHER 125


#define DC_STR_GROUP_IMAGE_CHANGED_BY_YOU 126


#define DC_STR_GROUP_IMAGE_CHANGED_BY_OTHER 127


#define DC_STR_ADD_MEMBER_BY_YOU 128


#define DC_STR_ADD_MEMBER_BY_OTHER 129


#define DC_STR_REMOVE_MEMBER_BY_YOU 130


#define DC_STR_REMOVE_MEMBER_BY_OTHER 131


#define DC_STR_GROUP_LEFT_BY_YOU 132


#define DC_STR_GROUP_LEFT_BY_OTHER 133


#define DC_STR_GROUP_IMAGE_DELETED_BY_YOU 134


#define DC_STR_GROUP_IMAGE_DELETED_BY_OTHER 135


#define DC_STR_LOCATION_ENABLED_BY_YOU 136


#define DC_STR_LOCATION_ENABLED_BY_OTHER 137


#define DC_STR_EPHEMERAL_TIMER_DISABLED_BY_YOU 138


#define DC_STR_EPHEMERAL_TIMER_DISABLED_BY_OTHER 139


#define DC_STR_EPHEMERAL_TIMER_SECONDS_BY_YOU 140


#define DC_STR_EPHEMERAL_TIMER_SECONDS_BY_OTHER 141


#define DC_STR_EPHEMERAL_TIMER_1_MINUTE_BY_YOU 142


#define DC_STR_EPHEMERAL_TIMER_1_MINUTE_BY_OTHER 143


#define DC_STR_EPHEMERAL_TIMER_1_HOUR_BY_YOU 144


#define DC_STR_EPHEMERAL_TIMER_1_HOUR_BY_OTHER 145


#define DC_STR_EPHEMERAL_TIMER_1_DAY_BY_YOU 146


#define DC_STR_EPHEMERAL_TIMER_1_DAY_BY_OTHER 147


#define DC_STR_EPHEMERAL_TIMER_1_WEEK_BY_YOU 148


#define DC_STR_EPHEMERAL_TIMER_1_WEEK_BY_OTHER 149


#define DC_STR_EPHEMERAL_TIMER_MINUTES_BY_YOU 150


#define DC_STR_EPHEMERAL_TIMER_MINUTES_BY_OTHER 151


#define DC_STR_EPHEMERAL_TIMER_HOURS_BY_YOU 152


#define DC_STR_EPHEMERAL_TIMER_HOURS_BY_OTHER 153


#define DC_STR_EPHEMERAL_TIMER_DAYS_BY_YOU 154


#define DC_STR_EPHEMERAL_TIMER_DAYS_BY_OTHER 155


#define DC_STR_EPHEMERAL_TIMER_WEEKS_BY_YOU 156


#define DC_STR_EPHEMERAL_TIMER_WEEKS_BY_OTHER 157


#define DC_STR_BACKUP_TRANSFER_QR 162


#define DC_STR_BACKUP_TRANSFER_MSG_BODY 163


#define DC_STR_CHAT_PROTECTION_ENABLED 170


#define DC_STR_CHAT_PROTECTION_DISABLED 171


#define DC_STR_NEW_GROUP_SEND_FIRST_MESSAGE 172


#define DC_STR_MESSAGE_ADD_MEMBER 173


#define DC_STR_INVALID_UNENCRYPTED_MAIL 174


#define DC_STR_YOU_REACTED 176


#define DC_STR_REACTED_BY 177


#define DC_STR_SECUREJOIN_WAIT 190


#define DC_STR_SECUREJOIN_WAIT_TIMEOUT 191


#define DC_STR_SECUREJOIN_TAKES_LONGER 192


#define DC_STR_CONTACT 200


#ifdef PY_CFFI_INC

/* Helper utility to locate the header file when building python bindings. */

char* _dc_header_file_location(void) {

    return __FILE__;

}

#endif


#ifdef __cplusplus

}

#endif

#endif // __DELTACHAT_H__

dc_accounts_t
This class provides functionality that can be used to manage several dc_context_t objects running at ...

dc_accounts_t::dc_accounts_select_account
int dc_accounts_select_account(dc_accounts_t *accounts, uint32_t account_id)
Change the selected account.

dc_accounts_t::dc_accounts_unref
void dc_accounts_unref(dc_accounts_t *accounts)
Free an account manager object.

dc_accounts_t::dc_accounts_get_event_emitter
dc_event_emitter_t * dc_accounts_get_event_emitter(dc_accounts_t *accounts)
Create the event emitter that is used to receive events.

dc_accounts_t::dc_accounts_get_selected_account
dc_context_t * dc_accounts_get_selected_account(dc_accounts_t *accounts)
Get the currently selected account.

dc_accounts_t::dc_accounts_maybe_network
void dc_accounts_maybe_network(dc_accounts_t *accounts)
This function should be called when there is a hint that the network is available again.

dc_accounts_t::dc_accounts_migrate_account
uint32_t dc_accounts_migrate_account(dc_accounts_t *accounts, const char *dbfile)
Migrate independent accounts into accounts managed by the account manager.

dc_accounts_t::dc_accounts_background_fetch
int dc_accounts_background_fetch(dc_accounts_t *accounts, uint64_t timeout)
Perform a background fetch for all accounts in parallel with a timeout.

dc_accounts_t::dc_accounts_get_account
dc_context_t * dc_accounts_get_account(dc_accounts_t *accounts, uint32_t account_id)
Get an account context from an account ID.

dc_accounts_t::dc_accounts_get_all
dc_array_t * dc_accounts_get_all(dc_accounts_t *accounts)
List all accounts.

dc_accounts_t::dc_jsonrpc_init
dc_jsonrpc_instance_t * dc_jsonrpc_init(dc_accounts_t *account_manager)
Create the jsonrpc instance that is used to call the jsonrpc.

dc_accounts_t::dc_accounts_set_push_device_token
void dc_accounts_set_push_device_token(dc_accounts_t *accounts, const char *token)
Sets device token for Apple Push Notification service.

dc_accounts_t::dc_accounts_start_io
void dc_accounts_start_io(dc_accounts_t *accounts)
Start job and IMAP/SMTP tasks for all accounts managed by the account manager.

dc_accounts_t::dc_accounts_stop_io
void dc_accounts_stop_io(dc_accounts_t *accounts)
Stop job and IMAP/SMTP tasks for all accounts and return when they are finished.

dc_accounts_t::dc_accounts_maybe_network_lost
void dc_accounts_maybe_network_lost(dc_accounts_t *accounts)
This function can be called when there is a hint that the network is lost.

dc_accounts_t::dc_accounts_add_account
uint32_t dc_accounts_add_account(dc_accounts_t *accounts)
Add a new account to the account manager.

dc_accounts_t::dc_accounts_new
dc_accounts_t * dc_accounts_new(const char *dir, int writable)
Create a new account manager.

dc_accounts_t::dc_accounts_add_closed_account
uint32_t dc_accounts_add_closed_account(dc_accounts_t *accounts)
Add a new closed account to the account manager.

dc_accounts_t::dc_accounts_remove_account
int dc_accounts_remove_account(dc_accounts_t *accounts, uint32_t account_id)
Remove an account from the account manager.

dc_array_t
An object containing a simple array.

dc_array_t::dc_array_unref
void dc_array_unref(dc_array_t *array)
Free an array object.

dc_array_t::dc_array_get_accuracy
double dc_array_get_accuracy(const dc_array_t *array, size_t index)
Return the accuracy of the item at the given index.

dc_array_t::dc_array_get_timestamp
int64_t dc_array_get_timestamp(const dc_array_t *array, size_t index)
Return the timestamp of the item at the given index.

dc_array_t::dc_array_get_chat_id
uint32_t dc_array_get_chat_id(const dc_array_t *array, size_t index)
Return the chat ID of the item at the given index.

dc_array_t::dc_array_is_independent
int dc_array_is_independent(const dc_array_t *array, size_t index)
Return the independent-state of the location at the given index.

dc_array_t::dc_array_get_msg_id
uint32_t dc_array_get_msg_id(const dc_array_t *array, size_t index)
Return the message ID of the item at the given index.

dc_array_t::dc_array_get_contact_id
uint32_t dc_array_get_contact_id(const dc_array_t *array, size_t index)
Return the contact ID of the item at the given index.

dc_array_t::dc_array_get_longitude
double dc_array_get_longitude(const dc_array_t *array, size_t index)
Return the longitude of the item at the given index.

dc_array_t::dc_array_get_cnt
size_t dc_array_get_cnt(const dc_array_t *array)
Find out the number of items in an array.

dc_array_t::dc_array_get_id
uint32_t dc_array_get_id(const dc_array_t *array, size_t index)
Get the item at the given index as an ID.

dc_array_t::dc_array_get_marker
char * dc_array_get_marker(const dc_array_t *array, size_t index)
Return the marker-character of the item at the given index.

dc_array_t::dc_array_get_latitude
double dc_array_get_latitude(const dc_array_t *array, size_t index)
Return the latitude of the item at the given index.

dc_backup_provider_t
Set up another device.

dc_backup_provider_t::dc_backup_provider_get_qr
char * dc_backup_provider_get_qr(const dc_backup_provider_t *backup_provider)
Returns the QR code text that will offer the backup to other devices.

dc_backup_provider_t::dc_backup_provider_unref
void dc_backup_provider_unref(dc_backup_provider_t *backup_provider)
Frees a dc_backup_provider_t object.

dc_backup_provider_t::dc_backup_provider_wait
void dc_backup_provider_wait(dc_backup_provider_t *backup_provider)
Waits for the sending to finish.

dc_backup_provider_t::dc_backup_provider_get_qr_svg
char * dc_backup_provider_get_qr_svg(const dc_backup_provider_t *backup_provider)
Returns the QR code SVG image that will offer the backup to other devices.

dc_backup_provider_t::dc_backup_provider_new
dc_backup_provider_t * dc_backup_provider_new(dc_context_t *context)
Creates an object for sending a backup to another device.

dc_chat_t
An object representing a single chat in memory.

dc_chat_t::dc_chat_get_name
char * dc_chat_get_name(const dc_chat_t *chat)
Get name of a chat.

dc_chat_t::dc_chat_is_sending_locations
int dc_chat_is_sending_locations(const dc_chat_t *chat)
Check if locations are sent to the chat at the time the object was created using dc_get_chat().

dc_chat_t::dc_chat_get_type
int dc_chat_get_type(const dc_chat_t *chat)
Get chat type as one of the DC_CHAT_TYPE constants:

dc_chat_t::dc_chat_is_protection_broken
int dc_chat_is_protection_broken(const dc_chat_t *chat)
Checks if the chat was protected, and then an incoming message broke this protection.

dc_chat_t::dc_chat_get_mailinglist_addr
char * dc_chat_get_mailinglist_addr(const dc_chat_t *chat)
Returns the address where messages are sent to if the chat is a mailing list.

dc_chat_t::dc_chat_get_id
uint32_t dc_chat_get_id(const dc_chat_t *chat)
Get the chat ID.

dc_chat_t::dc_chat_is_device_talk
int dc_chat_is_device_talk(const dc_chat_t *chat)
Check if a chat is a device-talk.

dc_chat_t::dc_chat_get_remaining_mute_duration
int64_t dc_chat_get_remaining_mute_duration(const dc_chat_t *chat)
Get the exact state of the mute of a chat.

dc_chat_t::dc_chat_is_contact_request
int dc_chat_is_contact_request(const dc_chat_t *chat)
Check if a chat is a contact request chat.

dc_chat_t::dc_chat_get_visibility
int dc_chat_get_visibility(const dc_chat_t *chat)
Get visibility of chat.

dc_chat_t::dc_chat_unref
void dc_chat_unref(dc_chat_t *chat)
Free a chat object.

dc_chat_t::dc_chat_is_unpromoted
int dc_chat_is_unpromoted(const dc_chat_t *chat)
Check if a group chat is still unpromoted.

dc_chat_t::dc_chat_get_color
uint32_t dc_chat_get_color(const dc_chat_t *chat)
Get a color for the chat.

dc_chat_t::dc_chat_can_send
int dc_chat_can_send(const dc_chat_t *chat)
Check if messages can be sent to a given chat.

dc_chat_t::dc_chat_is_self_talk
int dc_chat_is_self_talk(const dc_chat_t *chat)
Check if a chat is a self talk.

dc_chat_t::dc_chat_get_profile_image
char * dc_chat_get_profile_image(const dc_chat_t *chat)
Get the chat's profile image.

dc_chat_t::dc_chat_is_protected
int dc_chat_is_protected(const dc_chat_t *chat)
Check if a chat is protected.

dc_chat_t::dc_chat_is_muted
int dc_chat_is_muted(const dc_chat_t *chat)
Check whether the chat is currently muted (can be changed by dc_set_chat_mute_duration()).

dc_chat_t::dc_chat_is_encrypted
int dc_chat_is_encrypted(const dc_chat_t *chat)
Check if the chat is encrypted.

dc_chatlist_t
An object representing a single chatlist in memory.

dc_chatlist_t::dc_chatlist_get_msg_id
uint32_t dc_chatlist_get_msg_id(const dc_chatlist_t *chatlist, size_t index)
Get a single message ID of a chatlist.

dc_chatlist_t::dc_chatlist_unref
void dc_chatlist_unref(dc_chatlist_t *chatlist)
Free a chatlist object.

dc_chatlist_t::dc_chatlist_get_summary
dc_lot_t * dc_chatlist_get_summary(const dc_chatlist_t *chatlist, size_t index, dc_chat_t *chat)
Get a summary for a chatlist index.

dc_chatlist_t::dc_chatlist_get_context
dc_context_t * dc_chatlist_get_context(dc_chatlist_t *chatlist)
Helper function to get the associated context object.

dc_chatlist_t::dc_chatlist_get_chat_id
uint32_t dc_chatlist_get_chat_id(const dc_chatlist_t *chatlist, size_t index)
Get a single chat ID of a chatlist.

dc_chatlist_t::dc_chatlist_get_cnt
size_t dc_chatlist_get_cnt(const dc_chatlist_t *chatlist)
Find out the number of chats in a chatlist.

dc_contact_t
An object representing a single contact in memory.

dc_contact_t::dc_contact_get_addr
char * dc_contact_get_addr(const dc_contact_t *contact)
Get the e-mail address of a contact.

dc_contact_t::dc_contact_get_name_n_addr
char * dc_contact_get_name_n_addr(const dc_contact_t *contact)
Get a summary of name and address.

dc_contact_t::dc_contact_is_verified
int dc_contact_is_verified(dc_contact_t *contact)
Check if the contact can be added to verified chats, i.e.

dc_contact_t::dc_contact_is_key_contact
int dc_contact_is_key_contact(dc_contact_t *contact)
Returns whether contact is a key-contact, i.e.

dc_contact_t::dc_contact_get_profile_image
char * dc_contact_get_profile_image(const dc_contact_t *contact)
Get the contact's profile image.

dc_contact_t::dc_contact_unref
void dc_contact_unref(dc_contact_t *contact)
Free a contact object.

dc_contact_t::dc_contact_get_auth_name
char * dc_contact_get_auth_name(const dc_contact_t *contact)
Get original contact name.

dc_contact_t::dc_contact_get_last_seen
int64_t dc_contact_get_last_seen(const dc_contact_t *contact)
Get the contact's last seen timestamp.

dc_contact_t::dc_contact_get_verifier_id
uint32_t dc_contact_get_verifier_id(dc_contact_t *contact)
Return the contact ID that verified a contact.

dc_contact_t::dc_contact_get_status
char * dc_contact_get_status(const dc_contact_t *contact)
Get the contact's status.

dc_contact_t::dc_contact_is_blocked
int dc_contact_is_blocked(const dc_contact_t *contact)
Check if a contact is blocked.

dc_contact_t::dc_contact_get_name
char * dc_contact_get_name(const dc_contact_t *contact)
Get the edited contact name.

dc_contact_t::dc_contact_get_display_name
char * dc_contact_get_display_name(const dc_contact_t *contact)
Get display name.

dc_contact_t::dc_contact_get_color
uint32_t dc_contact_get_color(const dc_contact_t *contact)
Get a color for the contact.

dc_contact_t::dc_contact_get_id
uint32_t dc_contact_get_id(const dc_contact_t *contact)
Get the ID of a contact.

dc_contact_t::dc_contact_is_bot
int dc_contact_is_bot(dc_contact_t *contact)
Returns whether contact is a bot.

dc_contact_t::dc_contact_was_seen_recently
int dc_contact_was_seen_recently(const dc_contact_t *contact)
Check if the contact was seen recently.

dc_context_t
An object representing a single account.

dc_context_t::dc_imex_has_backup
char * dc_imex_has_backup(dc_context_t *context, const char *dir)
Check if there is a backup file.

dc_context_t::dc_add_address_book
int dc_add_address_book(dc_context_t *context, const char *addr_book)
Add a number of contacts.

dc_context_t::dc_get_msg_cnt
int dc_get_msg_cnt(dc_context_t *context, uint32_t chat_id)
Get the total number of messages in a chat.

dc_context_t::dc_context_new_closed
dc_context_t * dc_context_new_closed(const char *dbfile)
Create a new context object.

dc_context_t::dc_make_vcard
char * dc_make_vcard(dc_context_t *context, uint32_t contact_id)
Make a vCard.

dc_context_t::dc_get_contacts
dc_array_t * dc_get_contacts(dc_context_t *context, uint32_t flags, const char *query)
Returns known and unblocked contacts.

dc_context_t::dc_set_draft
void dc_set_draft(dc_context_t *context, uint32_t chat_id, dc_msg_t *msg)
Save a draft for a chat in the database.

dc_context_t::dc_add_device_msg
uint32_t dc_add_device_msg(dc_context_t *context, const char *label, dc_msg_t *msg)
Add a message to the device-chat.

dc_context_t::dc_send_delete_request
void dc_send_delete_request(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt)
Send chat members a request to delete the given messages.

dc_context_t::dc_get_chatlist
dc_chatlist_t * dc_get_chatlist(dc_context_t *context, int flags, const char *query_str, uint32_t query_id)
Get a list of chats.

dc_context_t::dc_get_next_msgs
dc_array_t * dc_get_next_msgs(dc_context_t *context)
Returns the message IDs of all messages of any chat with a database ID higher than last_msg_id config...

dc_context_t::dc_init_webxdc_integration
uint32_t dc_init_webxdc_integration(dc_context_t *context, uint32_t chat_id)
Init a Webxdc integration.

dc_context_t::dc_get_contact_encrinfo
char * dc_get_contact_encrinfo(dc_context_t *context, uint32_t contact_id)
Get encryption info for a contact.

dc_context_t::dc_lookup_contact_id_by_addr
uint32_t dc_lookup_contact_id_by_addr(dc_context_t *context, const char *addr)
Check if an e-mail address belongs to a known and unblocked contact.

dc_context_t::dc_set_chat_profile_image
int dc_set_chat_profile_image(dc_context_t *context, uint32_t chat_id, const char *image)
Set group profile image.

dc_context_t::dc_send_text_msg
uint32_t dc_send_text_msg(dc_context_t *context, uint32_t chat_id, const char *text_to_send)
Send a simple text message a given chat.

dc_context_t::dc_maybe_network
void dc_maybe_network(dc_context_t *context)
This function should be called when there is a hint that the network is available again,...

dc_context_t::dc_was_device_msg_ever_added
int dc_was_device_msg_ever_added(dc_context_t *context, const char *label)
Check if a device-message with a given label was ever added.

dc_context_t::dc_get_chat_ephemeral_timer
uint32_t dc_get_chat_ephemeral_timer(dc_context_t *context, uint32_t chat_id)
Get the chat's ephemeral message timer.

dc_context_t::dc_get_chat_media
dc_array_t * dc_get_chat_media(dc_context_t *context, uint32_t chat_id, int msg_type, int msg_type2, int msg_type3)
Returns all message IDs of the given types in a given chat or any chat.

dc_context_t::dc_check_qr
dc_lot_t * dc_check_qr(dc_context_t *context, const char *qr)
Check a scanned QR code.

dc_context_t::dc_get_locations
dc_array_t * dc_get_locations(dc_context_t *context, uint32_t chat_id, uint32_t contact_id, int64_t timestamp_begin, int64_t timestamp_end)
Get shared locations from the database.

dc_context_t::dc_send_locations_to_chat
void dc_send_locations_to_chat(dc_context_t *context, uint32_t chat_id, int seconds)
Enable or disable location streaming for a chat.

dc_context_t::dc_get_contact
dc_contact_t * dc_get_contact(dc_context_t *context, uint32_t contact_id)
Get a single contact object.

dc_context_t::dc_stop_io
void dc_stop_io(dc_context_t *context)
Stop job, IMAP, SMTP and other tasks and return when they are finished.

dc_context_t::dc_get_draft
dc_msg_t * dc_get_draft(dc_context_t *context, uint32_t chat_id)
Get draft for a chat, if any.

dc_context_t::dc_preconfigure_keypair
int dc_preconfigure_keypair(dc_context_t *context, const char *secret_data)
Save a keypair as the default keys for the user.

dc_context_t::dc_create_qr_svg
char * dc_create_qr_svg(const char *payload)
Create a QR code from any input data.

dc_context_t::dc_get_blobdir
char * dc_get_blobdir(const dc_context_t *context)
Get the blob directory.

dc_context_t::dc_get_blocked_contacts
dc_array_t * dc_get_blocked_contacts(dc_context_t *context)
Get blocked contacts.

dc_context_t::dc_context_unref
void dc_context_unref(dc_context_t *context)
Free a context object.

dc_context_t::dc_stop_ongoing_process
void dc_stop_ongoing_process(dc_context_t *context)
Signal an ongoing process to stop.

dc_context_t::dc_get_msg
dc_msg_t * dc_get_msg(dc_context_t *context, uint32_t msg_id)
Get a single message object of the type dc_msg_t.

dc_context_t::dc_get_chat_msgs
dc_array_t * dc_get_chat_msgs(dc_context_t *context, uint32_t chat_id, uint32_t flags, uint32_t marker1before)
Get all message IDs belonging to a chat.

dc_context_t::dc_get_info
char * dc_get_info(const dc_context_t *context)
Get information about the context.

dc_context_t::dc_receive_backup
int dc_receive_backup(dc_context_t *context, const char *qr)
Gets a backup offered by a dc_backup_provider_t object on another device.

dc_context_t::dc_is_sending_locations_to_chat
int dc_is_sending_locations_to_chat(dc_context_t *context, uint32_t chat_id)
Check if location streaming is enabled.

dc_context_t::dc_block_chat
void dc_block_chat(dc_context_t *context, uint32_t chat_id)
Block a chat.

dc_context_t::dc_get_securejoin_qr
char * dc_get_securejoin_qr(dc_context_t *context, uint32_t chat_id)
Get QR code text that will offer an Setup-Contact or Verified-Group invitation.

dc_context_t::dc_continue_key_transfer
int dc_continue_key_transfer(dc_context_t *context, uint32_t msg_id, const char *setup_code)
Continue the Autocrypt Key Transfer on another device.

dc_context_t::dc_get_fresh_msgs
dc_array_t * dc_get_fresh_msgs(dc_context_t *context)
Returns the message IDs of all fresh messages of any chat.

dc_context_t::dc_set_stock_translation
int dc_set_stock_translation(dc_context_t *context, uint32_t stock_id, const char *stock_msg)
Set stock string translation.

dc_context_t::dc_set_webxdc_integration
void dc_set_webxdc_integration(dc_context_t *context, const char *file)
Set Webxdc file as integration.

dc_context_t::dc_set_chat_mute_duration
int dc_set_chat_mute_duration(dc_context_t *context, uint32_t chat_id, int64_t duration)
Set mute duration of a chat.

dc_context_t::dc_wait_next_msgs
dc_array_t * dc_wait_next_msgs(dc_context_t *context)
Waits for notification of new messages and returns an array of new message IDs.

dc_context_t::dc_get_fresh_msg_cnt
int dc_get_fresh_msg_cnt(dc_context_t *context, uint32_t chat_id)
Get the number of fresh messages in a chat.

dc_context_t::dc_set_chat_name
int dc_set_chat_name(dc_context_t *context, uint32_t chat_id, const char *name)
Set group name.

dc_context_t::dc_create_broadcast_list
uint32_t dc_create_broadcast_list(dc_context_t *context)
Create a new broadcast list.

dc_context_t::dc_marknoticed_chat
void dc_marknoticed_chat(dc_context_t *context, uint32_t chat_id)
Mark all messages in a chat as noticed.

dc_context_t::dc_set_chat_ephemeral_timer
int dc_set_chat_ephemeral_timer(dc_context_t *context, uint32_t chat_id, uint32_t timer)
Set the chat's ephemeral message timer.

dc_context_t::dc_remove_contact_from_chat
int dc_remove_contact_from_chat(dc_context_t *context, uint32_t chat_id, uint32_t contact_id)
Remove a member from a group.

dc_context_t::dc_search_msgs
dc_array_t * dc_search_msgs(dc_context_t *context, uint32_t chat_id, const char *query)
Search messages containing the given query string.

dc_context_t::dc_may_be_valid_addr
int dc_may_be_valid_addr(const char *addr)
Rough check if a string may be a valid e-mail address.

dc_context_t::dc_is_configured
int dc_is_configured(const dc_context_t *context)
Check if the context is already configured.

dc_context_t::dc_estimate_deletion_cnt
int dc_estimate_deletion_cnt(dc_context_t *context, int from_server, int64_t seconds)
Estimate the number of messages that will be deleted by the dc_set_config()-options delete_device_aft...

dc_context_t::dc_get_connectivity
int dc_get_connectivity(dc_context_t *context)
Get the current connectivity, i.e.

dc_context_t::dc_get_last_error
char * dc_get_last_error(dc_context_t *context)
Get last error string.

dc_context_t::dc_get_oauth2_url
char * dc_get_oauth2_url(dc_context_t *context, const char *addr, const char *redirect_uri)
Get URL that can be used to initiate an OAuth2 authorization.

dc_context_t::dc_get_chat_id_by_contact_id
uint32_t dc_get_chat_id_by_contact_id(dc_context_t *context, uint32_t contact_id)
Check, if there is a normal chat with a given contact.

dc_context_t::dc_get_config
char * dc_get_config(dc_context_t *context, const char *key)
Get a configuration option.

dc_context_t::dc_set_location
int dc_set_location(dc_context_t *context, double latitude, double longitude, double accuracy)
Set current location.

dc_context_t::dc_set_chat_visibility
void dc_set_chat_visibility(dc_context_t *context, uint32_t chat_id, int visibility)
Set chat visibility to pinned, archived or normal.

dc_context_t::dc_get_push_state
int dc_get_push_state(dc_context_t *context)
Get the current push notification state.

dc_context_t::dc_add_contact_to_chat
int dc_add_contact_to_chat(dc_context_t *context, uint32_t chat_id, uint32_t contact_id)
Add a member to a group.

dc_context_t::dc_get_msg_info
char * dc_get_msg_info(dc_context_t *context, uint32_t msg_id)
Get an informational text for a single message.

dc_context_t::dc_get_connectivity_html
char * dc_get_connectivity_html(dc_context_t *context)
Get an overview of the current connectivity, and possibly more statistics.

dc_context_t::dc_get_chat_contacts
dc_array_t * dc_get_chat_contacts(dc_context_t *context, uint32_t chat_id)
Get the contact IDs belonging to a chat.

dc_context_t::dc_get_chat
dc_chat_t * dc_get_chat(dc_context_t *context, uint32_t chat_id)
Get a chat object by a chat ID.

dc_context_t::dc_get_id
uint32_t dc_get_id(dc_context_t *context)
Get the ID of a context object.

dc_context_t::dc_context_new
dc_context_t * dc_context_new(const char *os_name, const char *dbfile, const char *blobdir)
Create a new context object and try to open it without passphrase.

dc_context_t::dc_send_videochat_invitation
uint32_t dc_send_videochat_invitation(dc_context_t *context, uint32_t chat_id)
Send invitation to a videochat.

dc_context_t::dc_send_msg_sync
uint32_t dc_send_msg_sync(dc_context_t *context, uint32_t chat_id, dc_msg_t *msg)
Send a message defined by a dc_msg_t object to a chat, synchronously.

dc_context_t::dc_create_contact
uint32_t dc_create_contact(dc_context_t *context, const char *name, const char *addr)
Add a single contact as a result of an explicit user action.

dc_context_t::dc_send_msg
uint32_t dc_send_msg(dc_context_t *context, uint32_t chat_id, dc_msg_t *msg)
Send a message defined by a dc_msg_t object to a chat.

dc_context_t::dc_download_full_msg
void dc_download_full_msg(dc_context_t *context, int msg_id)
Asks the core to start downloading a message fully.

dc_context_t::dc_get_msg_html
char * dc_get_msg_html(dc_context_t *context, uint32_t msg_id)
Get uncut message, if available.

dc_context_t::dc_get_event_emitter
dc_event_emitter_t * dc_get_event_emitter(dc_context_t *context)
Create the event emitter that is used to receive events.

dc_context_t::dc_start_io
void dc_start_io(dc_context_t *context)
Start job and IMAP/SMTP tasks.

dc_context_t::dc_imex
void dc_imex(dc_context_t *context, int what, const char *param1, const char *param2)
Import/export things.

dc_context_t::dc_get_securejoin_qr_svg
char * dc_get_securejoin_qr_svg(dc_context_t *context, uint32_t chat_id)
Get QR code image from the QR code text generated by dc_get_securejoin_qr().

dc_context_t::dc_import_vcard
dc_array_t * dc_import_vcard(dc_context_t *context, const char *vcard)
Import a vCard.

dc_context_t::dc_get_webxdc_status_updates
char * dc_get_webxdc_status_updates(dc_context_t *context, uint32_t msg_id, uint32_t serial)
Get webxdc status updates.

dc_context_t::dc_chatlist_get_summary2
dc_lot_t * dc_chatlist_get_summary2(dc_context_t *context, uint32_t chat_id, uint32_t msg_id)
Create a chatlist summary item when the chatlist object is already unref()'d.

dc_context_t::dc_create_chat_by_contact_id
uint32_t dc_create_chat_by_contact_id(dc_context_t *context, uint32_t contact_id)
Create a normal chat with a single user.

dc_context_t::dc_forward_msgs
void dc_forward_msgs(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt, uint32_t chat_id)
Forward messages to another chat.

dc_context_t::dc_send_webxdc_status_update
int dc_send_webxdc_status_update(dc_context_t *context, uint32_t msg_id, const char *json, const char *descr)
A webxdc instance sends a status update to its other members.

dc_context_t::dc_get_similar_chatlist
dc_chatlist_t * dc_get_similar_chatlist(dc_context_t *context, uint32_t chat_id)
Returns a list of similar chats.

dc_context_t::dc_save_msgs
void dc_save_msgs(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt)
Save a copy of messages in "Saved Messages".

dc_context_t::dc_set_config_from_qr
int dc_set_config_from_qr(dc_context_t *context, const char *qr)
Set configuration values from a QR code.

dc_context_t::dc_str_unref
void dc_str_unref(char *str)
Release a string returned by another deltachat-core function.

dc_context_t::dc_send_edit_request
void dc_send_edit_request(dc_context_t *context, uint32_t msg_id, const char *new_text)
Send chat members a request to edit the given message's text.

dc_context_t::dc_delete_contact
int dc_delete_contact(dc_context_t *context, uint32_t contact_id)
Delete a contact so that it disappears from the corresponding lists.

dc_context_t::dc_delete_chat
void dc_delete_chat(dc_context_t *context, uint32_t chat_id)
Delete a chat.

dc_context_t::dc_block_contact
void dc_block_contact(dc_context_t *context, uint32_t contact_id, int block)
Block or unblock a contact.

dc_context_t::dc_resend_msgs
int dc_resend_msgs(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt)
Resend messages and make information available for newly added chat members.

dc_context_t::dc_delete_msgs
void dc_delete_msgs(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt)
Delete messages.

dc_context_t::dc_configure
void dc_configure(dc_context_t *context)
Configure a context.

dc_context_t::dc_join_securejoin
uint32_t dc_join_securejoin(dc_context_t *context, const char *qr)
Continue a Setup-Contact or Verified-Group-Invite protocol started on another device with dc_get_secu...

dc_context_t::dc_markseen_msgs
void dc_markseen_msgs(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt)
Mark messages as presented to the user.

dc_context_t::dc_create_group_chat
uint32_t dc_create_group_chat(dc_context_t *context, int protect, const char *name)
Create a new group chat.

dc_context_t::dc_delete_all_locations
void dc_delete_all_locations(dc_context_t *context)
Delete all locations on the current device.

dc_context_t::dc_is_contact_in_chat
int dc_is_contact_in_chat(dc_context_t *context, uint32_t chat_id, uint32_t contact_id)
Check if a given contact ID is a member of a group chat.

dc_context_t::dc_context_is_open
int dc_context_is_open(dc_context_t *context)
Returns 1 if database is open.

dc_context_t::dc_accept_chat
void dc_accept_chat(dc_context_t *context, uint32_t chat_id)
Accept a contact request chat.

dc_context_t::dc_context_open
int dc_context_open(dc_context_t *context, const char *passphrase)
Opens the database with the given passphrase.

dc_context_t::dc_initiate_key_transfer
char * dc_initiate_key_transfer(dc_context_t *context)
Initiate Autocrypt Setup Transfer.

dc_context_t::dc_get_blocked_cnt
int dc_get_blocked_cnt(dc_context_t *context)
Get the number of blocked contacts.

dc_context_t::dc_context_change_passphrase
int dc_context_change_passphrase(dc_context_t *context, const char *passphrase)
Changes the passphrase on the open database.

dc_context_t::dc_get_chat_encrinfo
char * dc_get_chat_encrinfo(dc_context_t *context, uint32_t chat_id)
Get encryption info for a chat.

dc_context_t::dc_set_config
int dc_set_config(dc_context_t *context, const char *key, const char *value)
Configure the context.

dc_event_emitter_t
Opaque object that is used to get events from a single context.

dc_event_emitter_t::dc_event_emitter_unref
void dc_event_emitter_unref(dc_event_emitter_t *emitter)
Free a context event emitter object.

dc_event_emitter_t::dc_get_next_event
dc_event_t * dc_get_next_event(dc_event_emitter_t *emitter)
Get the next event from a context event emitter object.

dc_event_t
Opaque object describing a single event.

dc_event_t::dc_event_unref
void dc_event_unref(dc_event_t *event)
Free memory used by an event object.

dc_event_t::dc_event_get_data2_int
int dc_event_get_data2_int(dc_event_t *event)
Get data associated with an event object.

dc_event_t::dc_event_get_data1_str
char * dc_event_get_data1_str(dc_event_t *event)
Get data associated with an event object.

dc_event_t::dc_event_get_data2_str
char * dc_event_get_data2_str(dc_event_t *event)
Get data associated with an event object.

dc_event_t::dc_event_get_account_id
uint32_t dc_event_get_account_id(dc_event_t *event)
Get the account ID this event belongs to.

dc_event_t::dc_event_get_id
int dc_event_get_id(dc_event_t *event)
Get the event ID from an event object.

dc_event_t::dc_event_get_data1_int
int dc_event_get_data1_int(dc_event_t *event)
Get data associated with an event object.

dc_jsonrpc_instance_t
Opaque object for using the json rpc api from the cffi bindings.

dc_jsonrpc_instance_t::dc_jsonrpc_next_response
char * dc_jsonrpc_next_response(dc_jsonrpc_instance_t *jsonrpc_instance)
Get the next json_rpc response, blocks until there is a new event, so call this in a loop from a thre...

dc_jsonrpc_instance_t::dc_jsonrpc_unref
void dc_jsonrpc_unref(dc_jsonrpc_instance_t *jsonrpc_instance)
Free a jsonrpc instance.

dc_jsonrpc_instance_t::dc_jsonrpc_blocking_call
char * dc_jsonrpc_blocking_call(dc_jsonrpc_instance_t *jsonrpc_instance, const char *input)
Make a JSON-RPC call and return a response.

dc_jsonrpc_instance_t::dc_jsonrpc_request
void dc_jsonrpc_request(dc_jsonrpc_instance_t *jsonrpc_instance, const char *request)
Makes an asynchronous jsonrpc request, returns immediately and once the result is ready it can be ret...

dc_lot_t
An object containing a set of values.

dc_lot_t::dc_lot_get_timestamp
int64_t dc_lot_get_timestamp(const dc_lot_t *lot)
Get the associated timestamp.

dc_lot_t::dc_lot_get_state
int dc_lot_get_state(const dc_lot_t *lot)
Get the associated state.

dc_lot_t::dc_lot_get_id
uint32_t dc_lot_get_id(const dc_lot_t *lot)
Get the associated ID.

dc_lot_t::dc_lot_get_text1_meaning
int dc_lot_get_text1_meaning(const dc_lot_t *lot)
Get the meaning of the first string.

dc_lot_t::dc_lot_unref
void dc_lot_unref(dc_lot_t *lot)
Frees an object containing a set of parameters.

dc_lot_t::dc_lot_get_text1
char * dc_lot_get_text1(const dc_lot_t *lot)
Get first string.

dc_lot_t::dc_lot_get_text2
char * dc_lot_get_text2(const dc_lot_t *lot)
Get second string.

dc_msg_t
An object representing a single message in memory.

dc_msg_t::dc_msg_set_html
void dc_msg_set_html(dc_msg_t *msg, const char *html)
Set the HTML part of a message object.

dc_msg_t::dc_msg_get_webxdc_blob
char * dc_msg_get_webxdc_blob(const dc_msg_t *msg, const char *filename, size_t *ret_bytes)
Return a file from inside a webxdc message.

dc_msg_t::dc_msg_get_ephemeral_timer
uint32_t dc_msg_get_ephemeral_timer(const dc_msg_t *msg)
Get the ephemeral timer duration for a message.

dc_msg_t::dc_msg_get_filename
char * dc_msg_get_filename(const dc_msg_t *msg)
Get an original attachment filename, with extension but without the path.

dc_msg_t::dc_msg_set_override_sender_name
void dc_msg_set_override_sender_name(dc_msg_t *msg, const char *name)
Set different sender name for a message.

dc_msg_t::dc_msg_get_summarytext
char * dc_msg_get_summarytext(const dc_msg_t *msg, int approx_characters)
Get a message summary as a single line of text.

dc_msg_t::dc_msg_get_showpadlock
int dc_msg_get_showpadlock(const dc_msg_t *msg)
Check if a padlock should be shown beside the message.

dc_msg_t::dc_msg_get_summary
dc_lot_t * dc_msg_get_summary(const dc_msg_t *msg, const dc_chat_t *chat)
Get a summary for a message.

dc_msg_t::dc_msg_get_chat_id
uint32_t dc_msg_get_chat_id(const dc_msg_t *msg)
Get the ID of the chat the message belongs to.

dc_msg_t::dc_msg_set_quote
void dc_msg_set_quote(dc_msg_t *msg, const dc_msg_t *quote)
Set the message replying to.

dc_msg_t::dc_msg_has_location
int dc_msg_has_location(const dc_msg_t *msg)
Check if a message has a POI location bound to it.

dc_msg_t::dc_msg_get_text
char * dc_msg_get_text(const dc_msg_t *msg)
Get the text of the message.

dc_msg_t::dc_msg_get_from_id
uint32_t dc_msg_get_from_id(const dc_msg_t *msg)
Get the ID of the contact who wrote the message.

dc_msg_t::dc_msg_get_ephemeral_timestamp
int64_t dc_msg_get_ephemeral_timestamp(const dc_msg_t *msg)
Get the timestamp of the ephemeral message removal.

dc_msg_t::dc_msg_get_download_state
int dc_msg_get_download_state(const dc_msg_t *msg)
Check if the message is completely downloaded or if some further action is needed.

dc_msg_t::dc_msg_set_duration
void dc_msg_set_duration(dc_msg_t *msg, int duration)
Set the duration associated with message object.

dc_msg_t::dc_msg_set_file_and_deduplicate
void dc_msg_set_file_and_deduplicate(dc_msg_t *msg, const char *file, const char *name, const char *filemime)
Sets the file associated with a message.

dc_msg_t::dc_msg_save_file
int dc_msg_save_file(const dc_msg_t *msg, const char *path)
Save file copy at the user-provided path.

dc_msg_t::dc_msg_set_text
void dc_msg_set_text(dc_msg_t *msg, const char *text)
Set the text of a message object.

dc_msg_t::dc_msg_get_timestamp
int64_t dc_msg_get_timestamp(const dc_msg_t *msg)
Get the message sending time.

dc_msg_t::dc_msg_get_original_msg_id
uint32_t dc_msg_get_original_msg_id(const dc_msg_t *msg)
Get original message ID for a saved message from the "Saved Messages" chat.

dc_msg_t::dc_msg_get_quoted_text
char * dc_msg_get_quoted_text(const dc_msg_t *msg)
Get quoted text, if any.

dc_msg_t::dc_msg_get_override_sender_name
char * dc_msg_get_override_sender_name(const dc_msg_t *msg)
Get the name that should be shown over the message (in a group chat) instead of the contact display n...

dc_msg_t::dc_msg_get_videochat_url
char * dc_msg_get_videochat_url(const dc_msg_t *msg)
Get URL of a videochat invitation.

dc_msg_t::dc_msg_set_subject
void dc_msg_set_subject(dc_msg_t *msg, const char *subject)
Sets the email's subject.

dc_msg_t::dc_msg_get_width
int dc_msg_get_width(const dc_msg_t *msg)
Get the width of an image or a video.

dc_msg_t::dc_msg_get_filemime
char * dc_msg_get_filemime(const dc_msg_t *msg)
Get the MIME type of a file.

dc_msg_t::dc_msg_unref
void dc_msg_unref(dc_msg_t *msg)
Free a message object.

dc_msg_t::dc_msg_get_webxdc_href
char * dc_msg_get_webxdc_href(const dc_msg_t *msg)
Get link attached to an webxdc info message.

dc_msg_t::dc_msg_is_bot
int dc_msg_is_bot(const dc_msg_t *msg)
Check if an incoming message is a bot message, i.e.

dc_msg_t::dc_msg_get_setupcodebegin
char * dc_msg_get_setupcodebegin(const dc_msg_t *msg)
Get the first characters of the setup code.

dc_msg_t::dc_msg_set_dimension
void dc_msg_set_dimension(dc_msg_t *msg, int width, int height)
Set the dimensions associated with message object.

dc_msg_t::dc_msg_is_forwarded
int dc_msg_is_forwarded(const dc_msg_t *msg)
Check if the message is a forwarded message.

dc_msg_t::dc_msg_has_deviating_timestamp
int dc_msg_has_deviating_timestamp(const dc_msg_t *msg)
Check if a message has a deviating timestamp.

dc_msg_t::dc_msg_is_info
int dc_msg_is_info(const dc_msg_t *msg)
Check if the message is an informational message, created by the device or by another users.

dc_msg_t::dc_msg_latefiling_mediasize
void dc_msg_latefiling_mediasize(dc_msg_t *msg, int width, int height, int duration)
Late filing information to a message.

dc_msg_t::dc_msg_is_edited
int dc_msg_is_edited(const dc_msg_t *msg)
Check if the message was edited.

dc_msg_t::dc_msg_get_state
int dc_msg_get_state(const dc_msg_t *msg)
Get the state of a message.

dc_msg_t::dc_msg_set_location
void dc_msg_set_location(dc_msg_t *msg, double latitude, double longitude)
Set any location that should be bound to the message object.

dc_msg_t::dc_msg_is_setupmessage
int dc_msg_is_setupmessage(const dc_msg_t *msg)
Check if the message is an Autocrypt Setup Message.

dc_msg_t::dc_msg_get_filebytes
uint64_t dc_msg_get_filebytes(const dc_msg_t *msg)
Get the size of the file.

dc_msg_t::dc_msg_get_subject
char * dc_msg_get_subject(const dc_msg_t *msg)
Get the subject of the e-mail.

dc_msg_t::dc_msg_get_quoted_msg
dc_msg_t * dc_msg_get_quoted_msg(const dc_msg_t *msg)
Get quoted message, if available.

dc_msg_t::dc_msg_get_info_contact_id
uint32_t dc_msg_get_info_contact_id(const dc_msg_t *msg)
Return the contact ID of the profile to open when tapping the info message.

dc_msg_t::dc_msg_get_parent
dc_msg_t * dc_msg_get_parent(const dc_msg_t *msg)
Get parent message, if available.

dc_msg_t::dc_msg_new
dc_msg_t * dc_msg_new(dc_context_t *context, int viewtype)
Create new message object.

dc_msg_t::dc_msg_force_plaintext
void dc_msg_force_plaintext(dc_msg_t *msg)
Force the message to be sent in plain text.

dc_msg_t::dc_msg_has_html
int dc_msg_has_html(dc_msg_t *msg)
Checks if the message has a full HTML version.

dc_msg_t::dc_msg_get_duration
int dc_msg_get_duration(const dc_msg_t *msg)
Get the duration of audio or video.

dc_msg_t::dc_msg_get_id
uint32_t dc_msg_get_id(const dc_msg_t *msg)
Get the ID of the message.

dc_msg_t::dc_msg_get_saved_msg_id
uint32_t dc_msg_get_saved_msg_id(const dc_msg_t *msg)
Check if a message was saved and return its ID inside "Saved Messages".

dc_msg_t::dc_msg_get_info_type
int dc_msg_get_info_type(const dc_msg_t *msg)
Get the type of an informational message.

dc_msg_t::dc_msg_get_viewtype
int dc_msg_get_viewtype(const dc_msg_t *msg)
Get the type of the message.

dc_msg_t::dc_msg_get_sort_timestamp
int64_t dc_msg_get_sort_timestamp(const dc_msg_t *msg)
Get the message time used for sorting.

dc_msg_t::dc_msg_get_videochat_type
int dc_msg_get_videochat_type(const dc_msg_t *msg)
Get type of videochat.

dc_msg_t::dc_msg_get_height
int dc_msg_get_height(const dc_msg_t *msg)
Get the height of an image or a video.

dc_msg_t::dc_msg_get_error
char * dc_msg_get_error(const dc_msg_t *msg)
Gets the error status of the message.

dc_msg_t::dc_msg_is_sent
int dc_msg_is_sent(const dc_msg_t *msg)
Check if a message was sent successfully.

dc_msg_t::dc_msg_get_file
char * dc_msg_get_file(const dc_msg_t *msg)
Find out full path of the file associated with a message.

dc_msg_t::dc_msg_get_received_timestamp
int64_t dc_msg_get_received_timestamp(const dc_msg_t *msg)
Get the message receive time.

dc_msg_t::dc_msg_get_webxdc_info
char * dc_msg_get_webxdc_info(const dc_msg_t *msg)
Get info from a webxdc message, in JSON format.

dc_provider_t
Opaque object containing information about one single e-mail provider.

dc_provider_t::dc_provider_get_status
int dc_provider_get_status(const dc_provider_t *provider)
Whether DC works with this provider.

dc_provider_t::dc_provider_get_before_login_hint
char * dc_provider_get_before_login_hint(const dc_provider_t *provider)
Get hints to be shown to the user on the login screen.

dc_provider_t::dc_provider_get_overview_page
char * dc_provider_get_overview_page(const dc_provider_t *provider)
URL of the overview page.

dc_provider_t::dc_provider_new_from_email_with_dns
dc_provider_t * dc_provider_new_from_email_with_dns(const dc_context_t *context, const char *email)
Create a provider struct for the given e-mail address by local and DNS lookup.

dc_provider_t::dc_provider_new_from_email
dc_provider_t * dc_provider_new_from_email(const dc_context_t *context, const char *email)
Create a provider struct for the given e-mail address by local lookup.

dc_provider_t::dc_provider_unref
void dc_provider_unref(dc_provider_t *provider)
Free the provider info struct.