ne_buffer_ncreate(3) [suse man page]

NE_BUFFER_CREATE(3)						neon API reference					       NE_BUFFER_CREATE(3)

NAME

       ne_buffer_create, ne_buffer_ncreate - general purpose of group of functions

SYNOPSIS

       #include <ne_alloc.h>

       ne_buffer *ne_buffer_create(void);

       ne_buffer *ne_buffer_ncreate(size_t size);

DESCRIPTION

       ne_buffer_create creates a new buffer object, with an implementation-defined initial size.  ne_buffer_ncreate creates an ne_buffer where
       the minimum initial size is given in the size parameter. The buffer created will contain the empty string ("").

RETURN VALUE

       Both functions return a pointer to a new buffer object, and never NULL.

SEE ALSO

       ne_buffer

AUTHOR

       Joe Orton <neon@lists.manyfish.co.uk>
	   Author.

COPYRIGHT

neon 0.28.4							 25 February 2009					       NE_BUFFER_CREATE(3)

NE_BUFFER_DESTROY(3)						neon API reference					      NE_BUFFER_DESTROY(3)

NAME

       ne_buffer_destroy, ne_buffer_finish - destroy a buffer object

SYNOPSIS

       #include <ne_string.h>

       void ne_buffer_destroy (ne_buffer *buf);

       char *ne_buffer_finish (ne_buffer *buf);

DESCRIPTION

       ne_buffer_destroy  frees  all  memory  associated  with	the buffer. ne_buffer_finish frees the buffer structure, but not the actual string
       stored in the buffer, which is returned and must be free()d by the caller.

       Any use of the buffer object after calling either of these functions gives undefined behaviour.

RETURN VALUE

       ne_buffer_finish returns the malloc-allocated string stored in the buffer.

EXAMPLES

       An example use of ne_buffer_finish; the duplicate function returns a string made up of n copies of str:

       static char *duplicate(int n, const char *str)
       {
	 ne_buffer *buf = ne_buffer_create();
	 while (n--) {
	   ne_buffer_zappend(buf, str);
	 }
	 return ne_buffer_finish(buf);
       }

SEE ALSO

       ne_buffer(3), ne_buffer_create(3), ne_buffer_zappend(3)

AUTHOR

       Joe Orton <neon@webdav.org>.

neon 0.23.5							   8 October 2002					      NE_BUFFER_DESTROY(3)