ne_buffer(3) [opensolaris man page]

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)

NE_BUFFER_CLEAR(3)						neon API reference						NE_BUFFER_CLEAR(3)

NAME

       ne_buffer_clear, ne_buffer_grow, ne_buffer_altered - general purpose of group of functions

SYNOPSIS

       #include <ne_string.h>

       void ne_buffer_clear (ne_buffer *buf);

       void ne_buffer_altered (ne_buffer *buf);

       void ne_buffer_grow (ne_buffer *buf, size_t size);

DESCRIPTION

       The ne_buffer_clear function sets the string stored in buf to be the empty string ("").

       The  ne_buffer_altered  function  must  be used after the string stored in the buffer buf is modified by directly rather than using ne_buf-
       fer_append(3), ne_buffer_zappend(3) or ne_buffer_concat(3).

       The ne_buffer_grow function ensures that at least size bytes are allocated for the string; this can be used if a large amount  of  data	is
       going to be appended to the buffer and may result in more efficient memory allocation.

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.

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_CLEAR(3)