wcstok, wcstok_s

• Falls str ! = NULL , wird der Aufruf als erster Aufruf von wcstok für diese spezielle Breitzeichenkette behandelt. Die Funktion sucht nach dem ersten Breitzeichen, das nicht in delim enthalten ist.

• Falls kein solches Breitzeichen gefunden wurde, existieren keine Tokens in str , und die Funktion gibt einen Nullzeiger zurück.
• Falls ein solches Breitzeichen gefunden wurde, stellt es den Beginn des Tokens dar. Die Funktion sucht dann ab diesem Punkt nach dem ersten Breitzeichen, das in delim enthalten ist.

• Falls kein solches Breitzeichen gefunden wurde, enthält str nur ein Token, und zukünftige Aufrufe von wcstok geben einen Nullzeiger zurück.
• Falls ein solches Breitzeichen gefunden wurde, wird es ersetzt durch das Null-Breitzeichen L ' \0 ' und der Parserzustand (typischerweise ein Zeiger auf das folgende Breitzeichen) wird im benutzerdefinierten Speicherort * ptr gespeichert.

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

• Falls str == NULL , wird der Aufruf als nachfolgender Aufruf von wcstok behandelt: Die Funktion setzt dort fort, wo sie beim vorherigen Aufruf mit demselben * ptr aufgehört hat. Das Verhalten entspricht dem, als ob der Zeiger auf das Breitzeichen, das auf das letzte erkannte Token folgt, als str übergeben wird.

Parameter

Rückgabewert

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

Hinweis

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

Im Gegensatz zu strtok , wcstok aktualisiert keinen statischen Speicher: Es speichert den Parser-Zustand im benutzerbereitgestellten Speicherort.

Im Gegensatz zu den meisten anderen Tokenizern können die Trennzeichen in wcstok für jeden nachfolgenden Token unterschiedlich sein und können sogar von den Inhalten der vorherigen Token abhängen.

Die Implementierung von wcstok_s im Windows CRT ist nicht mit dem C-Standard kompatibel, es handelt sich lediglich um einen 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