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
recommended 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_concat(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_altered
must be called.
AUTHOR
Joe Orton <neon@webdav.org>.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Availability | SUNWneon |
+--------------------+-----------------+
|Interface Stability | Volatile |
+--------------------+-----------------+
NOTES
Source for Neon is available on http://opensolaris.org.
neon 0.25.5 20 January 2006 NE_BUFFER(3)
Check Out this Related Man Page
NE_BUFFER_APPEND(3) neon API reference NE_BUFFER_APPEND(3)NAME
ne_buffer_append, ne_buffer_zappend, ne_buffer_concat - append data to a string buffer
SYNOPSIS
#include <ne_string.h>
void ne_buffer_append (ne_buffer *buf, const char *string, size_t len);
void ne_buffer_zappend (ne_buffer *buf, const char *string);
void ne_buffer_concat (ne_buffer *buf, const char *str, ...);
DESCRIPTION
The ne_buffer_append and ne_buffer_zappend functions append a string to the end of a buffer; extending the buffer as necessary. The len
passed to ne_buffer_append specifies the length of the string to append; there must be no NUL terminator in the first len bytes of the
string. ne_buffer_zappend must be passed a NUL-terminated string.
The ne_buffer_concat function takes a variable-length argument list following str; each argument must be a char * pointer to a NUL-termi-
nated string. A NULL pointer must be given as the last argument to mark the end of the list. The strings (including str) are appended to
the buffer in the order given. None of the strings passed to ne_buffer_concat are modified.
EXAMPLES
The following code will output "Hello, world. And goodbye.".
ne_buffer *buf = ne_buffer_create();
ne_buffer_zappend(buf, "Hello");
ne_buffer_concat(buf, ", world. ", "And ", "goodbye.", NULL);
puts(buf->data);
ne_buffer_destroy(buf);
SEE ALSO ne_buffer(3), ne_buffer_create(3), ne_buffer_destroy(3)AUTHOR
Joe Orton <neon@webdav.org>.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Availability | SUNWneon |
+--------------------+-----------------+
|Interface Stability | Volatile |
+--------------------+-----------------+
NOTES
Source for Neon is available on http://opensolaris.org.
neon 0.25.5 20 January 2006 NE_BUFFER_APPEND(3)