155 lines
4.3 KiB
C
155 lines
4.3 KiB
C
/* strbuf - String buffer routines
|
|
*
|
|
* Copyright (c) 2010-2012 Mark Pulford <mark@kyne.com.au>
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining
|
|
* a copy of this software and associated documentation files (the
|
|
* "Software"), to deal in the Software without restriction, including
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
* distribute, sublicense, and/or sell copies of the Software, and to
|
|
* permit persons to whom the Software is furnished to do so, subject to
|
|
* the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
|
* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
|
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
|
|
#include "c_stdlib.h"
|
|
#include "c_stdarg.h"
|
|
|
|
/* Size: Total bytes allocated to *buf
|
|
* Length: String length, excluding optional NULL terminator.
|
|
* Increment: Allocation increments when resizing the string buffer.
|
|
* Dynamic: True if created via strbuf_new()
|
|
*/
|
|
|
|
typedef struct {
|
|
char *buf;
|
|
int size;
|
|
int length;
|
|
int increment;
|
|
int dynamic;
|
|
int reallocs;
|
|
int debug;
|
|
} strbuf_t;
|
|
|
|
#ifndef STRBUF_DEFAULT_SIZE
|
|
#define STRBUF_DEFAULT_SIZE 1023
|
|
#endif
|
|
#ifndef STRBUF_DEFAULT_INCREMENT
|
|
#define STRBUF_DEFAULT_INCREMENT -2
|
|
#endif
|
|
|
|
/* Initialise */
|
|
extern strbuf_t *strbuf_new(int len);
|
|
extern void strbuf_init(strbuf_t *s, int len);
|
|
extern void strbuf_set_increment(strbuf_t *s, int increment);
|
|
|
|
/* Release */
|
|
extern void strbuf_free(strbuf_t *s);
|
|
extern char *strbuf_free_to_string(strbuf_t *s, int *len);
|
|
|
|
/* Management */
|
|
extern void strbuf_resize(strbuf_t *s, int len);
|
|
static int strbuf_empty_length(strbuf_t *s);
|
|
static int strbuf_length(strbuf_t *s);
|
|
static char *strbuf_string(strbuf_t *s, int *len);
|
|
static void strbuf_ensure_empty_length(strbuf_t *s, int len);
|
|
static char *strbuf_empty_ptr(strbuf_t *s);
|
|
static void strbuf_extend_length(strbuf_t *s, int len);
|
|
|
|
/* Update */
|
|
extern void strbuf_append_fmt(strbuf_t *s, int len, const char *fmt, ...);
|
|
extern void strbuf_append_fmt_retry(strbuf_t *s, const char *format, ...);
|
|
static void strbuf_append_mem(strbuf_t *s, const char *c, int len);
|
|
extern void strbuf_append_string(strbuf_t *s, const char *str);
|
|
static void strbuf_append_char(strbuf_t *s, const char c);
|
|
static void strbuf_ensure_null(strbuf_t *s);
|
|
|
|
/* Reset string for before use */
|
|
static inline void strbuf_reset(strbuf_t *s)
|
|
{
|
|
s->length = 0;
|
|
}
|
|
|
|
static inline int strbuf_allocated(strbuf_t *s)
|
|
{
|
|
return s->buf != NULL;
|
|
}
|
|
|
|
/* Return bytes remaining in the string buffer
|
|
* Ensure there is space for a NULL terminator. */
|
|
static inline int strbuf_empty_length(strbuf_t *s)
|
|
{
|
|
return s->size - s->length - 1;
|
|
}
|
|
|
|
static inline void strbuf_ensure_empty_length(strbuf_t *s, int len)
|
|
{
|
|
if (len > strbuf_empty_length(s))
|
|
strbuf_resize(s, s->length + len);
|
|
}
|
|
|
|
static inline char *strbuf_empty_ptr(strbuf_t *s)
|
|
{
|
|
return s->buf + s->length;
|
|
}
|
|
|
|
static inline void strbuf_extend_length(strbuf_t *s, int len)
|
|
{
|
|
s->length += len;
|
|
}
|
|
|
|
static inline int strbuf_length(strbuf_t *s)
|
|
{
|
|
return s->length;
|
|
}
|
|
|
|
static inline void strbuf_append_char(strbuf_t *s, const char c)
|
|
{
|
|
strbuf_ensure_empty_length(s, 1);
|
|
s->buf[s->length++] = c;
|
|
}
|
|
|
|
static inline void strbuf_append_char_unsafe(strbuf_t *s, const char c)
|
|
{
|
|
s->buf[s->length++] = c;
|
|
}
|
|
|
|
static inline void strbuf_append_mem(strbuf_t *s, const char *c, int len)
|
|
{
|
|
strbuf_ensure_empty_length(s, len);
|
|
memcpy(s->buf + s->length, c, len);
|
|
s->length += len;
|
|
}
|
|
|
|
static inline void strbuf_append_mem_unsafe(strbuf_t *s, const char *c, int len)
|
|
{
|
|
memcpy(s->buf + s->length, c, len);
|
|
s->length += len;
|
|
}
|
|
|
|
static inline void strbuf_ensure_null(strbuf_t *s)
|
|
{
|
|
s->buf[s->length] = 0;
|
|
}
|
|
|
|
static inline char *strbuf_string(strbuf_t *s, int *len)
|
|
{
|
|
if (len)
|
|
*len = s->length;
|
|
|
|
return s->buf;
|
|
}
|
|
|
|
/* vi:ai et sw=4 ts=4:
|
|
*/
|