.\" -*- 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 iulie 2023" "Pagini de manual de Linux 6.05.01" 
.SH NUME
wcstok \- împarte șirul de caractere late în simboluri
.SH BIBLIOTECA
Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP)
.SH REZUMAT
.nf
\fB#include <wchar.h>\fP
.PP
\fBwchar_t *wcstok(wchar_t *restrict \fP\fIwcs\fP\fB, const wchar_t *restrict \fP\fIdelim\fP\fB,\fP
\fB                wchar_t **restrict \fP\fIptr\fP\fB);\fP
.fi
.SH DESCRIERE
Funcția \fBwcstok\fP() este echivalentul în caractere late al funcției
\fBstrtok\fP(3), cu un argument suplimentar pentru a o face sigură pentru mai
multe fire.  Aceasta poate fi utilizată pentru a diviza un șir de caractere
late \fIwcs\fP în simboluri, unde un simbol este definit ca o subșir care nu
conține niciun caracter lat din \fIdelim\fP.
.PP
Căutarea începe de la \fIwcs\fP, dacă \fIwcs\fP nu este NULL, sau de la \fI*ptr\fP,
dacă \fIwcs\fP este NULL.  În primul rând, orice caracter lat de delimitare
este sărit, adică indicatorul este avansat dincolo de orice caracter lat
care apare în \fIdelim\fP.  În cazul în care se ajunge la sfârșitul șirului de
caractere late, \fBwcstok\fP() returnează NULL, pentru a indica faptul că nu au
fost găsite simboluri, și stochează o valoare corespunzătoare în \fI*ptr\fP,
astfel încât apelurile ulterioare la \fBwcstok\fP() vor continua să returneze
NULL.  În caz contrar, funcția \fBwcstok\fP() recunoaște începutul unui simbol
și returnează un indicator către acesta, dar înainte de a face acest lucru,
termină în zero simbolul prin înlocuirea următorului caracter lat care apare
în \fIdelim\fP cu un caracter lat nul (L\[aq]\e0\[aq]) și actualizează \fI*ptr\fP
astfel încât apelurile ulterioare să continue căutarea după sfârșitul
simbolului recunoscut.
.SH "VALOAREA RETURNATĂ"
Funcția \fBwcstok\fP() returnează un indicator către următorul simbol sau NULL
dacă nu a fost găsit niciun alt simbol.
.SH ATRIBUTE
Pentru o explicație a termenilor folosiți în această secțiune, a se vedea
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interfață	Atribut	Valoare
T{
.na
.nh
\fBwcstok\fP()
T}	Siguranța firelor	MT\-Safe
.TE
.sp 1
.SH STANDARDE
C11, POSIX.1\-2008.
.SH ISTORIC
POSIX.1\-2001, C99.
.SH NOTE
Șirul original de caractere late \fIwcs\fP este modificat în mod distructiv în
timpul operației.
.SH EXEMPLE
Următorul cod face o buclă printre simbolurile conținute într\-un șir de
caractere late.
.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 "CONSULTAȚI ȘI"
\fBstrtok\fP(3), \fBwcschr\fP(3)
.PP
.SH TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de
Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>
.
.PP
Această traducere este documentație gratuită; citiți
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licența publică generală GNU Versiunea 3
.UE
sau o versiune ulterioară cu privire la condiții privind drepturile de autor.
NU se asumă NICIO RESPONSABILITATE.
.PP
Dacă găsiți erori în traducerea acestui manual,
vă rugăm să trimiteți un e-mail la
.MT translation-team-ro@lists.sourceforge.net
.ME .