mirror of
https://github.com/deltachat/deltachat-core.git
synced 2025-10-05 02:29:28 +02:00
22ebb26843
MIME mails for both messages and MDNs are stored in the blobdir. There are still two job types due to their different priorities, but they are processed by the same function now (dc_job_do_DC_JOB_SEND).
111 lines
6.2 KiB
C
111 lines
6.2 KiB
C
/* Some tools and enhancements to the used libraries, there should be
|
|
no references to dc_context_t and other "larger" classes here. */
|
|
|
|
|
|
#ifndef __DC_TOOLS_H__
|
|
#define __DC_TOOLS_H__
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
#include <libetpan/libetpan.h> // for carray etc.
|
|
|
|
|
|
/*** library-private **********************************************************/
|
|
|
|
/* math tools */
|
|
int dc_exactly_one_bit_set (int v);
|
|
|
|
/* string tools */
|
|
#define DC_EDITORIAL_OPEN "["
|
|
#define DC_EDITORIAL_CLOSE "]"
|
|
#define DC_EDITORIAL_ELLIPSE DC_EDITORIAL_OPEN "..." DC_EDITORIAL_CLOSE
|
|
#define DC_NDASH "\xE2\x80\x93"
|
|
|
|
char* dc_strdup (const char*); /* dc_strdup() returns empty string if NULL is given, never returns NULL (exits on errors) */
|
|
char* dc_strdup_keep_null (const char*); /* strdup(NULL) is undefined, safe_strdup_keep_null(NULL) returns NULL in this case */
|
|
int dc_atoi_null_is_0 (const char*);
|
|
void dc_ltrim (char*);
|
|
void dc_rtrim (char*);
|
|
void dc_trim (char*);
|
|
char* dc_strlower (const char*); /* the result must be free()'d */
|
|
void dc_strlower_in_place (char*);
|
|
int dc_str_replace (char** haystack, const char* needle, const char* replacement);
|
|
int dc_str_contains (const char* haystack, const char* needle);
|
|
char* dc_null_terminate (const char*, int bytes); /* the result must be free()'d */
|
|
char* dc_mprintf (const char* format, ...); /* The result must be free()'d. */
|
|
char* dc_binary_to_uc_hex (const uint8_t* buf, size_t bytes);
|
|
void dc_remove_cr_chars (char*); /* remove all \r characters from string */
|
|
void dc_unify_lineends (char*);
|
|
void dc_replace_bad_utf8_chars (char*); /* replace bad UTF-8 characters by sequences of `_` (to avoid problems in filenames, we do not use eg. `?`) the function is useful if strings are unexpectingly encoded eg. as ISO-8859-1 */
|
|
void dc_truncate_str (char*, int approx_characters);
|
|
void dc_truncate_n_unwrap_str (char*, int approx_characters, int do_unwrap);
|
|
carray* dc_split_into_lines (const char* buf_terminated); /* split string into lines*/
|
|
void dc_free_splitted_lines (carray* lines);
|
|
char* dc_insert_breaks (const char*, int break_every, const char* break_chars); /* insert a break every n characters, the return must be free()'d */
|
|
char* dc_str_from_clist (const clist*, const char* delimiter);
|
|
clist* dc_str_to_clist (const char*, const char* delimiter);
|
|
int dc_str_to_color (const char*);
|
|
|
|
// from libetpan/src/data-types/base64.h (which cannot be included without adding libetpan/src/... to the include-search-paths, which would result in double-file-name-errors, so, for now, we use this hack)
|
|
char* encode_base64 (const char * in, int len);
|
|
|
|
/* clist tools */
|
|
void clist_free_content (const clist*); /* calls free() for each item content */
|
|
int clist_search_string_nocase (const clist*, const char* str);
|
|
char* clist_join (const clist*, char separator);
|
|
|
|
/* date/time tools */
|
|
#define DC_INVALID_TIMESTAMP (-1)
|
|
#define DC_SECONDS_PER_DAY 86400
|
|
time_t dc_timestamp_from_date (struct mailimf_date_time * date_time); /* the result is UTC or DC_INVALID_TIMESTAMP */
|
|
char* dc_timestamp_to_str (time_t); /* the return value must be free()'d */
|
|
struct mailimap_date_time* dc_timestamp_to_mailimap_date_time (time_t);
|
|
long dc_gm2local_offset (void);
|
|
|
|
/* timesmearing */
|
|
time_t dc_smeared_time (dc_context_t*);
|
|
time_t dc_create_smeared_timestamp (dc_context_t*);
|
|
time_t dc_create_smeared_timestamps (dc_context_t*, int count);
|
|
|
|
/* Message-ID tools */
|
|
#define DC_CREATE_ID_LEN 11
|
|
char* dc_create_id (void);
|
|
char* dc_create_incoming_rfc724_mid (time_t message_timestamp, uint32_t contact_id_from, dc_array_t* contact_ids_to);
|
|
char* dc_create_outgoing_rfc724_mid (const char* grpid, const char* addr);
|
|
char* dc_extract_grpid_from_rfc724_mid (const char* rfc724_mid);
|
|
char* dc_extract_grpid_from_rfc724_mid_list(const clist* rfc724_mid_list);
|
|
|
|
|
|
/* file tools */
|
|
void dc_ensure_no_slash (char* pathNfilename);
|
|
void dc_validate_filename (char* filename);
|
|
char* dc_get_filename (const char* pathNfilename);
|
|
void dc_split_filename (const char* pathNfilename, char** ret_basename, char** ret_all_suffixes_incl_dot); // the case of the suffix is preserved
|
|
char* dc_get_filesuffix_lc (const char* pathNfilename); // the returned suffix is lower-case
|
|
int dc_get_filemeta (const void* buf, size_t buf_bytes, uint32_t* ret_width, uint32_t *ret_height);
|
|
char* dc_get_abs_path (dc_context_t*, const char* pathNfilename);
|
|
int dc_file_exist (dc_context_t*, const char* pathNfilename);
|
|
uint64_t dc_get_filebytes (dc_context_t*, const char* pathNfilename);
|
|
int dc_delete_file (dc_context_t*, const char* pathNFilename);
|
|
int dc_copy_file (dc_context_t*, const char* pathNFilename, const char* dest_pathNFilename);
|
|
int dc_create_folder (dc_context_t*, const char* pathNfilename);
|
|
int dc_write_file (dc_context_t*, const char* pathNfilename, const void* buf, size_t buf_bytes);
|
|
int dc_read_file (dc_context_t*, const char* pathNfilename, void** buf, size_t* buf_bytes);
|
|
char* dc_get_fine_pathNfilename (dc_context_t*, const char* pathNfolder, const char* desired_name);
|
|
int dc_is_blobdir_path (dc_context_t*, const char* path);
|
|
void dc_make_rel_path (dc_context_t*, char** pathNfilename);
|
|
int dc_make_rel_and_copy (dc_context_t*, char** pathNfilename);
|
|
|
|
/* macros */
|
|
#define DC_QUOTEHELPER(name) #name
|
|
#define DC_STRINGIFY(macro) DC_QUOTEHELPER(macro)
|
|
#define DC_MIN(X, Y) (((X) < (Y))? (X) : (Y))
|
|
#define DC_MAX(X, Y) (((X) > (Y))? (X) : (Y))
|
|
|
|
|
|
#ifdef __cplusplus
|
|
} /* /extern "C" */
|
|
#endif
|
|
#endif /* __DC_TOOLS_H__ */
|