wcstok(3) Library Functions Manual wcstok(3) BEZEICHNUNG wcstok - Eine Zeichenkette weiter Zeichen in Kurzel auftrennen BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include wchar_t *wcstok(wchar_t *restrict zwz, const wchar_t *restrict begren, wchar_t **restrict zeiger); BESCHREIBUNG Die Funktion wcstok() ist das Aquivalent der Funktion strtok(3) fur weite Zeichen, mit einem zusatzlichen Argument, um sie sicher fur Multithreading zu machen. Sie kann zum Auftrennen der Zeichenkette weiter Zeichen zwz in Kurzel verwandt werden, wobei ein Kurzel als Teilzeichenkette definiert ist, die keine weiten Zeichen aus begren enthalt. Die Suche beginnt bei zwz, falls zwz nicht NULL ist, oder bei *zeiger, falls zwz NULL ist. Zuerst werden alle begrenzenden weiten Zeichen ubersprungen, d.h. der Zeiger uber alle weiten Zeichen vorwartsbewegt, die in begren vorkommen. Falls jetzt das Ende der Zeichenkette weiter Zeichen erreicht wird, liefert wcstok() NULL zuruck, um anzuzeigen, dass keine Kurzel gefunden wurden, und speichert den entsprechenden Wert in *zeiger, so dass nachfolgende Aufrufe von wcstok() weiterhin NULL zuruckliefern. Andernfalls erkennt die Funktion wcstok() den Anfang eines Kurzels und liefert einen Zeiger darauf zuruck. Bevor es dies allerdings macht, schliesst es das Kurzel mit Null ab, indem es das nachste 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 Kurzels fortfahren. RUCKGABEWERT Die Funktion wcstok() liefert einen Zeiger auf das nachste Kurzel oder NULL zuruck, falls kein weiteres Kurzel gefunden wurde. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------------------+-------------------------+-----------+ |Schnittstelle | Attribut | Wert | +--------------------------------+-------------------------+-----------+ |wcstok() | Multithread-Fahigkeit | MT-Sicher | +--------------------------------+-------------------------+-----------+ STANDARDS C11, POSIX.1-2008. GESCHICHTE POSIX.1-2001, C99. ANMERKUNGEN Die ursprungliche Zeichenkette weiter Zeichen zwz wird wahrend der Aktion destruktiv verandert. BEISPIELE Der folgende Code lauft in Schleifen uber die in einer Zeichenkette weiter Zeichen enthaltenen Kurzel. 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) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.18 8. Februar 2026 wcstok(3)