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.