blob: 8c2c85491dfb238e6487ca5de226c8b2634096ee [file] [log] [blame]
Damien429d7192013-10-04 19:53:11 +01001// a mini library of useful types and functions
2
3#ifndef _INCLUDED_MINILIB_H
4#define _INCLUDED_MINILIB_H
5
6/** types *******************************************************/
7
ian-v5fd8fd22014-01-06 13:51:53 -08008#include <stdbool.h>
Damien429d7192013-10-04 19:53:11 +01009
10typedef unsigned char byte;
11typedef unsigned int uint;
12
13/** memomry allocation ******************************************/
14
Damien732407f2013-12-29 19:33:23 +000015// TODO make a lazy m_renew that can increase by a smaller amount than requested (but by at least 1 more element)
16
Damien429d7192013-10-04 19:53:11 +010017#define m_new(type, num) ((type*)(m_malloc(sizeof(type) * (num))))
18#define m_new0(type, num) ((type*)(m_malloc0(sizeof(type) * (num))))
Damiend99b0522013-12-21 18:17:45 +000019#define m_new_obj(type) (m_new(type, 1))
20#define m_new_obj_var(obj_type, var_type, var_num) ((obj_type*)m_malloc(sizeof(obj_type) + sizeof(var_type) * (var_num)))
Damien732407f2013-12-29 19:33:23 +000021#define m_renew(type, ptr, old_num, new_num) ((type*)(m_realloc((ptr), sizeof(type) * (old_num), sizeof(type) * (new_num))))
22#define m_del(type, ptr, num) m_free(ptr, sizeof(type) * (num))
23#define m_del_obj(type, ptr) (m_del(type, ptr, 1))
John R. Lenton07205ec2014-01-13 02:31:00 +000024#define m_del_var(obj_type, var_type, var_num, ptr) (m_free(ptr, sizeof(obj_type) + sizeof(var_type) * (var_num)))
Damien429d7192013-10-04 19:53:11 +010025
Damien429d7192013-10-04 19:53:11 +010026void *m_malloc(int num_bytes);
27void *m_malloc0(int num_bytes);
Damien732407f2013-12-29 19:33:23 +000028void *m_realloc(void *ptr, int old_num_bytes, int new_num_bytes);
29void m_free(void *ptr, int num_bytes);
Damien429d7192013-10-04 19:53:11 +010030
Damien8b3a7c22013-10-23 20:20:17 +010031int m_get_total_bytes_allocated(void);
Paul Sokolovsky02de0c52014-01-01 23:15:47 +020032int m_get_current_bytes_allocated(void);
Paul Sokolovsky780f5552014-01-01 23:42:21 +020033int m_get_peak_bytes_allocated(void);
Damien429d7192013-10-04 19:53:11 +010034
35/** unichar / UTF-8 *********************************************/
36
37typedef int unichar; // TODO
38
Damien George8cc96a32013-12-30 18:23:50 +000039unichar utf8_get_char(const char *s);
40char *utf8_next_char(const char *s);
Damien429d7192013-10-04 19:53:11 +010041
ian-v5fd8fd22014-01-06 13:51:53 -080042bool unichar_isspace(unichar c);
43bool unichar_isalpha(unichar c);
44bool unichar_isprint(unichar c);
45bool unichar_isdigit(unichar c);
Damien429d7192013-10-04 19:53:11 +010046
47/** string ******************************************************/
48
49/*
50#define streq(s1, s2) (strcmp((s1), (s2)) == 0)
51*/
52
53/** variable string *********************************************/
54
Damien68f59a92013-10-20 14:39:58 +010055typedef struct _vstr_t {
56 int alloc;
57 int len;
58 char *buf;
ian-v5fd8fd22014-01-06 13:51:53 -080059 bool had_error;
Damien68f59a92013-10-20 14:39:58 +010060} vstr_t;
Damien429d7192013-10-04 19:53:11 +010061
Paul Sokolovsky5d2499c2014-01-13 23:15:23 +020062void vstr_init(vstr_t *vstr, int alloc);
Damien68f59a92013-10-20 14:39:58 +010063void vstr_clear(vstr_t *vstr);
Damien8b3a7c22013-10-23 20:20:17 +010064vstr_t *vstr_new(void);
Paul Sokolovsky5d2499c2014-01-13 23:15:23 +020065vstr_t *vstr_new_size(int alloc);
Damien429d7192013-10-04 19:53:11 +010066void vstr_free(vstr_t *vstr);
67void vstr_reset(vstr_t *vstr);
ian-v5fd8fd22014-01-06 13:51:53 -080068bool vstr_had_error(vstr_t *vstr);
Damien429d7192013-10-04 19:53:11 +010069char *vstr_str(vstr_t *vstr);
70int vstr_len(vstr_t *vstr);
71void vstr_hint_size(vstr_t *vstr, int size);
Paul Sokolovsky5d2499c2014-01-13 23:15:23 +020072char *vstr_extend(vstr_t *vstr, int size);
73bool vstr_set_size(vstr_t *vstr, int size);
74bool vstr_shrink(vstr_t *vstr);
Damien429d7192013-10-04 19:53:11 +010075char *vstr_add_len(vstr_t *vstr, int len);
Damien68f59a92013-10-20 14:39:58 +010076void vstr_add_byte(vstr_t *vstr, byte v);
77void vstr_add_char(vstr_t *vstr, unichar chr);
Damien429d7192013-10-04 19:53:11 +010078void vstr_add_str(vstr_t *vstr, const char *str);
79void vstr_add_strn(vstr_t *vstr, const char *str, int len);
Damien68f59a92013-10-20 14:39:58 +010080//void vstr_add_le16(vstr_t *vstr, unsigned short v);
81//void vstr_add_le32(vstr_t *vstr, unsigned int v);
Damien429d7192013-10-04 19:53:11 +010082void vstr_cut_tail(vstr_t *vstr, int len);
Damien2f06c572013-11-03 18:20:56 +000083void vstr_printf(vstr_t *vstr, const char *fmt, ...);
Paul Sokolovsky36c44992014-01-13 19:20:46 +020084// TODO: do we need wrapper at all?
85void vstr_printf_wrapper(void *env, const char *fmt, ...);
Damien96a0add2013-11-03 18:30:10 +000086
87#ifdef va_start
Damien2f06c572013-11-03 18:20:56 +000088void vstr_vprintf(vstr_t *vstr, const char *fmt, va_list ap);
Damien96a0add2013-11-03 18:30:10 +000089#endif
Damien429d7192013-10-04 19:53:11 +010090
91/** unique string ***********************************************/
92
93typedef unsigned int qstr;
94
Damien8b3a7c22013-10-23 20:20:17 +010095void qstr_init(void);
Damien429d7192013-10-04 19:53:11 +010096qstr qstr_from_str_static(const char *str);
Damien732407f2013-12-29 19:33:23 +000097qstr qstr_from_str_take(char *str, int alloc_len);
Damien429d7192013-10-04 19:53:11 +010098qstr qstr_from_strn_copy(const char *str, int len);
99const char* qstr_str(qstr qstr);
100
101#endif // _INCLUDED_MINILIB_H