User manual

mikroC PRO for PIC32
MikroElektronika
627
strtok
Prototype
char *strtok(char *s1, char *s2);
Returns The strtok function returns a pointer to the rst character of a token, or a null pointer if there is no
token.
Description A sequence of calls to the strtok function breaks the string pointed to by s1 into a sequence of tokens,
each of which is delimited by a character from the string pointed to by s2. The rst call in the sequence
has s1 as its rst argument, and is followed by calls with a null pointer as their rst argument. The
separator string pointed to by s2 may be different from call to call.
The rst call in the sequence searches the string pointed to by s1 for the rst character that is not
contained in the current separator string pointed to by s2. If no such character is found, then there are
no tokens in the string pointed to by s1 and the strtok function returns a null pointer. If such character
is found, it is the start of the rst token.
The strtok function then searches from there for a character that is contained in the current separator
string. If no such character is found, the current token extends to the end of the string pointed to by
s1, and subsequent searches for a token will return a null pointer. If such a character is found, it is
overwritten by a null character, which terminates the current token. The strtok function saves a pointer
to the following character, from which the next search for a token will start.
Each subsequent call, with a null pointer as the value of the rst argument, starts searching from the
saved pointer and behaves as described above.
Example
char x[10] ;
void main(){
strcpy(x, strtok(“mikroEl”, “Ek”));
strcpy(x, strtok(0, “kE”));
}