Extract tokens within a wide character array.

This function is compatible with the following targets:

ANSI

BeOS

EMB/RTOS

Mac OS

Palm OS

Win32

#include <wchar.h>

wchar_t * wcstok(wchar_t * str, 

Parameters for this function are:

str	wchar_t *	The string to be modified
set	wchar_t *	The list of character to find
ptr	wchar_t *	Continuation information

Performs the same task as strtok for a wide character type however, it makes use of a third argument to contain sufficient information to continue the tokenization process.

When first called, the first argument is non-null. wcstok() returns a pointer to the first token in str or returns a null pointer if no token can be found.

Subsequent calls to wcstok() with a NULL str argument causes wcstok() to return a pointer to the next token or return a null pointer (NULL) when no more tokens exist. When called with a NULL str argument, the value of the ptr argument must have been set by a previous call to wcstok().

The wcstok function returns a pointer to the first wide character of a token, or a null pointer if there is no token.

"strtok"