kstring.h

Go to the documentation of this file.

 
#pragma once
 
#include "defines.h"
#include "math/math_types.h"
#include "strings/kname.h"
#include "strings/kstring_id.h"
 
#include <stdio.h>
 
KAPI u64 string_length(const char* str);
 
KAPI u32 string_utf8_length(const char* str);
 
KAPI u64 string_nlength(const char* str, u32 max_len);
 
KAPI u32 string_utf8_nlength(const char* str, u32 max_len);
 
KAPI b8 bytes_to_codepoint(const char* bytes, u32 offset, i32* out_codepoint, u8* out_advance);
 
KAPI b8 char_is_whitespace(char c);
 
KAPI b8 codepoint_is_whitespace(i32 codepoint);
 
KAPI char* string_duplicate(const char* str);
 
KAPI void string_free(const char* str);
 
KAPI i64 kstr_ncmp(const char* str0, const char* str1, u32 max_len);
 
KAPI i64 kstr_ncmpi(const char* str0, const char* str1, u32 max_len);
 
KAPI b8 strings_equal(const char* str0, const char* str1);
 
KAPI b8 strings_equali(const char* str0, const char* str1);
 
KAPI b8 strings_nequal(const char* str0, const char* str1, u32 max_len);
 
KAPI b8 strings_nequali(const char* str0, const char* str1, u32 max_len);
 
KAPI char* string_format(const char* format, ...);
 
KAPI char* string_format_v(const char* format, va_list va_listp);
 
KDEPRECATED("This version of string format is legacy, and unsafe. Use string_nformat() or string_format() instead.")
KAPI i32 string_format_unsafe(char* dest, const char* format, ...);
 
KDEPRECATED("This version of string format variadic is legacy, and unsafe. Use string_nformat_v() or string_format_v() instead.")
KAPI i32 string_format_v_unsafe(char* dest, const char* format, void* va_list);
 
KAPI i32 string_nformat(char* dest, u32 max_len, const char* format, ...);
 
KAPI i32 string_nformat_v(char* dest, u32 max_len, const char* format, void* va_list);
 
KAPI char* string_empty(char* str);
 
KAPI char* string_copy(char* dest, const char* source);
 
KAPI char* string_ncopy(char* dest, const char* source, u32 max_len);
 
KAPI char* string_trim(char* str);
 
KAPI void string_mid(char* dest, const char* source, i32 start, i32 length);
 
KAPI i32 string_index_of(const char* str, char c);
 
KAPI i32 string_last_index_of(const char* str, char c);
 
KAPI i32 string_index_of_str(const char* str_0, const char* str_1);
 
KAPI b8 string_starts_with(const char* str_0, const char* str_1);
 
KAPI b8 string_starts_withi(const char* str_0, const char* str_1);
 
KAPI void string_insert_char_at(char* dest, const char* src, u32 pos, char c);
KAPI void string_insert_str_at(char* dest, const char* src, u32 pos, const char* str);
KAPI void string_remove_at(char* dest, const char* src, u32 pos, u32 length);
 
KAPI i32 string_replace_char(char* str, char find, char replace);
 
KAPI u32 string_replace_char_all(char* str, char find, char replace);
 
KAPI b8 string_to_mat4(const char* str, mat4* out_mat);
 
KAPI const char* mat4_to_string(mat4 m);
 
KAPI b8 string_to_rect_2di(const char* str, rect_2di* rect);
 
KAPI const char* rect_2di_to_string(rect_2di rect);
 
KAPI b8 string_to_vec4(const char* str, vec4* out_vector);
 
KAPI const char* vec4_to_string(vec4 v);
 
KAPI b8 string_to_vec3(const char* str, vec3* out_vector);
 
KAPI const char* vec3_to_string(vec3 v);
 
KAPI b8 string_to_vec2(const char* str, vec2* out_vector);
 
KAPI const char* vec2_to_string(vec2 v);
 
KAPI b8 string_to_f32(const char* str, f32* f);
 
KAPI const char* f32_to_string(f32 f);
 
KAPI b8 string_to_f64(const char* str, f64* f);
 
KAPI const char* f64_to_string(f64 f);
 
KAPI b8 string_to_i8(const char* str, i8* i);
 
KAPI const char* i8_to_string(i8 i);
 
KAPI b8 string_to_i16(const char* str, i16* i);
 
KAPI const char* i16_to_string(i16 i);
 
KAPI b8 string_to_i32(const char* str, i32* i);
 
KAPI const char* i32_to_string(i32 i);
 
KAPI b8 string_to_i64(const char* str, i64* i);
 
KAPI const char* i64_to_string(i64 i);
 
KAPI b8 string_to_u8(const char* str, u8* u);
 
KAPI const char* u8_to_string(u8 u);
 
KAPI b8 string_to_u16(const char* str, u16* u);
 
KAPI const char* u16_to_string(u16 u);
 
KAPI b8 string_to_u32(const char* str, u32* u);
 
KAPI const char* u32_to_string(u32 u);
 
KAPI b8 string_to_u64(const char* str, u64* u);
 
KAPI const char* u64_to_string(u64 u);
 
KAPI b8 string_to_bool(const char* str, b8* b);
 
KAPI const char* bool_to_string(b8 b);
 
KAPI u32 string_split(const char* str, char delimiter, char*** str_darray, b8 trim_entries, b8 include_empty, b8 escape_strings);
 
KAPI void string_cleanup_split_darray(char** str_darray);
 
KAPI void string_cleanup_array(const char** str_array, u32 length);
 
KAPI u32 string_nsplit(const char* str, char delimiter, u32 max_count, char** str_array, b8 trim_entries, b8 include_empty);
 
KAPI void string_cleanup_split_array(char** str_array, u32 max_count);
 
KAPI void string_append_string(char* dest, const char* source, const char* append);
 
KAPI void string_append_int(char* dest, const char* source, i64 i);
 
KAPI void string_append_float(char* dest, const char* source, f32 f);
 
KAPI void string_append_bool(char* dest, const char* source, b8 b);
 
KAPI void string_append_char(char* dest, const char* source, char c);
 
KAPI char* string_join(const char** strings, u32 count, char delimiter);
 
KAPI char* kstring_id_join(const kstring_id* strings, u32 count, char delimiter);
 
KAPI char* kname_join(const kname* strings, u32 count, char delimiter);
 
KAPI const char* string_directory_from_path(const char* path);
 
KAPI const char* string_filename_from_path(const char* path);
 
KAPI const char* string_filename_no_extension_from_path(const char* path);
 
KAPI const char* string_extension_from_path(const char* path, b8 include_dot);
 
KAPI b8 string_parse_array_length(const char* str, u32* out_length);
 
KAPI b8 string_line_get(const char* source_str, u16 max_line_length, u32 start_from, char** out_buffer, u32* out_line_length, u8* out_addl_advance);
 
KAPI b8 codepoint_is_lower(i32 codepoint);
KAPI b8 codepoint_is_upper(i32 codepoint);
KAPI b8 codepoint_is_alpha(i32 codepoint);
KAPI b8 codepoint_is_numeric(i32 codepoint);
KAPI b8 codepoint_is_space(i32 codepoint);
 
KAPI void string_to_lower(char* str);
KAPI void string_to_upper(char* str);
 
// ----------------------
// KString implementation
// ----------------------
 
typedef struct kstring {
    u32 length;
    u32 allocated;
    char* data;
} kstring;
 
KAPI void kstring_create(kstring* out_string);
KAPI void kstring_from_cstring(const char* source, kstring* out_string);
KAPI void kstring_destroy(kstring* string);
 
KAPI u32 kstring_length(const kstring* string);
KAPI u32 kstring_utf8_length(const kstring* string);
 
KAPI void kstring_append_str(kstring* string, const char* s);
KAPI void kstring_append_kstring(kstring* string, const kstring* other);