View Source: strtok(3) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

STRTOK
!!!STRTOK
NAME
SYNOPSIS
DESCRIPTION
BUGS
RETURN VALUE
CONFORMING TO
SEE ALSO
----
!!NAME


strtok, strtok_r - extract tokens from strings
!!SYNOPSIS


__#include
__''s''__, const char *__''delim''__);
char *strtok_r(char *__''s''__, const char *__''delim''__, char **__''ptrptr''__);
__
!!DESCRIPTION


A `token' is a nonempty string of characters not occurring
in the string ''delim'', followed by 0 or by a character
occurring in ''delim''.


The __strtok()__ function can be used to parse the string
''s'' into tokens. The first call to __strtok()__
should have ''s'' as its first argument. Subsequent calls
should have the first argument set to NULL. Each call
returns a pointer to the next token, or NULL when no more
tokens are found.


If a token ends with a delimiter, this delimiting character
is overwritten with a 0 and a pointer to the next character
is saved for the next call to __strtok()__. The delimiter
string ''delim'' may be different for each
call.


The __strtok_r()__ function works the same as the
__strtok()__ function, but instead of using a static
buffer it uses a pointer to a user allocated char* pointer.
This pointer, the ''ptrptr'' parameter, must be the same
while parsing the same string.
!!BUGS


Never use these functions. If you do, note
that:


These functions modify their first argument.


The identity of the delimiting character is
lost.


These functions cannot be used on constant
strings.


The __strtok__() function uses a static buffer while
parsing, so it's not thread safe. Use __strtok_r__() if
this matters to you.
!!RETURN VALUE


The __strtok()__ function returns a pointer to the next
token, or NULL if there are no more tokens.
!!CONFORMING TO


strtok()


SVID 3, POSIX, BSD 4.3, ISO 9899


strtok_r()


POSIX.1c
!!SEE ALSO


index(3), memchr(3), rindex(3),
strchr(3), strpbrk(3), strsep(3),
strspn(3), strstr(3)
----

12 pages link to strtok(3):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, June 4, 2002 12:24:36 am by "perry"

Edit PageHistory Diff Info LikePages