=3 .ne \\$3 -->


Solaris  - NE_BUFFER_DESTROY (3)

NAME

ne_buffer_destroy, ne_buffer_finish - destroy a buffer object

CONTENTS

Author
Attributes
Notes

SYNOPSIS

#include <ne_string.h>

void ne_buffer_destroy (ne_buffer *buf);
char *ne_buffer_finish (ne_buffer *buf);

advertisement

advertisement


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 <[email protected].org>.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWneon
Interface StabilityVolatile

NOTES

Source for Neon is available on http://opensolaris.org.
Jump to page    or go to Top of page |  Section 3 |  OpenSolaris Man Main Index.


neon 0.25.5 NE_BUFFER_DESTROY (3) 20 January 2006
Generated by OpenSolaris Forum from /usr/share/man/man3/ne_buffer_destroy.3 using man macros with tbl support.