ne_buffer_grow(3) [opensolaris man page]

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)

NE_MALLOC(3)							neon API reference						      NE_MALLOC(3)

NAME

       ne_malloc, ne_calloc, ne_realloc, ne_strdup, ne_strndup, ne_oom_callback - memory allocation wrappers

SYNOPSIS

       #include <ne_alloc.h>

       void *ne_malloc (size_t size);

       void *ne_calloc (size_t size);

       void *ne_realloc (void *size, size_t len);

       char *ne_strdup (const char *s, size_t size);

       char *ne_strndup (const char *s, size_t size);

       void ne_oom_callback (void (*callback)(void));

DESCRIPTION

       The  functions  ne_malloc,  ne_calloc, ne_realloc, ne_strdup and ne_strdnup provide wrappers for the equivalent functions in the standard C
       library. The wrappers provide the extra guarantee that if the C library equivalent returns NULL when no memory is  available,  an  optional
       callback will be called, and the library will then call abort().

       ne_oom_callback registers a callback which will be invoked if an out of memory error is detected.

NOTES

       If the operating system uses optimistic memory allocation, the C library memory allocation routines will not return NULL, so it is not pos-
       sible to gracefully handle memory allocation failures.

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