CKTIS / C
strtok — razdelitev niza na žetone
strtok razdeli spremenljiv niz na neprazne žetone, pri tem prepiše ločila in si zapomni, kje nadaljevati.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <string.h>
char *strtok(char * restrict s1, const char * restrict s2);strtok iz <string.h> obravnava s2 kot množico ločilnih znakov, ne kot podniz. Preskoči začetna in ponovljena ločila: prazni žetoni ne nastanejo.
Pri prvem klicu podajte spremenljiv niz, zaključen z ničelnim znakom; pri naslednjih klicih za s1 podajte NULL. s2 se lahko med klici spremeni. Rezultat kaže na žeton v izvirnem polju ali je NULL, če ni več žetonov.
Ločilo, ki konča žeton, se zamenja z '\0'. Nikoli ne podajte nizovnega literala; če želite vhod ohraniti, naredite njegovo kopijo.
Shranjeno stanje preprečuje prepletanje neodvisnih razčlenitev na žetone. Nadaljevanje zaporedja v drugi niti povzroči nedefinirano vedenje. Primer preskoči ponovljena ločila.
Primeri
#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;
}
Rezultat
red green blue
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.