man strtok (Fonctions bibliothèques) - Extraire des mots d'une chaîne.

NOM

strtok, strtok_r - Extraire des mots d'une chaîne.

SYNOPSIS

#include <string.h>

char *strtok (char *s, const char *delim);

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

DESCRIPTION

Un élément lexical (token) est une chaîne non vide de caractères qui n'appartiennent pas à la chaîne delim, suivie de \0 ou d'un caractère appartenant à delim.

La fonction strtok() peut être utilisée pour scinder s en éléments lexicaux. Le premier appel à strtok() doit fournir s comme premier argument. Les appels ultérieurs doivent fournir NULL comme premier argument. Chaque appel renvoie un pointeur sur l'élément lexical suivant, ou NULL quand il n'y en a plus.

Si un token se termine par un délimiteur, le caractère de délimitation est surchargé par un \0 et un pointeur sur le caractère suivant est mémorisé pour l'appel suivant à strtok(). La chaîne de séparateurs delim peut être différente à chaque appel.

La fonction strtok_r() est identique à strtok() mais au lieu d'utiliser un buffer statique, elle emploie un pointeur sur un buffer "char *" alloué par l'utilisateur. Ce pointeur transmis comme paramètre ptrptr doit être toujours le même durant l'analyse d'une chaîne.

BOGUES

Évitez au maximum d'utiliser cette fonction. Sinon, prenez note des informations suivantes :

Cette fonction modifie son premier argument.

Les caractères de séparation sont surchargés, leur identité est donc perdue.

Cette fonction ne doit pas être invoquée sur une chaîne constante.

La fonction strtok() utilise un buffer statique et n'est donc pas sûre dans un contexte multithread. Dans ce cas il vaut mieux utiliser strtok_r().

VALEUR RENVOYÉE

La fonction strtok() renvoie un pointeur sur l'élément lexical suivant, ou NULL s'il n'y en a plus.

CONFORMITÉ

strtok ()
SVID 3, POSIX, BSD 4.3, ISO 9899
strtok_r ()
POSIX.1c

VOIR AUSSI

TRADUCTION

Christophe Blaess, 1996-2003.

CETTE PAGE DOCUMENTE AUSSI :