2013-10-04 18:53:11 +00:00
|
|
|
// a mini library of useful types and functions
|
|
|
|
|
|
|
|
#ifndef _INCLUDED_MINILIB_H
|
|
|
|
#define _INCLUDED_MINILIB_H
|
|
|
|
|
|
|
|
/** types *******************************************************/
|
|
|
|
|
2014-01-06 21:51:53 +00:00
|
|
|
#include <stdbool.h>
|
2013-10-04 18:53:11 +00:00
|
|
|
|
|
|
|
typedef unsigned char byte;
|
|
|
|
typedef unsigned int uint;
|
|
|
|
|
2014-02-04 22:44:55 +00:00
|
|
|
/** generic ops *************************************************/
|
|
|
|
|
2014-02-05 23:57:48 +00:00
|
|
|
#ifndef MIN
|
2014-02-04 22:44:55 +00:00
|
|
|
#define MIN(x, y) ((x) < (y) ? (x) : (y))
|
2014-02-05 23:57:48 +00:00
|
|
|
#endif
|
|
|
|
#ifndef MAX
|
2014-02-04 22:44:55 +00:00
|
|
|
#define MAX(x, y) ((x) > (y) ? (x) : (y))
|
2014-02-05 23:57:48 +00:00
|
|
|
#endif
|
2014-02-04 22:44:55 +00:00
|
|
|
|
2013-10-04 18:53:11 +00:00
|
|
|
/** memomry allocation ******************************************/
|
|
|
|
|
2013-12-29 19:33:23 +00:00
|
|
|
// TODO make a lazy m_renew that can increase by a smaller amount than requested (but by at least 1 more element)
|
|
|
|
|
2013-10-04 18:53:11 +00:00
|
|
|
#define m_new(type, num) ((type*)(m_malloc(sizeof(type) * (num))))
|
|
|
|
#define m_new0(type, num) ((type*)(m_malloc0(sizeof(type) * (num))))
|
2013-12-21 18:17:45 +00:00
|
|
|
#define m_new_obj(type) (m_new(type, 1))
|
|
|
|
#define m_new_obj_var(obj_type, var_type, var_num) ((obj_type*)m_malloc(sizeof(obj_type) + sizeof(var_type) * (var_num)))
|
2014-04-05 19:35:48 +00:00
|
|
|
#if MICROPY_ENABLE_FINALISER
|
|
|
|
#define m_new_obj_with_finaliser(type) ((type*)(m_malloc_with_finaliser(sizeof(type))))
|
|
|
|
#else
|
|
|
|
#define m_new_obj_with_finaliser(type) m_new_obj(type)
|
|
|
|
#endif
|
2013-12-29 19:33:23 +00:00
|
|
|
#define m_renew(type, ptr, old_num, new_num) ((type*)(m_realloc((ptr), sizeof(type) * (old_num), sizeof(type) * (new_num))))
|
|
|
|
#define m_del(type, ptr, num) m_free(ptr, sizeof(type) * (num))
|
|
|
|
#define m_del_obj(type, ptr) (m_del(type, ptr, 1))
|
2014-01-13 02:31:00 +00:00
|
|
|
#define m_del_var(obj_type, var_type, var_num, ptr) (m_free(ptr, sizeof(obj_type) + sizeof(var_type) * (var_num)))
|
2013-10-04 18:53:11 +00:00
|
|
|
|
|
|
|
void *m_malloc(int num_bytes);
|
2014-04-05 19:35:48 +00:00
|
|
|
void *m_malloc_with_finaliser(int num_bytes);
|
2013-10-04 18:53:11 +00:00
|
|
|
void *m_malloc0(int num_bytes);
|
2013-12-29 19:33:23 +00:00
|
|
|
void *m_realloc(void *ptr, int old_num_bytes, int new_num_bytes);
|
|
|
|
void m_free(void *ptr, int num_bytes);
|
2014-04-04 10:52:59 +00:00
|
|
|
void *m_malloc_fail(int num_bytes);
|
2013-10-04 18:53:11 +00:00
|
|
|
|
2013-10-23 19:20:17 +00:00
|
|
|
int m_get_total_bytes_allocated(void);
|
2014-01-01 21:15:47 +00:00
|
|
|
int m_get_current_bytes_allocated(void);
|
2014-01-01 21:42:21 +00:00
|
|
|
int m_get_peak_bytes_allocated(void);
|
2013-10-04 18:53:11 +00:00
|
|
|
|
|
|
|
/** unichar / UTF-8 *********************************************/
|
|
|
|
|
|
|
|
typedef int unichar; // TODO
|
|
|
|
|
2013-12-30 18:23:50 +00:00
|
|
|
unichar utf8_get_char(const char *s);
|
|
|
|
char *utf8_next_char(const char *s);
|
2013-10-04 18:53:11 +00:00
|
|
|
|
2014-01-06 21:51:53 +00:00
|
|
|
bool unichar_isspace(unichar c);
|
|
|
|
bool unichar_isalpha(unichar c);
|
|
|
|
bool unichar_isprint(unichar c);
|
|
|
|
bool unichar_isdigit(unichar c);
|
2014-01-22 20:40:02 +00:00
|
|
|
bool unichar_isxdigit(unichar c);
|
2013-10-04 18:53:11 +00:00
|
|
|
|
|
|
|
/** variable string *********************************************/
|
|
|
|
|
2013-10-20 13:39:58 +00:00
|
|
|
typedef struct _vstr_t {
|
2014-03-15 14:33:09 +00:00
|
|
|
uint alloc;
|
|
|
|
uint len;
|
2013-10-20 13:39:58 +00:00
|
|
|
char *buf;
|
2014-02-26 17:40:52 +00:00
|
|
|
bool had_error : 1;
|
|
|
|
bool fixed_buf : 1;
|
2013-10-20 13:39:58 +00:00
|
|
|
} vstr_t;
|
|
|
|
|
2014-02-06 21:11:19 +00:00
|
|
|
// convenience macro to declare a vstr with a fixed size buffer on the stack
|
|
|
|
#define VSTR_FIXED(vstr, alloc) vstr_t vstr; char vstr##_buf[(alloc)]; vstr_init_fixed_buf(&vstr, (alloc), vstr##_buf);
|
|
|
|
|
2014-01-13 21:15:23 +00:00
|
|
|
void vstr_init(vstr_t *vstr, int alloc);
|
2014-02-06 21:11:19 +00:00
|
|
|
void vstr_init_fixed_buf(vstr_t *vstr, int alloc, char *buf);
|
2013-10-20 13:39:58 +00:00
|
|
|
void vstr_clear(vstr_t *vstr);
|
2013-10-23 19:20:17 +00:00
|
|
|
vstr_t *vstr_new(void);
|
2014-01-13 21:15:23 +00:00
|
|
|
vstr_t *vstr_new_size(int alloc);
|
2013-10-04 18:53:11 +00:00
|
|
|
void vstr_free(vstr_t *vstr);
|
|
|
|
void vstr_reset(vstr_t *vstr);
|
2014-01-06 21:51:53 +00:00
|
|
|
bool vstr_had_error(vstr_t *vstr);
|
2013-10-04 18:53:11 +00:00
|
|
|
char *vstr_str(vstr_t *vstr);
|
|
|
|
int vstr_len(vstr_t *vstr);
|
|
|
|
void vstr_hint_size(vstr_t *vstr, int size);
|
2014-02-06 21:11:19 +00:00
|
|
|
char *vstr_extend(vstr_t *vstr, int size);
|
2014-01-13 21:15:23 +00:00
|
|
|
bool vstr_set_size(vstr_t *vstr, int size);
|
|
|
|
bool vstr_shrink(vstr_t *vstr);
|
2013-10-04 18:53:11 +00:00
|
|
|
char *vstr_add_len(vstr_t *vstr, int len);
|
2013-10-20 13:39:58 +00:00
|
|
|
void vstr_add_byte(vstr_t *vstr, byte v);
|
|
|
|
void vstr_add_char(vstr_t *vstr, unichar chr);
|
2013-10-04 18:53:11 +00:00
|
|
|
void vstr_add_str(vstr_t *vstr, const char *str);
|
|
|
|
void vstr_add_strn(vstr_t *vstr, const char *str, int len);
|
2013-10-20 13:39:58 +00:00
|
|
|
//void vstr_add_le16(vstr_t *vstr, unsigned short v);
|
|
|
|
//void vstr_add_le32(vstr_t *vstr, unsigned int v);
|
2014-03-15 14:33:09 +00:00
|
|
|
void vstr_ins_byte(vstr_t *vstr, uint byte_pos, byte b);
|
|
|
|
void vstr_ins_char(vstr_t *vstr, uint char_pos, unichar chr);
|
|
|
|
void vstr_cut_head_bytes(vstr_t *vstr, uint bytes_to_cut);
|
|
|
|
void vstr_cut_tail_bytes(vstr_t *vstr, uint bytes_to_cut);
|
|
|
|
void vstr_cut_out_bytes(vstr_t *vstr, uint byte_pos, uint bytes_to_cut);
|
2013-11-03 18:20:56 +00:00
|
|
|
void vstr_printf(vstr_t *vstr, const char *fmt, ...);
|
2013-11-03 18:30:10 +00:00
|
|
|
|
2014-02-04 22:47:06 +00:00
|
|
|
/** non-dynamic size-bounded variable buffer/string *************/
|
|
|
|
|
|
|
|
#define CHECKBUF(buf, max_size) char buf[max_size + 1]; uint buf##_len = max_size; char *buf##_p = buf;
|
2014-02-05 23:57:48 +00:00
|
|
|
#define CHECKBUF_RESET(buf, max_size) buf##_len = max_size; buf##_p = buf;
|
2014-02-04 22:47:06 +00:00
|
|
|
#define CHECKBUF_APPEND(buf, src, src_len) \
|
|
|
|
{ int l = MIN(src_len, buf##_len); \
|
|
|
|
memcpy(buf##_p, src, l); \
|
|
|
|
buf##_len -= l; \
|
|
|
|
buf##_p += l; }
|
|
|
|
#define CHECKBUF_APPEND_0(buf) { *buf##_p = 0; }
|
|
|
|
#define CHECKBUF_LEN(buf) (buf##_p - buf)
|
|
|
|
|
2013-11-03 18:30:10 +00:00
|
|
|
#ifdef va_start
|
2013-11-03 18:20:56 +00:00
|
|
|
void vstr_vprintf(vstr_t *vstr, const char *fmt, va_list ap);
|
2013-11-03 18:30:10 +00:00
|
|
|
#endif
|
2013-10-04 18:53:11 +00:00
|
|
|
|
2014-02-16 16:11:42 +00:00
|
|
|
// Debugging helpers
|
|
|
|
int DEBUG_printf(const char *fmt, ...);
|
|
|
|
|
2013-10-04 18:53:11 +00:00
|
|
|
#endif // _INCLUDED_MINILIB_H
|