Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes