strtok_r()

Break a string into tokens

Synopsis:

#include <string.h>

char* strtok_r( char* s, 
                const char* sep, 
                char** lasts );

Library:

libc

Description:

The function strtok_r() breaks the string s into a sequence of tokens, each of which is delimited by a character from the string pointed to by sep. The lasts argument points to a user-provided pointer, which points to stored information necessary for strtok_r() to continue scanning the same string.

In the first call to strtok_r(), s must point to a null-terminated string, sep points to a null-terminated string of separator characters, and lasts is ignored. The strtok_r() function returns a pointer to the first character of the first token, writes a NULL character into s immediately following the returned token, and updates lasts.

In subsequent calls, s must be a NULL pointer and lasts must be unchanged from the previous call so that subsequent calls will move through the string s, returning successive tokens until no tokens remain. The separator string sep may be different from call to call. When no tokens remain in s, a NULL pointer is returned.

Returns:

A pointer to the token found, or to a NULL pointer when no token is found.

Classification:

POSIX 1003.1

See also:

strcspn(), strpbrk(), strtok()