string.h

#pragma once
 
#include <stdbool.h>
#include <stddef.h>
 
#include "memory/allocator.h"
#include "nostd.h"
#include "object/optional.h"
#include "object/result.h"
 
typedef enum {
  CU_STRING_ERROR_NONE = 0, 
  CU_STRING_ERROR_OOM,      
} cu_String_Error;
 
typedef struct cu_String {
  cu_Allocator allocator; 
  char *data;             
  size_t length;          
  size_t capacity;        
} cu_String;
 
CU_RESULT_DECL(cu_IoString, cu_String, cu_Io_Error)
CU_RESULT_DECL(cu_String, cu_String, cu_String_Error)
CU_OPTIONAL_DECL(cu_String, cu_String)
 
 
cu_String cu_String_init(cu_Allocator allocator);
 
void cu_String_destroy(cu_String *str);
 
void cu_String_clear(cu_String *str);
 
cu_String_Result cu_String_from_cstr(cu_Allocator allocator, const char *cstr);
 
cu_String_Result cu_String_from_slice(cu_Allocator allocator, cu_Slice slice);
 
cu_String_Result cu_String_copy(cu_Allocator allocator, const cu_String *src);
 
cu_String_Error cu_String_reserve(cu_String *str, size_t capacity);
 
cu_String_Error cu_String_append_slice(cu_String *str, cu_Slice slice);
 
cu_String_Error cu_String_append_cstr(cu_String *str, const char *cstr);
 
cu_String_Error cu_String_append(cu_String *str, const cu_String *other);
 
cu_Slice cu_String_as_slice(const cu_String *str);
 
cu_String_Result cu_String_substring(
    const cu_String *str, size_t off, size_t len);
 
cu_Slice cu_String_subslice(const cu_String *str, size_t off, size_t len);