CKTIS / C
strtok — podjela niza na tokene
strtok dijeli izmjenjivi niz na neprazne tokene, pritom prepisuje razdjelnike i pamti gdje treba nastaviti.
Verzija: 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> tretira s2 kao skup znakova razdjelnika, a ne kao podniz. Preskače početne i ponovljene razdjelnike: prazni tokeni se ne stvaraju.
Pri prvom pozivu proslijedite izmjenjivi niz završen nul-znakom; pri sljedećim pozivima proslijedite NULL kao s1. s2 se može mijenjati između poziva. Rezultat pokazuje na token u izvornom polju ili je NULL kada više nema tokena.
Razdjelnik koji završava token zamjenjuje se znakom '\0'. Nikada nemojte proslijediti nizovni literal; kopirajte ulaz ako ga trebate sačuvati.
Spremljeno stanje onemogućuje ispreplitanje neovisnih tokenizacija. Nastavak niza poziva u drugoj niti ima nedefinirano ponašanje. Primjer preskače ponovljene razdjelnike.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.