STRTOK

Section: Linux Programmer's Manual (3)
Updated: Februari 10, 1996
 

NAME

strtok - extract token from string  

SYNOPSIS

#include <string.h>

char *strtok(char *s, const char *delim);
 

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.  

BUGS

Never use this function. This function modifies its first argument. The identity of the delimiting character is lost. This function cannot be used on constant strings.  

RETURN VALUE

The strtok() function returns a pointer to the next token, or NULL if there are no more tokens.  

CONFORMING TO

SVID 3, POSIX, BSD 4.3, ISO 9899  

SEE ALSO

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