Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

strtok — rozdělení řetězce na tokeny

strtok rozděluje měnitelný řetězec na neprázdné tokeny, přepisuje oddělovače a zapamatuje si místo, odkud pokračovat.

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

Syntaxe

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

strtok z <string.h> považuje s2 za množinu oddělovacích znaků, nikoli za podřetězec. Přeskakuje počáteční i opakované oddělovače: prázdné tokeny nevznikají.

Při prvním volání předejte měnitelný řetězec ukončený nulovým znakem; při dalších voláních předejte jako s1 hodnotu NULL. s2 se mezi voláními může měnit. Výsledkem je ukazatel na token v původním poli, nebo NULL, pokud už žádné tokeny nezbývají.

Oddělovač, který ukončuje token, se nahradí znakem '\0'. Nikdy nepředávejte řetězcový literál; pokud potřebujete vstup zachovat, vytvořte jeho kopii.

Uložený stav znemožňuje prokládat nezávislá rozdělování na tokeny. Pokračování sekvence v jiném vlákně má nedefinované chování. Příklad přeskakuje opakované oddělovače.

Příklady

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

Výsledek

red
green
blue

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje