Fonctions de la bibliothèque C -strtok()

Bibliothèque standard C - <string.h>

strtok() est une fonction de traitement de chaînes de caractères de la bibliothèque standard C, utilisée pour diviser une chaîne en une série de sous-chaînes (c'est-à-dire des « jetons »).

Fonctions de la bibliothèque Cchar *strtok(char *str, const char *delim)Diviser une chaînestrPour un ensemble de chaînes,delimcomme délimiteur.

Déclaration

Voici la déclaration de la fonction strtok().

char *strtok(char *str, const char *delim)

Paramètre

  • str: La chaîne à diviser. Lors du premier appel, passez la chaîne à diviser ; lors des appels suivants, passezNULL, indiquant de continuer à découper la même chaîne.

  • delim: La chaîne de délimiteurs.strtok()découpera en fonction de n'importe quel caractère de cette chaîne.str。

Valeur de retour

Renvoie un pointeur vers le jeton suivant. S'il n'y a plus de jetons, renvoie NULL.

Exemple

L'exemple suivant illustre l'utilisation de la fonction strtok().

Exemple

#include <string.h> #include <stdio.h> int main () { char str[80] = "This is - www.example.com - website"; const char s[2] = "-"; char *token; /*Obtenir la première sous-chaîne*/ token = strtok(str, s); /*Continuer à obtenir les sous-chaînes restantes*/ while( token != NULL ) { printf( "%s\n", token ); token = strtok(NULL, s); } return(0); }

Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant :

This is 
 www.example.com 
 website

Notes

  1. Modifier la chaîne d'origine: strtok()modifiera la chaîne transmise, en remplaçant les délimiteurs par\0(caractère nul). Par conséquent, la chaîne d'origine sera détruite.

  2. Non réentrant: strtok()Il utilise un tampon statique pour sauvegarder l'état, donc il n'est pas sûr pour les threads. S'il est utilisé dans un environnement multithread, envisagez d'utiliserstrtok_r()(version réentrante).

  3. Délimiteurs consécutifs: S'il y a des délimiteurs consécutifs dans la chaîne,strtok()il les ignorera et renverra le prochain jeton valide.


Version réentrante : strtok_r()

strtok_r() est une version réentrante de strtok(), qui vous permet de l'utiliser en toute sécurité dans des environnements multithread. Son prototype est le suivant :

char *strtok_r(char *str, const char *delim, char **saveptr);

saveptr: est un pointeur vers char*, utilisé pour sauvegarder l'état de découpage.

Exemple

#include <stdio.h>
#include <string.h>

int main() {
    char str[] = "Ceci est une chaîne d'exemple";
    char *token;
    char *saveptr;

    // Premier appel à strtok_r, en passant la chaîne à découper
    token = strtok_r(str, " ", &saveptr);

    // Continuer d'appeler strtok_r jusqu'à ce qu'il renvoie NULL
    while (token != NULL) {
        printf("%s\n", token);
        token = strtok_r(NULL, " ", &saveptr);
    }

    return 0;
}

strtok() est une fonction pratique de découpage de chaînes, mais vous devez être conscient de ses effets secondaires (modification de la chaîne d'origine) et de sa non-réentrance. Dans les environnements multi-threadés, il est recommandé d'utiliser strtok_r() pour éviter les conditions de concurrence.

Bibliothèque standard C - <string.h>

autres extensions