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.