Logo Search packages:      
Sourcecode: bglibs version File versions

str: Dynamically allocated string library.


Detailed Description

Calling Convention
The standard calling convention to str functions is to pass the string being examined or modified as the first argument. For most functions, the return value will be 0 (false) if an error occurred (ie memory allocation failed) and non-zero (true) otherwise.


Classes

struct  str
struct  str_sortentry

Globals

const char str_lcase_digits [36]
const char str_ucase_digits [36]

Overhead Functions

int str_alloc (str *s, unsigned size, int copy)
void str_free (str *s)
int str_init (str *s)
int str_truncate (str *s, unsigned len)
#define str_ready(S, SZ)   str_alloc(S,SZ,0)
#define str_realloc(S, SZ)   str_alloc(S,SZ,1)

Searching Functions

void str_buildmap (int map[256], const char *list)
unsigned str_count (const str *s, char ch)
unsigned str_countof (const str *s, const char *list)
int str_findnext (const str *s, char ch, unsigned pos)
int str_findnextnot (const str *s, const char *list, unsigned pos)
int str_findnextof (const str *s, const char *list, unsigned pos)
int str_findprev (const str *s, char ch, unsigned pos)
int str_findprevnot (const str *s, const char *list, unsigned pos)
int str_findprevof (const str *s, const char *list, unsigned pos)
#define str_findfirst(S, C)   str_findnext(S,C,0)
#define str_findfirstnot(S, L)   str_findnextnot(S,L,0)
#define str_findfirstof(S, L)   str_findnextof(S,L,0)
#define str_findlast(S, C)   str_findprev(S,C,-1)
#define str_findlastnot(S, L)   str_findprevof(S,L,-1)
#define str_findlastof(S, L)   str_findprevof(S,L,-1)

Pattern Matching Functions

int str_case_glob (const str *s, const str *pattern)
int str_case_globb (const str *s, const char *pptr, unsigned plen)
int str_case_globs (const str *s, const char *pattern)
int str_case_match (const str *s, const str *pattern)
int str_case_matchb (const str *s, const char *pptr, unsigned plen)
int str_case_matchs (const str *s, const char *pattern)
int str_glob (const str *s, const str *pattern)
int str_globb (const str *s, const char *pptr, unsigned plen)
int str_globs (const str *s, const char *pattern)
int str_match (const str *s, const str *pattern)
int str_matchb (const str *s, const char *pptr, unsigned plen)
int str_matchs (const str *s, const char *pattern)

Comparison Functions

int str_case_start (const str *a, const str *b)
int str_case_startb (const str *a, const char *b, unsigned len)
int str_case_starts (const str *a, const char *b)
int str_cmp (const str *a, unsigned aoffset, const str *b, unsigned boffset)
int str_cmpb (const str *a, unsigned offset, const char *b, unsigned len)
int str_cmps (const str *a, unsigned offset, const char *b)
int str_diff (const str *a, const str *b)
int str_diffb (const str *a, const char *b, unsigned len)
int str_diffs (const str *a, const char *b)
int str_start (const str *a, const str *b)
int str_startb (const str *a, const char *b, unsigned len)
int str_starts (const str *a, const char *b)

Appending Functions

int str_cat (str *s, const str *in)
int str_cat2s (str *s, const char *a, const char *b)
int str_cat3s (str *s, const char *a, const char *b, const char *c)
int str_cat4s (str *s, const char *a, const char *b, const char *c, const char *d)
int str_cat5s (str *s, const char *a, const char *b, const char *c, const char *d, const char *e)
int str_cat6s (str *s, const char *a, const char *b, const char *c, const char *d, const char *e, const char *f)
int str_catb (str *s, const char *in, unsigned len)
int str_catc (str *s, char in)
int str_cati (str *s, long in)
int str_catill (str *s, long long in)
int str_catiw (str *s, long in, unsigned width, char pad)
int str_catiwll (str *s, long long in, unsigned width, char pad)
int str_catns (str *s, unsigned int count,...)
int str_cats (str *s, const char *in)
int str_catsllnumw (str *s, long long in, unsigned width, char pad, unsigned base, const char *digits)
int str_catsnumw (str *s, long in, unsigned width, char pad, unsigned base, const char *digits)
int str_catu (str *s, unsigned long in)
int str_catull (str *s, unsigned long long in)
int str_catullnumw (str *s, unsigned long long in, unsigned width, char pad, unsigned base, const char *digits)
int str_catunumw (str *s, unsigned long in, unsigned width, char pad, unsigned base, const char *digits)
int str_catuw (str *s, unsigned long in, unsigned width, char pad)
int str_catuwll (str *s, unsigned long long in, unsigned width, char pad)
int str_catx (str *s, unsigned long in)
int str_catxll (str *s, unsigned long long in)
int str_catxw (str *s, unsigned long in, unsigned width, char pad)
int str_catxwll (str *s, unsigned long long in, unsigned width, char pad)
int str_join (str *s, char sep, const str *t)
int str_joinb (str *s, char sep, const char *in, unsigned len)
int str_joins (str *s, char sep, const char *in)

Assignment Functions

int str_copy (str *s, const str *in)
int str_copy2s (str *s, const char *a, const char *b)
int str_copy3s (str *s, const char *a, const char *b, const char *c)
int str_copy4s (str *s, const char *a, const char *b, const char *c, const char *d)
int str_copy5s (str *s, const char *a, const char *b, const char *c, const char *d, const char *e)
int str_copy6s (str *s, const char *a, const char *b, const char *c, const char *d, const char *e, const char *f)
int str_copyb (str *s, const char *in, unsigned len)
int str_copyns (str *s, unsigned int count,...)
int str_copys (str *s, const char *in)

In-place Modification Functions



void str_lcut (str *s, unsigned count)
void str_lower (str *s)
void str_lstrip (str *s)
void str_rcut (str *s, unsigned count)
void str_rstrip (str *s)
int str_sort (str *s, char sep, long count, int(*fn)(const str_sortentry *a, const str_sortentry *b))
int str_splice (str *s, unsigned start, unsigned len, const str *r)
int str_spliceb (str *s, unsigned start, unsigned len, const char *r, unsigned rlen)
int str_splices (str *s, unsigned start, unsigned len, const char *r)
long str_subst (str *s, char from, char to)
void str_upper (str *s)
long str_xlate (str *s, const char *from, const char *to, unsigned nchars)
#define str_strip(S)   (str_rstrip(S), str_lstrip(S))

Defines

#define STR_BLOCKSIZE   16

Typedefs

typedef struct str str
typedef struct str_sortentry str_sortentry


Generated by  Doxygen 1.6.0   Back to index