Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

strtok — dzielenie napisu na tokeny

strtok dzieli modyfikowalny napis na niepuste tokeny, nadpisując separatory i zapamiętując miejsce kontynuacji.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <string.h>
char *strtok(char * restrict s1, const char * restrict s2);

strtok z <string.h> traktuje s2 jako zbiór znaków separatorów, nie podnapis. Pomija separatory początkowe i kolejne: puste tokeny nie powstają.

Pierwsze wywołanie otrzymuje modyfikowalny napis zakończony znakiem zerowym; następne otrzymują NULL jako s1. s2 można zmieniać między wywołaniami. Wynikiem jest wskaźnik do tokenu w oryginalnej tablicy albo NULL, gdy tokenów brak.

Separator kończący token zostaje zastąpiony przez '\0'. Nie przekazuj literału napisowego; wykonaj kopię, jeśli potrzebujesz oryginału.

Zapamiętany stan wyklucza przeplatanie niezależnych podziałów. Kontynuacja sekwencji w innym wątku ma niezdefiniowane zachowanie. Przykład pomija powtarzające się separatory.

Przykłady

#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;
}

Wynik

red
green
blue

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła