Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri