HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
b
bufsplit(3G) bufsplit(3G)
NAME
bufsplit() - split buffer into fields
SYNOPSIS
#include <libgen.h>
size_t bufsplit(char *
buf, size_t n, char **a);
DESCRIPTION
bufsplit examines the buffer, buf, and assigns values to the pointer array, a, so that the pointers point
to the first n fields in buf that are delimited by tabs or new-lines.
To change the characters used to separate fields, call bufsplit with buf pointing to the string of charac-
ters, and n and a set to zero. For example, to use ’:’, ’.’, and ’,’ as separators along with tab and new-line:
bufsplit(":.,\t\n", 0, (char∗∗)0);
RETURN VALUE
The number of fields assigned in the array a.Ifbuf is zero, the return value is zero and the array is
unchanged. Otherwise the value is at least one. The remainder of the elements in the array are assigned
the address of the null byte at the end of the buffer.
APPLICATION USAGE
bufsplit is not thread safe. It is async-cancel-safe.
EXAMPLES
/*
∗ set a[0] = "This", a[1] = "is", a[2] = "a",
∗ a[3] = "test"
*/
bufsplit("This\tis\ta\ttest\n", 4, a);
WARNINGS
bufsplit changes the delimiters to null bytes in buf.
HP-UX Release 11i: December 2000 − 1 − Section 3−−55
___
___