sstr.h

Go to the documentation of this file.

 
#ifndef SSTR_H_
#define SSTR_H_
 
#include <stdarg.h>
#include <stddef.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define SHORT_STR_CAPACITY 25
#define CAP_ADD_DELTA 256
 
struct sstr_s {
    size_t length;  // MUST FIRST, see sstr_length at sstr.h
    char type;
    union {
        // short string store datas in short_str
        char short_str[SHORT_STR_CAPACITY + 1];
        // long string allocate a buffer and store datas in long_str
        struct {
            size_t capacity;
            char* data;
        } long_str;
        // reference to a memory buffer
        struct {
            char* data;
        } ref_str;
    } un;
};
 
#define SSTR_TYPE_SHORT 0
#define SSTR_TYPE_LONG 1
#define SSTR_TYPE_REF 2
 
typedef void* sstr_t;
 
sstr_t sstr_new();
 
void sstr_free(sstr_t s);
 
sstr_t sstr_of(const void* data, size_t length);
 
sstr_t sstr_ref(const void* data, size_t length);
 
sstr_t sstr(const char* cstr);
 
char* sstr_cstr(sstr_t s);
 
#define sstr_length(s) ((struct sstr_s*)s)->length
 
int sstr_compare(sstr_t a, sstr_t b);
 
int sstr_compare_c(sstr_t a, const char* b);
 
void sstr_append_zero(sstr_t s, size_t length);
 
void sstr_append_of(sstr_t s, const void* data, size_t length);
 
void sstr_append(sstr_t dst, sstr_t src);
 
void sstr_append_cstr(sstr_t dst, const char* src);
 
sstr_t sstr_dup(sstr_t s);
 
sstr_t sstr_substr(sstr_t s, size_t index, size_t len);
 
void sstr_clear(sstr_t s);
 
sstr_t sstr_vslprintf(const char* fmt, va_list args);
 
sstr_t sstr_vslprintf_append(sstr_t buf, const char* fmt, va_list args);
 
sstr_t sstr_printf(const char* fmt, ...);
 
sstr_t sstr_printf_append(sstr_t buf, const char* fmt, ...);
 
 
void sstr_append_int_str(sstr_t s, int i);
int sstr_parse_long(sstr_t s, long* v);
int sstr_parse_int(sstr_t* s, int* v);
void sstr_append_long_str(sstr_t s, long l);
void sstr_append_float_str(sstr_t s, float f, int precission);
void sstr_append_double_str(sstr_t s, double f, int precision);
int sstr_parse_double(sstr_t s, double* v);
 
void sstr_append_of_if(sstr_t s, const void* data, size_t length, int cond);
#define sstr_append_cstr_if(dst, src, cond) \
    sstr_append_of_if(dst, src, strlen(src), cond)
 
// escape string to json string format
int sstr_json_escape_string_append(sstr_t out, sstr_t in);
 
void sstr_append_indent(sstr_t s, size_t indent);
 
const char* sstr_version();
 
#ifdef __cplusplus
}
#endif
 
#endif /* SSTR_H_  */