string.h

Go to the documentation of this file.

#ifndef LIBCLOD_STRING_H
#define LIBCLOD_STRING_H
 
#include <clod/lib.h>
#include <stdarg.h>

struct clod_string {
    char *ptr;

    ptrdiff_t len;

    ptrdiff_t cap;
};

#define CLOD_STRING_NULL ((struct clod_string){0})

#define CLOD_STRING_C(cstr) ((struct clod_string){ .ptr = (char*)(cstr), .len = sizeof((char[]){cstr}) - 1, .cap = 0 })

#define CLOD_STRING_NEW(size) ((struct clod_string){ .ptr = (char[size]){0}, .len = 0, .cap = (size) })

#define CLOD_STRING_OBJECT(object) ((struct clod_string){ .ptr = (char*)(object), .len = sizeof(*(object)), .cap = sizeof(*(object)) })

CLOD_API
struct clod_string clod_string_from_cstr(const char *cstr);

CLOD_API CLOD_NONNULL(1)
size_t clod_string_cat(struct clod_string *dst, struct clod_string src);

CLOD_API CLOD_NONNULL(1)
size_t clod_string_insert(struct clod_string *dst, struct clod_string src);

CLOD_API
int clod_string_cmp(struct clod_string str1, struct clod_string str2);

CLOD_API CLOD_NONNULL(1)
void clod_string_put_char(struct clod_string *str, char c);

CLOD_API CLOD_NONNULL(1)
char clod_string_get_char(struct clod_string *str);

CLOD_API
char clod_string_peek_char(struct clod_string str);

CLOD_API
size_t clod_string_format(struct clod_string *dst, struct clod_string fmt, ...);

CLOD_API
size_t clod_string_vformat(struct clod_string *dst, struct clod_string fmt, va_list args);

CLOD_API
int clod_string_parse(struct clod_string src, struct clod_string fmt, ...);

CLOD_API
int clod_string_vparse(struct clod_string src, struct clod_string fmt, va_list args);

CLOD_API
struct clod_string clod_string_contains(struct clod_string str, struct clod_string elem);

CLOD_API
struct clod_string clod_string_find(struct clod_string str, char elem, int occurrence);

CLOD_API
bool clod_string_remove_prefix(struct clod_string *str, struct clod_string prefix);
 
#define CLOD_STRING_DIGIT_ALPHABET CLOD_STRING_C("0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ-_")
#define CLOD_STRING_DIGIT_ALPHABET_CAPS CLOD_STRING_C("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-_")

CLOD_API
size_t clod_string_put_int(struct clod_string *dst, intmax_t val,
    struct clod_string alphabet, unsigned char base, unsigned char min_digits, unsigned char max_digits);

CLOD_API
intmax_t clod_string_get_int(struct clod_string *str,
    struct clod_string alphabet, unsigned char base);

CLOD_API
size_t clod_string_put_uint(struct clod_string *dst, uintmax_t val,
    struct clod_string alphabet, unsigned char base, unsigned char min_digits, unsigned char max_digits);

CLOD_API
uintmax_t clod_string_get_uint(struct clod_string *str,
    struct clod_string alphabet, unsigned char base);

CLOD_API
size_t clod_string_put_double(struct clod_string *dst, double val,
    struct clod_string alphabet, unsigned char base, unsigned char min_digits, unsigned char max_digits);

CLOD_API
double clod_string_get_double(struct clod_string *str,
    struct clod_string alphabet, unsigned char base);
 
#endif