wcstok, wcstok_s

wchar_t* wcstok( wchar_t* str, const wchar_t* delim, wchar_t** ptr );

wchar_t* wcstok( wchar_t*  restrict str, const wchar_t* restrict delim,
                 wchar_t** restrict ptr );

wchar_t* wcstok_s( wchar_t* restrict str, rsize_t* restrict strmax,
                   const wchar_t* restrict delim, wchar_t** restrict ptr);

• Si str != NULL, la llamada se trata como la primera llamada a wcstok para esta cadena ancha en particular. La función busca el primer carácter ancho que no está contenido en delim.

• Si no se encuentra tal carácter ancho, no hay tokens en str en absoluto, y la función devuelve un puntero nulo.
• Si se encuentra tal carácter ancho, es el inicio del token. La función entonces busca desde ese punto en adelante el primer carácter ancho que sí está contenido en delim.

• Si no se encuentra tal carácter ancho, str tiene solo un token, y futuras llamadas a wcstok devolverán un puntero nulo.
• Si se encuentra tal carácter ancho, se reemplaza por el carácter ancho nulo L'\0' y el estado del analizador (típicamente un puntero al siguiente carácter ancho) se almacena en la ubicación proporcionada por el usuario *ptr.

• La función entonces devuelve el puntero al inicio del token.

• Si str == NULL, la llamada se trata como una llamada subsiguiente a wcstok: la función continúa desde donde se quedó en la invocación anterior con el mismo *ptr. El comportamiento es el mismo que si el puntero al carácter ancho que sigue al último token detectado se pasara como str.

Parámetros

Valor de retorno

Devuelve un puntero al inicio del siguiente token o un puntero nulo si no hay más tokens.

Nota

Esta función es destructiva: escribe los caracteres L'\0' en los elementos de la cadena str. En particular, un literal de cadena ancha no se puede usar como primer argumento de wcstok.

A diferencia de strtok, wcstok no actualiza el almacenamiento estático: almacena el estado del analizador en la ubicación proporcionada por el usuario.

A diferencia de la mayoría de otros tokenizadores, los delimitadores en wcstok pueden ser diferentes para cada token subsiguiente, e incluso pueden depender del contenido de los tokens anteriores.

La implementación de wcstok_s en la CRT de Windows es incompatible con el estándar C, es meramente un alias para wcstok.

Ejemplo

#include <stdio.h>
#include <wchar.h>

int main(void)
{
    wchar_t input[] = L"A bird came down the walk";
    printf("Parsing the input string '%ls'\n", input);
    wchar_t* buffer;
    wchar_t* token = wcstok(input, L" ", &buffer);
    while (token)
    {
        printf("%ls\n", token);
        token = wcstok(NULL, L" ", &buffer);
    }

    printf("Contents of the input string now: '");
    for (size_t n = 0; n < sizeof input / sizeof *input; ++n)
        input[n] ? printf("%lc", input[n]) : printf("\\0");
    puts("'");
}

Parsing the input string 'A bird came down the walk'
A
bird
came
down
the
walk
Contents of the input string now: 'A\0bird\0came\0down\0the\0walk\0'

Referencias

Véase también