strtok_r

Name

strtok_r -- extract tokens from strings

Synopsis

#include <string.h>

char *strtok_r(char *s, const char *delim, char **ptrptr);

Description

strtok_r parses the string s into tokens. [1] The first call to strtok_r 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_r. The delimiter string delim may be different for each call.

ptrptr is a user allocated char* pointer. It must be the same while parsing the same string.

Bugs

Never use this function. Note that:

Return Value

strtok_r returns a pointer to the next token, or NULL if there are no more tokens.

Notes

[1]

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