ne_buffer_finish(3) [redhat man page]

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)

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>.

neon 0.23.5							   8 October 2002					       NE_BUFFER_APPEND(3)