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.