NE_BUFFER(3) neon API reference NE_BUFFER(3)NAME
ne_buffer - string buffer handling
SYNOPSIS
#include <ne_string.h>
typedef struct {
char *data;
size_t used;
size_t length; } ne_buffer;
DESCRIPTION
The ne_buffer type represents an expandable memory buffer for holding
NUL-terminated strings. The data field points to the beginnning of the
string, the length of which is given by the used field. The current
size of memory allocated is given by the length field. It is not recom‐
mended that the fields of a buffer are manipulated directly. The data
pointer may change when the buffer is modified.
A buffer is created using ne_buffer_create(3) or ne_buffer_ncreate(3),
and destroyed using ne_buffer_destroy(3) or ne_buffer_finish(3). The
functions ne_buffer_append(3), ne_buffer_zappend(3) and ne_buffer_con‐
cat(3) are used to append data to a buffer.
If the string referenced by the data pointer is modified directly
(rather than using one of the functions listed above), ne_buffer_al‐
tered must be called.
AUTHOR
Joe Orton <neon@webdav.org>.
neon 0.25.5 20 January 2006 NE_BUFFER(3)