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);

• Wenn str != NULL, wird der Aufruf als erster Aufruf von wcstok für diesen bestimmten Breit-String behandelt. Die Funktion sucht nach dem ersten Breitzeichen, das nicht in delim enthalten ist.

• Wenn kein solches Breitzeichen gefunden wurde, gibt es überhaupt keine Token in str, und die Funktion gibt einen Nullzeiger zurück.
• Wenn ein solches Breitzeichen gefunden wurde, ist es der Anfang des Tokens. Die Funktion sucht dann von dieser Stelle aus nach dem ersten Breitzeichen, das in delim enthalten ist.

• Wenn kein solches Breitzeichen gefunden wurde, hat str nur ein Token, und zukünftige Aufrufe von wcstok geben einen Nullzeiger zurück.
• Wenn ein solches Breitzeichen gefunden wurde, wird es ersetzt durch das Null-Breitzeichen L'\0' und der Parser-Zustand (normalerweise ein Zeiger auf das folgende Breitzeichen) wird in der vom Benutzer bereitgestellten Stelle *ptr gespeichert.

• Die Funktion gibt dann den Zeiger auf den Anfang des Tokens zurück.

• Wenn str == NULL, wird der Aufruf als ein nachfolgender Aufruf von wcstok behandelt: Die Funktion setzt dort fort, wo sie beim vorherigen Aufruf mit dem gleichen *ptr aufgehört hat. Das Verhalten ist das gleiche, als ob der Zeiger auf das Breitzeichen, das dem zuletzt erkannten Token folgt, als str übergeben wird.

Parameter

Rückgabewert

Gibt einen Zeiger auf den Anfang des nächsten Tokens oder einen Nullzeiger zurück, wenn es keine weiteren Token gibt.

Hinweis

Diese Funktion ist destruktiv: Sie schreibt die L'\0'-Zeichen in die Elemente des Strings str. Insbesondere kann ein Breit-String-Literal nicht als erstes Argument von wcstok verwendet werden.

Im Gegensatz zu strtok aktualisiert wcstok keinen statischen Speicher: Es speichert den Parser-Zustand in der vom Benutzer bereitgestellten Stelle.

Im Gegensatz zu den meisten anderen Tokenizern können die Trennzeichen in wcstok für jedes nachfolgende Token unterschiedlich sein und sogar vom Inhalt der vorherigen Token abhängen.

Die Implementierung von wcstok_s in der Windows CRT ist nicht mit dem C-Standard kompatibel; sie ist lediglich ein Alias für wcstok.

Beispiel

#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'

Referenzen

Siehe auch