Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

strtok — dividir una cadena en tokens

strtok divide una cadena modificable en tokens no vacíos, sobrescribe los delimitadores y recuerda dónde continuar.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

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

strtok de <string.h> trata s2 como un conjunto de caracteres delimitadores, no como una subcadena. Omite los delimitadores iniciales y repetidos: no se generan tokens vacíos.

En la primera llamada, pase una cadena modificable terminada en nulo; en las llamadas siguientes, pase NULL como s1. s2 puede cambiar entre llamadas. El resultado apunta a un token dentro del array original, o es NULL cuando no quedan tokens.

El delimitador que termina un token se reemplaza por '\0'. No pase nunca un literal de cadena; copie la entrada si necesita conservarla.

El estado guardado impide intercalar tokenizaciones independientes. Continuar una secuencia en otro hilo tiene comportamiento indefinido. El ejemplo omite los delimitadores repetidos.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes