opensolaris man page for ne_token

NE_TOKEN(3)							neon API reference						       NE_TOKEN(3)

NAME
       ne_token, ne_qtoken - string tokenizers

SYNOPSIS
       #include <ne_string.h>

       char *ne_token (char **str, char sep);

       char *ne_qtoken (char **str, char sep, const char *quotes);

DESCRIPTION
       ne_token and ne_qtoken tokenize the string at the location stored in the pointer str. Each time the function is called, it returns the next
       token, and modifies the str pointer to point to the remainer of the string, or NULL if there are no more tokens in the string. A  token	is
       delimited  by  the separator character sep; if ne_qtoken is used any quoted segments of the string are skipped when searching for a separa-
       tor. A quoted segment is enclosed in a pair of one of the characters given in the quotes string.

       The string being tokenized is modified each time the tokenizing function is called; replacing the next separator character with a NUL  ter-
       minator.

EXAMPLES
       The following function prints out each token in a comma-separated string list, which is modified in-place:

       static void splitter(char *list)
       {
	 do {
	   printf("Token: %s
", ne_token(&list, ','));
	 while (list);
       }

AUTHOR
       Joe Orton <neon@webdav.org>.

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

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWneon	      |
       +--------------------+-----------------+
       |Interface Stability | Volatile	      |
       +--------------------+-----------------+
NOTES
       Source for Neon is available on http://opensolaris.org.

neon 0.25.5							  20 January 2006						       NE_TOKEN(3)