103 lines
4.0 KiB
C
103 lines
4.0 KiB
C
#ifndef STR8_H
|
|
#define STR8_H
|
|
|
|
#include "./str8_list.h"
|
|
#include "../../../common/aliases/aliases.h"
|
|
#include "../../mem/allocator/mem_allocator.h"
|
|
#include <string.h>
|
|
#include <stdbool.h>
|
|
|
|
#ifdef __cplusplus
|
|
BEGIN_C_LINKAGE
|
|
#endif // !__cplusplus
|
|
|
|
typedef struct str8 Str8;
|
|
struct str8 {
|
|
u64 capacity;
|
|
u64 size;
|
|
c8 *buf;
|
|
};
|
|
|
|
typedef const Str8 Str8RO;
|
|
|
|
/**
|
|
* Utilities to be used with printf functions
|
|
*/
|
|
#define WAPP_STR8_SPEC "%.*s"
|
|
#define wapp_str8_varg(STRING) (int)((STRING).size), (STRING).buf
|
|
|
|
/**
|
|
* Str8 stack buffers
|
|
*/
|
|
#define wapp_str8_buf(CAPACITY) ((Str8){.capacity = CAPACITY, .size = 0, .buf = (c8[CAPACITY]){0}})
|
|
|
|
// Utilises the fact that memcpy returns pointer to dest buffer and that getting
|
|
// address of compound literals is valid in C to create a string on the stack
|
|
#define wapp_str8_lit(STRING) ((Str8){.capacity = (sizeof(STRING) - 1) * 2, \
|
|
.size = sizeof(STRING) - 1, \
|
|
.buf = memcpy(&((c8 [sizeof(STRING) * 2]){0}), STRING, sizeof(STRING))})
|
|
#define wapp_str8_lit_ro(STRING) ((Str8RO){.capacity = sizeof(STRING) - 1, \
|
|
.size = sizeof(STRING) - 1, \
|
|
.buf = (c8 *)STRING})
|
|
// To be used only when initialising a static storage variable in compilers that don't support
|
|
// initialisers with the syntax of wapp_str8_lit_ro (e.g. gcc). Should only be used when necessary
|
|
// and only be assigned to a Str8RO variable to avoid any attempt at modifying the string
|
|
#define wapp_str8_lit_ro_initialiser_list(STRING) {.capacity = sizeof(STRING) - 1, \
|
|
.size = sizeof(STRING) - 1, \
|
|
.buf = (c8 *)STRING}
|
|
|
|
/**
|
|
* Str8 allocated buffers
|
|
*/
|
|
Str8 *wapp_str8_alloc_buf(const Allocator *allocator, u64 capacity);
|
|
Str8 *wapp_str8_alloc_cstr(const Allocator *allocator, const char *str);
|
|
Str8 *wapp_str8_alloc_str8(const Allocator *allocator, Str8RO *str);
|
|
Str8 *wapp_str8_alloc_substr(const Allocator *allocator, Str8RO *str, u64 start, u64 end);
|
|
Str8 *wapp_str8_alloc_concat(const Allocator *allocator, Str8 *dst, Str8RO *src);
|
|
// Only needed for allocators like malloc where each allocation has to be freed on its own.
|
|
// No need to use it for allocators like Arena.
|
|
void wapp_str8_dealloc_buf(const Allocator *allocator, Str8 **str);
|
|
|
|
/**
|
|
* Str8 utilities
|
|
*/
|
|
c8 wapp_str8_get(Str8RO *str, u64 index);
|
|
void wapp_str8_set(Str8 *str, u64 index, c8 c);
|
|
void wapp_str8_push_back(Str8 *str, c8 c);
|
|
bool wapp_str8_equal(Str8RO *s1, Str8RO *s2);
|
|
bool wapp_str8_equal_to_count(Str8RO* s1, Str8RO* s2, u64 count);
|
|
Str8 wapp_str8_slice(Str8RO *str, u64 start, u64 end);
|
|
void wapp_str8_concat_capped(Str8 *dst, Str8RO *src);
|
|
void wapp_str8_copy_cstr_capped(Str8 *dst, const char *src);
|
|
void wapp_str8_copy_str8_capped(Str8 *dst, Str8RO *src);
|
|
void wapp_str8_copy_to_cstr(char *dst, Str8RO *src, u64 dst_capacity);
|
|
void wapp_str8_format(Str8 *dst, const char *format, ...);
|
|
|
|
/**
|
|
* Str8 find functions
|
|
*/
|
|
i64 wapp_str8_find(Str8RO *str, Str8RO substr);
|
|
i64 wapp_str8_rfind(Str8RO *str, Str8RO substr);
|
|
|
|
/**
|
|
* Str8 split and join
|
|
*/
|
|
#define wapp_str8_split(ALLOCATOR, STR, DELIMITER) wapp_str8_split_with_max(ALLOCATOR, STR, DELIMITER, -1)
|
|
#define wapp_str8_rsplit(ALLOCATOR, STR, DELIMITER) wapp_str8_rsplit_with_max(ALLOCATOR, STR, DELIMITER, -1)
|
|
Str8List *wapp_str8_split_with_max(const Allocator *allocator, Str8RO *str, Str8RO *delimiter, i64 max_splits);
|
|
Str8List *wapp_str8_rsplit_with_max(const Allocator *allocator, Str8RO *str, Str8RO *delimiter, i64 max_splits);
|
|
Str8 *wapp_str8_join(const Allocator *allocator, const Str8List *list, Str8RO *delimiter);
|
|
|
|
/**
|
|
* Str8 list utilities
|
|
*/
|
|
#define wapp_str8_node_from_cstr(STRING) ((Str8Node){.item = &wapp_str8_lit(STRING)})
|
|
#define wapp_str8_node_from_str8(STRING) ((Str8Node){.item = &(STRING)})
|
|
u64 wapp_str8_list_total_size(const Str8List *list);
|
|
|
|
#ifdef __cplusplus
|
|
END_C_LINKAGE
|
|
#endif // !__cplusplus
|
|
|
|
#endif // !STR8_H
|