Nils O. Selåsdal
76 lines
1.6 KiB
C
76 lines
1.6 KiB
C
#ifndef UC_DSTR_H_
|
|
#define UC_DSTR_H_
|
|
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** A dynamic string.
|
|
* The string might not always be nul terminated,
|
|
* Normally, use uc_dstr_str() to manipulate the managed string
|
|
* instead of accessing ->str directly.
|
|
*/
|
|
struct DStr {
|
|
size_t len;
|
|
size_t allocated;
|
|
char *str;
|
|
};
|
|
|
|
#define UC_DSTR_STATIC_INIT {0, 0, NULL}
|
|
|
|
/** Initialize a DStr.
|
|
* Note that str->str will be NULL after initialization.
|
|
*
|
|
*/
|
|
void uc_dstr_init(struct DStr *str);
|
|
|
|
/** Destroy/free the string.
|
|
* (Does not free str itself, only the managed resource of the str)
|
|
*/
|
|
void uc_dstr_destroy(struct DStr *str);
|
|
|
|
/**
|
|
* @return the available/unused tail bytes in the string
|
|
*/
|
|
size_t uc_dstr_available(const struct DStr *str);
|
|
|
|
/** Ensure the DStr is of at least 'len' bytes,
|
|
* allocating room if needed.
|
|
*/
|
|
int uc_dstr_ensure(struct DStr *str, size_t len);
|
|
|
|
void uc_dstr_reset(struct DStr *str);
|
|
|
|
void uc_dstr_terminate(struct DStr *str);
|
|
|
|
char *uc_dstr_str(struct DStr *str);
|
|
|
|
char *uc_dstr_put(struct DStr *str, size_t len);
|
|
|
|
size_t uc_dstr_put_str_filter(struct DStr *str, const char *s, int (*is_x)(int c));
|
|
|
|
int uc_dstr_put_str_sz(struct DStr *str, const char *s, size_t len);
|
|
|
|
int uc_dstr_put_str(struct DStr *str, const char *s);
|
|
|
|
int uc_dstr_put_char(struct DStr *str, char c);
|
|
|
|
void uc_dstr_own(struct DStr *str, char *s);
|
|
|
|
char *uc_dstr_steal(struct DStr *str);
|
|
|
|
void uc_str_swap(struct DStr *a, struct DStr *b);
|
|
|
|
size_t uc_dstr_replace(struct DStr *str, char f, char r);
|
|
|
|
void uc_dstr_trim(struct DStr *str);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|
|
|