|
|
@ -23,7 +23,7 @@ typedef struct stralloc {
|
|
|
|
/* stralloc_init will initialize a stralloc.
|
|
|
|
/* stralloc_init will initialize a stralloc.
|
|
|
|
* Previously allocated memory will not be freed; use stralloc_free for
|
|
|
|
* Previously allocated memory will not be freed; use stralloc_free for
|
|
|
|
* that. To assign an empty string, use stralloc_copys(sa,""). */
|
|
|
|
* that. To assign an empty string, use stralloc_copys(sa,""). */
|
|
|
|
extern void stralloc_init(stralloc* sa);
|
|
|
|
void stralloc_init(stralloc* sa);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_ready makes sure that sa has enough space allocated to hold
|
|
|
|
/* stralloc_ready makes sure that sa has enough space allocated to hold
|
|
|
|
* len bytes: If sa is not allocated, stralloc_ready allocates at least
|
|
|
|
* len bytes: If sa is not allocated, stralloc_ready allocates at least
|
|
|
@ -32,58 +32,58 @@ extern void stralloc_init(stralloc* sa);
|
|
|
|
* bytes of space, copies the old string into the new space, frees the
|
|
|
|
* bytes of space, copies the old string into the new space, frees the
|
|
|
|
* old space, and returns 1. Note that this changes sa.s. If the
|
|
|
|
* old space, and returns 1. Note that this changes sa.s. If the
|
|
|
|
* allocation fails, stralloc_ready leaves sa alone and returns 0. */
|
|
|
|
* allocation fails, stralloc_ready leaves sa alone and returns 0. */
|
|
|
|
extern int stralloc_ready(stralloc* sa,unsigned int len);
|
|
|
|
int stralloc_ready(stralloc* sa,unsigned int len);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_readyplus is like stralloc_ready except that, if sa is
|
|
|
|
/* stralloc_readyplus is like stralloc_ready except that, if sa is
|
|
|
|
* already allocated, stralloc_readyplus adds the current length of sa
|
|
|
|
* already allocated, stralloc_readyplus adds the current length of sa
|
|
|
|
* to len. */
|
|
|
|
* to len. */
|
|
|
|
extern int stralloc_readyplus(stralloc* sa,unsigned int len);
|
|
|
|
int stralloc_readyplus(stralloc* sa,unsigned int len);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_copyb copies the string buf[0], buf[1], ..., buf[len-1] into
|
|
|
|
/* stralloc_copyb copies the string buf[0], buf[1], ..., buf[len-1] into
|
|
|
|
* sa, allocating space if necessary, and returns 1. If it runs out of
|
|
|
|
* sa, allocating space if necessary, and returns 1. If it runs out of
|
|
|
|
* memory, stralloc_copyb leaves sa alone and returns 0. */
|
|
|
|
* memory, stralloc_copyb leaves sa alone and returns 0. */
|
|
|
|
extern int stralloc_copyb(stralloc* sa,const char* buf,unsigned int len);
|
|
|
|
int stralloc_copyb(stralloc* sa,const char* buf,unsigned int len);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_copys copies a \0-terminated string from buf into sa,
|
|
|
|
/* stralloc_copys copies a \0-terminated string from buf into sa,
|
|
|
|
* without the \0. It is the same as
|
|
|
|
* without the \0. It is the same as
|
|
|
|
* stralloc_copyb(&sa,buf,str_len(buf)). */
|
|
|
|
* stralloc_copyb(&sa,buf,str_len(buf)). */
|
|
|
|
extern int stralloc_copys(stralloc* sa,const char* buf);
|
|
|
|
int stralloc_copys(stralloc* sa,const char* buf);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_copy copies the string stored in sa2 into sa. It is the same
|
|
|
|
/* stralloc_copy copies the string stored in sa2 into sa. It is the same
|
|
|
|
* as stralloc_copyb(&sa,sa2.s,sa2.len). sa2 must already be allocated. */
|
|
|
|
* as stralloc_copyb(&sa,sa2.s,sa2.len). sa2 must already be allocated. */
|
|
|
|
extern int stralloc_copy(stralloc* sa,const stralloc* sa2);
|
|
|
|
int stralloc_copy(stralloc* sa,const stralloc* sa2);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_catb adds the string buf[0], buf[1], ... buf[len-1] to the
|
|
|
|
/* stralloc_catb adds the string buf[0], buf[1], ... buf[len-1] to the
|
|
|
|
* end of the string stored in sa, allocating space if necessary, and
|
|
|
|
* end of the string stored in sa, allocating space if necessary, and
|
|
|
|
* returns 1. If sa is unallocated, stralloc_catb is the same as
|
|
|
|
* returns 1. If sa is unallocated, stralloc_catb is the same as
|
|
|
|
* stralloc_copyb. If it runs out of memory, stralloc_catb leaves sa
|
|
|
|
* stralloc_copyb. If it runs out of memory, stralloc_catb leaves sa
|
|
|
|
* alone and returns 0. */
|
|
|
|
* alone and returns 0. */
|
|
|
|
extern int stralloc_catb(stralloc* sa,const char* in,unsigned int len);
|
|
|
|
int stralloc_catb(stralloc* sa,const char* in,unsigned int len);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_cats is analogous to stralloc_copys */
|
|
|
|
/* stralloc_cats is analogous to stralloc_copys */
|
|
|
|
extern int stralloc_cats(stralloc* sa,const char* in);
|
|
|
|
int stralloc_cats(stralloc* sa,const char* in);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_cat is analogous to stralloc_copy */
|
|
|
|
/* stralloc_cat is analogous to stralloc_copy */
|
|
|
|
extern int stralloc_cat(stralloc* sa,stralloc* in);
|
|
|
|
int stralloc_cat(stralloc* sa,stralloc* in);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_append adds one byte in[0] to the end of the string stored
|
|
|
|
/* stralloc_append adds one byte in[0] to the end of the string stored
|
|
|
|
* in sa. It is the same as stralloc_catb(&sa,in,1). */
|
|
|
|
* in sa. It is the same as stralloc_catb(&sa,in,1). */
|
|
|
|
extern int stralloc_append(stralloc* sa,const char* in); /* beware: this takes a pointer to 1 char */
|
|
|
|
int stralloc_append(stralloc* sa,const char* in); /* beware: this takes a pointer to 1 char */
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_starts returns 1 if the \0-terminated string in "in", without
|
|
|
|
/* stralloc_starts returns 1 if the \0-terminated string in "in", without
|
|
|
|
* the terminating \0, is a prefix of the string stored in sa. Otherwise
|
|
|
|
* the terminating \0, is a prefix of the string stored in sa. Otherwise
|
|
|
|
* it returns 0. sa must already be allocated. */
|
|
|
|
* it returns 0. sa must already be allocated. */
|
|
|
|
extern int stralloc_starts(stralloc* sa,const char* in) __pure__;
|
|
|
|
int stralloc_starts(stralloc* sa,const char* in) __pure__;
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_diff returns negative, 0, or positive, depending on whether
|
|
|
|
/* stralloc_diff returns negative, 0, or positive, depending on whether
|
|
|
|
* a is lexicographically smaller than, equal to, or greater than the
|
|
|
|
* a is lexicographically smaller than, equal to, or greater than the
|
|
|
|
* string b. */
|
|
|
|
* string b. */
|
|
|
|
extern int stralloc_diff(const stralloc* a,const stralloc* b) __pure__;
|
|
|
|
int stralloc_diff(const stralloc* a,const stralloc* b) __pure__;
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_diffs returns negative, 0, or positive, depending on whether
|
|
|
|
/* stralloc_diffs returns negative, 0, or positive, depending on whether
|
|
|
|
* a is lexicographically smaller than, equal to, or greater than the
|
|
|
|
* a is lexicographically smaller than, equal to, or greater than the
|
|
|
|
* string b[0], b[1], ..., b[n]=='\0'. */
|
|
|
|
* string b[0], b[1], ..., b[n]=='\0'. */
|
|
|
|
extern int stralloc_diffs(const stralloc* a,const char* b) __pure__;
|
|
|
|
int stralloc_diffs(const stralloc* a,const char* b) __pure__;
|
|
|
|
|
|
|
|
|
|
|
|
#define stralloc_equal(a,b) (!stralloc_diff((a),(b)))
|
|
|
|
#define stralloc_equal(a,b) (!stralloc_diff((a),(b)))
|
|
|
|
#define stralloc_equals(a,b) (!stralloc_diffs((a),(b)))
|
|
|
|
#define stralloc_equals(a,b) (!stralloc_diffs((a),(b)))
|
|
|
@ -92,13 +92,13 @@ extern int stralloc_diffs(const stralloc* a,const char* b) __pure__;
|
|
|
|
#define stralloc_0(sa) stralloc_append(sa,"")
|
|
|
|
#define stralloc_0(sa) stralloc_append(sa,"")
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_catulong0 appends a '0' padded ASCII representation of in */
|
|
|
|
/* stralloc_catulong0 appends a '0' padded ASCII representation of in */
|
|
|
|
extern int stralloc_catulong0(stralloc* sa,unsigned long in,unsigned int n);
|
|
|
|
int stralloc_catulong0(stralloc* sa,unsigned long in,unsigned int n);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_catlong0 appends a '0' padded ASCII representation of in */
|
|
|
|
/* stralloc_catlong0 appends a '0' padded ASCII representation of in */
|
|
|
|
extern int stralloc_catlong0(stralloc* sa,signed long in,unsigned int n);
|
|
|
|
int stralloc_catlong0(stralloc* sa,signed long in,unsigned int n);
|
|
|
|
|
|
|
|
|
|
|
|
/* stralloc_free frees the storage associated with sa */
|
|
|
|
/* stralloc_free frees the storage associated with sa */
|
|
|
|
extern void stralloc_free(stralloc* sa);
|
|
|
|
void stralloc_free(stralloc* sa);
|
|
|
|
|
|
|
|
|
|
|
|
#define stralloc_catlong(sa,l) (stralloc_catlong0((sa),(l),0))
|
|
|
|
#define stralloc_catlong(sa,l) (stralloc_catlong0((sa),(l),0))
|
|
|
|
#define stralloc_catuint0(sa,i,n) (stralloc_catulong0((sa),(i),(n)))
|
|
|
|
#define stralloc_catuint0(sa,i,n) (stralloc_catulong0((sa),(i),(n)))
|
|
|
@ -106,14 +106,14 @@ extern void stralloc_free(stralloc* sa);
|
|
|
|
#define stralloc_catint(sa,i) (stralloc_catlong0((sa),(i),0))
|
|
|
|
#define stralloc_catint(sa,i) (stralloc_catlong0((sa),(i),0))
|
|
|
|
|
|
|
|
|
|
|
|
/* remove last char. Return removed byte as unsigned char (or -1 if stralloc was empty). */
|
|
|
|
/* remove last char. Return removed byte as unsigned char (or -1 if stralloc was empty). */
|
|
|
|
extern int stralloc_chop(stralloc* sa);
|
|
|
|
int stralloc_chop(stralloc* sa);
|
|
|
|
|
|
|
|
|
|
|
|
/* remove trailing "\r\n", "\n" or "\r". Return number of removed chars (0,1 or 2) */
|
|
|
|
/* remove trailing "\r\n", "\n" or "\r". Return number of removed chars (0,1 or 2) */
|
|
|
|
extern int stralloc_chomp(stralloc* sa);
|
|
|
|
int stralloc_chomp(stralloc* sa);
|
|
|
|
|
|
|
|
|
|
|
|
#ifdef BUFFER_H
|
|
|
|
#ifdef BUFFER_H
|
|
|
|
/* write stralloc to buffer */
|
|
|
|
/* write stralloc to buffer */
|
|
|
|
extern int buffer_putsa(buffer* b,stralloc* sa);
|
|
|
|
int buffer_putsa(buffer* b,stralloc* sa);
|
|
|
|
/* these "read token" functions return 0 if the token was complete or
|
|
|
|
/* these "read token" functions return 0 if the token was complete or
|
|
|
|
* EOF was hit or -1 on error. In contrast to the non-stralloc token
|
|
|
|
* EOF was hit or -1 on error. In contrast to the non-stralloc token
|
|
|
|
* functions, the separator is also put in the stralloc; use
|
|
|
|
* functions, the separator is also put in the stralloc; use
|
|
|
@ -126,14 +126,14 @@ extern int buffer_putsa(buffer* b,stralloc* sa);
|
|
|
|
* data is available. */
|
|
|
|
* data is available. */
|
|
|
|
|
|
|
|
|
|
|
|
/* read token from buffer to stralloc */
|
|
|
|
/* read token from buffer to stralloc */
|
|
|
|
extern int buffer_get_token_sa(buffer* b,stralloc* sa,const char* charset,unsigned int setlen);
|
|
|
|
int buffer_get_token_sa(buffer* b,stralloc* sa,const char* charset,unsigned int setlen);
|
|
|
|
/* read line from buffer to stralloc */
|
|
|
|
/* read line from buffer to stralloc */
|
|
|
|
extern int buffer_getline_sa(buffer* b,stralloc* sa);
|
|
|
|
int buffer_getline_sa(buffer* b,stralloc* sa);
|
|
|
|
|
|
|
|
|
|
|
|
typedef int (*sa_predicate)(stralloc* sa);
|
|
|
|
typedef int (*sa_predicate)(stralloc* sa);
|
|
|
|
|
|
|
|
|
|
|
|
/* like buffer_get_token_sa but the token ends when your predicate says so */
|
|
|
|
/* like buffer_get_token_sa but the token ends when your predicate says so */
|
|
|
|
extern int buffer_get_token_sa_pred(buffer* b,stralloc* sa,sa_predicate p);
|
|
|
|
int buffer_get_token_sa_pred(buffer* b,stralloc* sa,sa_predicate p);
|
|
|
|
#endif
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
#endif
|
|
|
|
#endif
|
|
|
|