Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

strtok — rozdelenie reťazca na tokeny

strtok rozdeľuje meniteľný reťazec na neprázdne tokeny, prepisuje oddeľovače a zapamätá si miesto, odkiaľ pokračovať.

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

Syntax

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

strtok z <string.h> považuje s2 za množinu oddeľovacích znakov, nie za podreťazec. Preskakuje úvodné aj opakované oddeľovače: prázdne tokeny nevznikajú.

Pri prvom volaní odovzdajte meniteľný reťazec ukončený nulovým znakom; pri ďalších volaniach odovzdajte ako s1 hodnotu NULL. s2 sa medzi volaniami môže meniť. Výsledkom je ukazovateľ na token v pôvodnom poli alebo NULL, ak už nezostali žiadne tokeny.

Oddeľovač, ktorý ukončuje token, sa nahradí znakom '\0'. Nikdy neodovzdávajte reťazcový literál; ak potrebujete vstup zachovať, vytvorte jeho kópiu.

Uložený stav znemožňuje prepletať nezávislé rozdeľovania na tokeny. Pokračovanie sekvencie v inom vlákne má nedefinované správanie. Príklad preskakuje opakované oddeľovače.

Prí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ýsledok

red
green
blue

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje