GLProgramming.com

home :: about :: development guides :: irc :: forums :: search :: paste :: links :: contribute :: code dump

-> Click here to learn how to get live help <-


Manpage of STRTOK

STRTOK

Index
 

NAME

strtok, strtok_r - extract tokens from strings  

SYNOPSIS

#include <string.h>

char *strtok(char *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 fIdelimfP, followed by e0 or by a character occurring in fIdelimfP.

The fBstrtok()fP function can be used to parse the string fIsfP into tokens. The first call to fBstrtok()fP should have fIsfP 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 e0 and a pointer to the next character is saved for the next call to fBstrtok()fP. The delimiter string fIdelimfP may be different for each call.

The strtok_r() function is a reentrant version of the strtok() function, which instead of using its own static buffer, requires a pointer to a user allocated char*. 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.

These functions cannot be used on constant strings.

The identity of the delimiting character is lost.

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 fBstrtok()fP 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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
BUGS
RETURN VALUE
CONFORMING TO
SEE ALSO