BEZEICHNUNG

wcstok - Eine Zeichenkette weiter Zeichen in Kürzel auftrennen

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

#include <wchar.h>

wchar_t *wcstok(wchar_t *restrict zwz, const wchar_t *restrict begren,
                wchar_t **restrict zeiger);

BESCHREIBUNG

Die Funktion wcstok() ist das Äquivalent der Funktion strtok(3) für weite Zeichen, mit einem zusätzlichen Argument, um sie sicher für Multithreading zu machen. Sie kann zum Auftrennen der Zeichenkette weiter Zeichen zwz in Kürzel verwandt werden, wobei ein Kürzel als Teilzeichenkette definiert ist, die keine weiten Zeichen aus begren enthält.

Die Suche beginnt bei zwz, falls zwz nicht NULL ist, oder bei *zeiger, falls zwz NULL ist. Zuerst werden alle begrenzenden weiten Zeichen übersprungen, d.h. der Zeiger über alle weiten Zeichen vorwärtsbewegt, die in begren vorkommen. Falls jetzt das Ende der Zeichenkette weiter Zeichen erreicht wird, liefert wcstok() NULL zurück, um anzuzeigen, dass keine Kürzel gefunden wurden, und speichert den entsprechenden Wert in *zeiger, so dass nachfolgende Aufrufe von wcstok() weiterhin NULL zurückliefern. Andernfalls erkennt die Funktion wcstok() den Anfang eines Kürzels und liefert einen Zeiger darauf zurück. Bevor es dies allerdings macht, schließt es das Kürzel mit Null ab, indem es das nächste weite Zeichen, das in begren auftritt, mit dem weiten Nullzeichen (L'\0') ersetzt und *zeiger aktualisiert, so dass nachfolgende Aufrufe mit der Suche hinter dem Ende des erkannten Kürzels fortfahren.

RÜCKGABEWERT

Die Funktion wcstok() liefert einen Zeiger auf das nächste Kürzel oder NULL zurück, falls kein weiteres Kürzel gefunden wurde.

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

STANDARDS

C11, POSIX.1-2008.

GESCHICHTE

POSIX.1-2001, C99.

ANMERKUNGEN

Die ursprüngliche Zeichenkette weiter Zeichen zwz wird während der Aktion destruktiv verändert.

BEISPIELE

Der folgende Code läuft in Schleifen über die in einer Zeichenkette weiter Zeichen enthaltenen Kürzel.

wchar_t *wcs = …;
wchar_t *token;
wchar_t *state;
for (token = wcstok(wcs, L" \t\n", &state);
    token != NULL;
    token = wcstok(NULL, L" \t\n", &state)) {
    …
}

SIEHE AUCH

strtok(3), wcschr(3)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.