str.h File Reference

basic string library More...

#include "a.h"
#include <stdarg.h>
#include <string.h>

Include dependency graph for str.h:

Go to the source code of this file.

Data Structures
struct	a_str
	instance structure for basic string More...

Macros
#define	A_STR_INIT   {A_NULL, 0, 0}

Typedefs
typedef struct a_str	a_str
	instance structure for basic string

Functions
char *	a_str_ptr (a_str const *ctx)
	string for a pointer to string structure
a_size	a_str_len (a_str const *ctx)
	length for a pointer to string structure
a_size	a_str_mem (a_str const *ctx)
	memory for a pointer to string structure
char *	a_str_at_ (a_str const *ctx, a_size idx)
	access specified character for a pointer to string structure
char *	a_str_at (a_str const *ctx, a_size idx)
	access specified character for a pointer to string structure
char *	a_str_of (a_str const *ctx, a_diff idx)
	access specified character for a pointer to string structure
void	a_str_setn_ (a_str *ctx, a_size num)
	set length for a pointer to string structure
int	a_str_setn (a_str *ctx, a_size num)
	set length for a pointer to string structure
a_str *	a_str_new (void)
	allocate a pointer to string structure from memory
void	a_str_die (a_str *ctx)
	deallocate a pointer to string structure
void	a_str_ctor (a_str *ctx)
	constructor for string structure
void	a_str_dtor (a_str *ctx)
	destructor for string structure
void	a_str_swap (a_str *lhs, a_str *rhs)
	swap the contents of two pointers to string structure
char *	a_str_exit (a_str *ctx)
	terminate a pointer to string structure
int	a_str_setm (a_str *ctx, a_size mem)
	allocate memory for a pointer to string structure
int	a_str_setm_ (a_str *ctx, a_size mem)
int	a_str_cmp_ (void const *p0, a_size n0, void const *p1, a_size n1)
	compare the memory block 0 with the memory block 1
int	a_str_cmp (a_str const *lhs, a_str const *rhs)
	compare the string lhs with the string rhs
int	a_str_cmpn (a_str const *ctx, void const *pdata, a_size nbyte)
	compare the string ctx with the memory block
int	a_str_cmps (a_str const *ctx, void const *str)
	compare the string ctx with the C string str
int	a_str_getc (a_str *ctx)
	get a character for a pointer to string structure
int	a_str_getc_ (a_str *ctx)
int	a_str_catc (a_str *ctx, int c)
	concatenate a character to a pointer to string structure
int	a_str_catc_ (a_str *ctx, int c)
a_size	a_str_getn (a_str *ctx, void *pdata, a_size nbyte)
	get memory block to a pointer to string structure
a_size	a_str_getn_ (a_str *ctx, void *pdata, a_size nbyte)
int	a_str_catn (a_str *ctx, void const *pdata, a_size nbyte)
	concatenate memory block to a pointer to string structure
int	a_str_catn_ (a_str *ctx, void const *pdata, a_size nbyte)
int	a_str_cats (a_str *ctx, void const *str)
	concatenate C string to a pointer to string structure
int	a_str_cats_ (a_str *ctx, void const *str)
int	a_str_catv (a_str *ctx, char const *fmt, va_list va)
	format string append to a pointer to string structure via va_list
int	a_str_catf (a_str *ctx, char const *fmt,...)
	format string append to a pointer to string structure
int	a_str_cat (a_str *ctx, a_str const *obj)
	concatenate the string structure obj to the string structure ctx
int	a_str_cat_ (a_str *ctx, a_str const *obj)
void	a_str_rtrim (a_str *ctx, char const *s, a_size n)
	trim a string by removing trailing characters. If n is non-zero, the function uses the array s to specify the characters to remove. If n is zero, the function removes all trailing whitespace characters.
void	a_str_rtrim_ (a_str *ctx, char const *s, a_size n)
void	a_str_ltrim (a_str *ctx, char const *s, a_size n)
	trim a string by removing leading characters. If n is non-zero, the function uses the array s to specify the characters to remove. If n is zero, the function removes all leading whitespace characters.
void	a_str_ltrim_ (a_str *ctx, char const *s, a_size n)
void	a_str_trim (a_str *ctx, char const *s, a_size n)
	trim a string by removing both leading and trailing characters. If n is non-zero, the function uses the array s to specify the characters to remove. If n is zero, the function removes all leading and trailing whitespace characters.
void	a_str_trim_ (a_str *ctx, char const *s, a_size n)
a_size	a_utf_len (a_str const *ctx, a_size *stop)
	length for a pointer to string structure using UTF-8
int	a_utf_catc (a_str *ctx, a_u32 c)
	concatenate a unicode character to a pointer to string structure

Detailed Description

basic string library