str.h

Go to the documentation of this file.

 
#ifndef LIBA_STR_H
#define LIBA_STR_H
 
#include "a.h"
#include <stdarg.h>
#include <string.h>

 
/* clang-format off */
#define A_STR_INIT {A_NULL, 0, 0}
/* clang-format on */

typedef struct a_str
{
    char *ptr_; 
    a_size num_; 
    a_size mem_; 
} a_str;
typedef struct a_str {…};

A_INTERN char *a_str_ptr(a_str const *ctx) { return ctx->ptr_; }

A_INTERN a_size a_str_len(a_str const *ctx) { return ctx->num_; }

A_INTERN a_size a_str_mem(a_str const *ctx) { return ctx->mem_; }

A_INTERN char *a_str_at_(a_str const *ctx, a_size idx) { return ctx->ptr_ + idx; }

A_INTERN char *a_str_at(a_str const *ctx, a_size idx)
{
    return idx < ctx->mem_ ? ctx->ptr_ + idx : A_NULL;
}
A_INTERN char *a_str_at(a_str const *ctx, a_size idx) {…}

A_INTERN char *a_str_of(a_str const *ctx, a_diff idx)
{
    a_size const num = idx >= 0 ? a_size_c(idx) : a_size_c(idx) + ctx->num_;
    return num < ctx->mem_ ? ctx->ptr_ + num : A_NULL;
}
A_INTERN char *a_str_of(a_str const *ctx, a_diff idx) {…}

A_INTERN void a_str_setn_(a_str *ctx, a_size num) { ctx->num_ = num; }

A_INTERN int a_str_setn(a_str *ctx, a_size num)
{
    int const rc = (num <= ctx->mem_ ? A_SUCCESS : A_OBOUNDS);
    if (rc == 0) { ctx->num_ = num; }
    return rc;
}
A_INTERN int a_str_setn(a_str *ctx, a_size num) {…}
 
#if defined(__cplusplus)
extern "C" {
#endif /* __cplusplus */

A_EXTERN a_str *a_str_new(void);

A_EXTERN void a_str_die(a_str *ctx);

A_EXTERN void a_str_ctor(a_str *ctx);

A_EXTERN void a_str_dtor(a_str *ctx);

A_EXTERN void a_str_swap(a_str *lhs, a_str *rhs);

A_EXTERN char *a_str_exit(a_str *ctx);

A_EXTERN int a_str_setm(a_str *ctx, a_size mem);
A_EXTERN int a_str_setm_(a_str *ctx, a_size mem);

A_EXTERN int a_str_cmp_(void const *p0, a_size n0, void const *p1, a_size n1);

A_EXTERN int a_str_cmp(a_str const *lhs, a_str const *rhs);

A_EXTERN int a_str_cmpn(a_str const *ctx, void const *pdata, a_size nbyte);

A_EXTERN int a_str_cmps(a_str const *ctx, void const *str);

A_EXTERN int a_str_getc(a_str *ctx);
A_EXTERN int a_str_getc_(a_str *ctx);

A_EXTERN int a_str_catc(a_str *ctx, int c);
A_EXTERN int a_str_catc_(a_str *ctx, int c);

A_EXTERN a_size a_str_getn(a_str *ctx, void *pdata, a_size nbyte);
A_EXTERN a_size a_str_getn_(a_str *ctx, void *pdata, a_size nbyte);

A_EXTERN int a_str_catn(a_str *ctx, void const *pdata, a_size nbyte);
A_EXTERN int a_str_catn_(a_str *ctx, void const *pdata, a_size nbyte);

A_EXTERN int a_str_cats(a_str *ctx, void const *str);
A_EXTERN int a_str_cats_(a_str *ctx, void const *str);

A_EXTERN A_FORMAT(__printf__, 2, 0) int a_str_catv(a_str *ctx, char const *fmt, va_list va);

A_EXTERN A_FORMAT(__printf__, 2, 3) int a_str_catf(a_str *ctx, char const *fmt, ...);

A_EXTERN int a_str_cat(a_str *ctx, a_str const *obj);
A_EXTERN int a_str_cat_(a_str *ctx, a_str const *obj);

A_EXTERN void a_str_rtrim(a_str *ctx, char const *s, a_size n);
A_EXTERN void a_str_rtrim_(a_str *ctx, char const *s, a_size n);

A_EXTERN void a_str_ltrim(a_str *ctx, char const *s, a_size n);
A_EXTERN void a_str_ltrim_(a_str *ctx, char const *s, a_size n);

A_EXTERN void a_str_trim(a_str *ctx, char const *s, a_size n);
A_EXTERN void a_str_trim_(a_str *ctx, char const *s, a_size n);

A_EXTERN a_size a_utf_len(a_str const *ctx, a_size *stop);

A_EXTERN int a_utf_catc(a_str *ctx, a_u32 c);
 
#if defined(__cplusplus)
} /* extern "C" */
#endif /* __cplusplus */

 
#endif /* a/str.h */