strtok, _mbstok, wcstok

Remonter à String.h - Index

Header File

string.h, mbstring.h

Category

Memory and String Manipulation Routines

Prototype

char *strtok(char *s1, const char *s2);

wchar_t *wcstok(wchar_t *s1, const wchar_t *s2);

unsigned char *_mbstok(unsigned char *s1, const unsigned char *s2);

Description

Searches one string for tokens, which are separated by delimiters defined in a second string.

strtok considers the string s1 to consist of a sequence of zero or more text tokens, separated by spans of one or more characters from the separator string s2.

The first call to strtok returns a pointer to the first character of the first token in s1 and writes a null character into s1 immediately following the returned token. Subsequent calls with null for the first argument will work through the string s1 in this way, until no tokens remain.

The separator string, s2, can be different from call to call.

Remarque :  Calls to strtok cannot be nested with a function call that also uses strtok. Doing so will causes an endless loop.

Return Value

strtok returns a pointer to the token found in s1. A NULL pointer is returned when there are no more tokens.

Example

  #include <string.h>
  #include <stdio.h>
  int main(void)
  {
     char input[16] = "abc,d";
     char *p;
     /* strtok places a NULL terminator
     in front of the token, if found */
     p = strtok(input, ",");
     if (p)   printf("%s\n", p);
     /* A second call to strtok using a NULL
     as the first parameter returns a pointer
     to the character following the token  */
     p = strtok(NULL, ",");
     if (p)   printf("%s\n", p);
     return 0;
  }

Portability

	POSIX	Win32	ANSI C	ANSI C++
strtok	+	+	+	+
_mbstok		+
wcstok		+	+	+