CKTIS / C
strtok — dividir uma cadeia de caracteres em tokens
strtok divide uma cadeia de caracteres modificável em tokens não vazios, substituindo os delimitadores e guardando o ponto de continuação.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <string.h>
char *strtok(char * restrict s1, const char * restrict s2);strtok de <string.h> trata s2 como um conjunto de caracteres delimitadores, não como uma subcadeia. Ignora os delimitadores iniciais e repetidos: não são produzidos tokens vazios.
Na primeira chamada, passe uma cadeia de caracteres modificável terminada em nulo; nas chamadas seguintes, passe NULL como s1. s2 pode mudar entre chamadas. O resultado aponta para um token no array original ou é NULL quando não restam tokens.
O delimitador que termina um token é substituído por '\0'. Nunca passe um literal de cadeia de caracteres; faça uma cópia da entrada se precisar de a preservar.
O estado guardado impede intercalar tokenizações independentes. Continuar uma sequência noutra thread tem comportamento indefinido. O exemplo ignora os delimitadores repetidos.
Exemplos
#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;
}
Resultado
red green blue
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.