CKTIS / C
strtok — découper une chaîne en jetons
strtok découpe une chaîne modifiable en jetons non vides, en remplaçant les délimiteurs et en mémorisant le point de reprise.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <string.h>
char *strtok(char * restrict s1, const char * restrict s2);strtok de <string.h> considère s2 comme un ensemble de caractères délimiteurs, et non comme une sous-chaîne. Il ignore les délimiteurs initiaux et répétés : aucun jeton vide n’est produit.
Lors du premier appel, passez une chaîne modifiable terminée par un caractère nul ; lors des appels suivants, passez NULL pour s1. s2 peut changer entre les appels. Le résultat pointe vers un jeton dans le tableau d’origine, ou vaut NULL lorsqu’il ne reste aucun jeton.
Le délimiteur qui termine un jeton est remplacé par '\0'. Ne passez jamais un littéral de chaîne ; faites une copie de l’entrée si vous devez la préserver.
L’état mémorisé empêche d’entrelacer des tokenisations indépendantes. La poursuite d’une séquence dans un autre thread entraîne un comportement indéfini. L’exemple ignore les délimiteurs répétés.
Exemples
#include <stdio.h>
#include <string.h>
int main(void)
{
char text[] = ",red;;green,blue,";
char *token = strtok(text, ",;");
while (token != NULL) {
puts(token);
token = strtok(NULL, ",;");
}
return 0;
}
Résultat
red green blue
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.