.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH wcstok 3 "20. Juli 2023" "Linux man\-pages 6.05.01" 
.SH BEZEICHNUNG
wcstok \- Eine Zeichenkette weiter Zeichen in Kürzel auftrennen
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <wchar.h>\fP
.PP
\fBwchar_t *wcstok(wchar_t *restrict \fP\fIzwz\fP\fB, const wchar_t *restrict \fP\fIbegren\fP\fB,\fP
\fB                wchar_t **restrict \fP\fIzeiger\fP\fB);\fP
.fi
.SH BESCHREIBUNG
Die Funktion \fBwcstok\fP() ist das Äquivalent der Funktion \fBstrtok\fP(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 \fIzwz\fP in Kürzel verwandt werden, wobei ein Kürzel als
Teilzeichenkette definiert ist, die keine weiten Zeichen aus \fIbegren\fP
enthält.
.PP
Die Suche beginnt bei \fIzwz\fP, falls \fIzwz\fP nicht NULL ist, oder bei
\fI*zeiger\fP, falls \fIzwz\fP NULL ist. Zuerst werden alle begrenzenden weiten
Zeichen übersprungen, d.h. der Zeiger über alle weiten Zeichen
vorwärtsbewegt, die in \fIbegren\fP vorkommen. Falls jetzt das Ende der
Zeichenkette weiter Zeichen erreicht wird, liefert \fBwcstok\fP() NULL zurück,
um anzuzeigen, dass keine Kürzel gefunden wurden, und speichert den
entsprechenden Wert in \fI*zeiger\fP, so dass nachfolgende Aufrufe von
\fBwcstok\fP() weiterhin NULL zurückliefern. Andernfalls erkennt die Funktion
\fBwcstok\fP() 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 \fIbegren\fP auftritt, mit dem
weiten Nullzeichen (L\[aq]\e0\[aq]) ersetzt und \fI*zeiger\fP aktualisiert, so
dass nachfolgende Aufrufe mit der Suche hinter dem Ende des erkannten
Kürzels fortfahren.
.SH RÜCKGABEWERT
Die Funktion \fBwcstok\fP() liefert einen Zeiger auf das nächste Kürzel oder
NULL zurück, falls kein weiteres Kürzel gefunden wurde.
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lbx lb lb
l l l.
Schnittstelle	Attribut	Wert
T{
.na
.nh
\fBwcstok\fP()
T}	Multithread\-Fähigkeit	MT\-Sicher
.TE
.sp 1
.SH STANDARDS
C11, POSIX.1\-2008.
.SH GESCHICHTE
POSIX.1\-2001, C99.
.SH ANMERKUNGEN
Die ursprüngliche Zeichenkette weiter Zeichen \fIzwz\fP wird während der Aktion
destruktiv verändert.
.SH BEISPIELE
Der folgende Code läuft in Schleifen über die in einer Zeichenkette weiter
Zeichen enthaltenen Kürzel.
.PP
.EX
wchar_t *wcs = …;
wchar_t *token;
wchar_t *state;
for (token = wcstok(wcs, L" \et\en", &state);
    token != NULL;
    token = wcstok(NULL, L" \et\en", &state)) {
    …
}
.EE
.SH "SIEHE AUCH"
\fBstrtok\fP(3), \fBwcschr\fP(3)
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .