Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ne_buffer_append (3)

Name

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

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-terminated 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);


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/neon     |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+

SEE ALSO
       ne_buffer, ne_buffer_create, ne_buffer_destroy

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

COPYRIGHT
NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://www.webdav.org/neon/neon-0.30.1.tar.gz.

       Further information about this software can be found on the open source
       community website at http://www.webdav.org/neon/.



neon 0.30.1                    23 September 2014           NE_BUFFER_APPEND(3)