sapi_string.h

Go to the documentation of this file.

#ifndef SAFEAPI_COMMON_STRING_H
#define SAFEAPI_COMMON_STRING_H
 
#include "safeapi/utils/buffer/sapi_buffer.h"
#include "safeapi/utils/status/sapi_status.h"
#include "safeapi/utils/types/sapi_types.h"
 
#ifdef __cplusplus
extern "C" {
#endif

typedef struct sapi_string_s
{
    sapi_buffer_t buf; 
} sapi_string_t;

sapi_status_t sapi_string_init(sapi_string_t *str, char *storage, size_t capacity);

sapi_status_t sapi_string_clear(sapi_string_t *str);

size_t sapi_string_length(const sapi_string_t *str);

sapi_status_t sapi_string_c_str(sapi_string_t *str, const char **out_cstr);

sapi_status_t sapi_string_copy(sapi_string_t *dest, const char *src);

sapi_status_t sapi_string_copy_n(sapi_string_t *dest, const char *src, size_t src_len);

sapi_status_t sapi_string_concat(sapi_string_t *dest, const char *src);

sapi_status_t sapi_string_compare(const sapi_string_t *a, const sapi_string_t *b, int32_t *out_cmp);

sapi_status_t sapi_string_find_char(const sapi_string_t *str, char c,
                                     bool *out_found, size_t *out_index);

sapi_status_t sapi_string_find_substr(const sapi_string_t *haystack, const sapi_string_t *needle,
                                       bool *out_found, size_t *out_index);

sapi_status_t sapi_string_split_next(const sapi_string_t *str, char delimiter,
                                      size_t *io_cursor,
                                      sapi_const_buffer_t *out_token,
                                      bool *out_has_token);

sapi_status_t sapi_string_from_u32(sapi_string_t *dest, uint32_t value);
sapi_status_t sapi_string_from_i32(sapi_string_t *dest, int32_t value);
sapi_status_t sapi_string_from_u64(sapi_string_t *dest, uint64_t value);
sapi_status_t sapi_string_from_i64(sapi_string_t *dest, int64_t value);

sapi_status_t sapi_string_append_u32(sapi_string_t *dest, uint32_t value);
sapi_status_t sapi_string_append_i32(sapi_string_t *dest, int32_t value);
sapi_status_t sapi_string_append_u64(sapi_string_t *dest, uint64_t value);
sapi_status_t sapi_string_append_i64(sapi_string_t *dest, int64_t value);
sapi_status_t sapi_string_append_hex_u32(sapi_string_t *dest, uint32_t value, uint8_t min_digits);

sapi_status_t sapi_string_to_u32(const sapi_string_t *str, uint32_t *out_value);
sapi_status_t sapi_string_to_i32(const sapi_string_t *str, int32_t *out_value);
sapi_status_t sapi_string_to_u64(const sapi_string_t *str, uint64_t *out_value);
sapi_status_t sapi_string_to_i64(const sapi_string_t *str, int64_t *out_value);
 
#ifdef __cplusplus
}
#endif
 
#endif /* SAFEAPI_COMMON_STRING_H */
 /* STRING */