bufsplit.3g (2010 09)

bufsplit(3G) bufsplit(3G)

NAME

bufsplit() - split buffer into ﬁelds

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 ﬁrst n ﬁelds in buf that are delimited by tabs or new-lines.

To change the characters used to separate ﬁelds, 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);

To use this interface, link in the libgen library by specifying

-lgen. For example:

cc foo.c -lgen

RETURN VALUE

The number of ﬁelds 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.

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 .

PAGE 1
bufsplit(3G) bufsplit(3G) NAME bufsplit() - split buffer into fields SYNOPSIS #include 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 characters, and n and a set to zero. For example, to use ’:’, ’.
PAGE 2
(Notes) A (Notes) bA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010