Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strtok — suddividere una stringa in token

strtok suddivide una stringa modificabile in token non vuoti, sovrascrivendo i delimitatori e memorizzando il punto da cui continuare.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

#include <string.h>
char *strtok(char * restrict s1, const char * restrict s2);

strtok di <string.h> considera s2 un insieme di caratteri delimitatori, non una sottostringa. Ignora i delimitatori iniziali e ripetuti: non vengono prodotti token vuoti.

Alla prima chiamata, passare una stringa modificabile terminata da null; alle chiamate successive, passare NULL come s1. s2 può cambiare tra una chiamata e l’altra. Il risultato punta a un token nell’array originale, oppure è NULL quando non restano token.

Il delimitatore che termina un token viene sostituito da '\0'. Non passare mai un literal di stringa; copiare l’input se è necessario conservarlo.

Lo stato memorizzato impedisce di alternare tokenizzazioni indipendenti. Continuare una sequenza in un altro thread comporta un comportamento indefinito. L’esempio ignora i delimitatori ripetuti.

Esempi

#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;
}

Risultato

red
green
blue

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti