wcstok(3) Library Functions Manual wcstok(3)

wcstok - împarte șirul de caractere late în simboluri

Biblioteca C standard (libc, -lc)

#include <wchar.h>
wchar_t *wcstok(wchar_t *restrict wcs, const wchar_t *restrict delim,
                wchar_t **restrict ptr);

Funcția wcstok() este echivalentul în caractere late al funcției strtok(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 wcs în simboluri, unde un simbol este definit ca o subșir care nu conține niciun caracter lat din delim.

Căutarea începe de la wcs, dacă wcs nu este NULL, sau de la *ptr, dacă wcs 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 delim. În cazul în care se ajunge la sfârșitul șirului de caractere late, wcstok() returnează NULL, pentru a indica faptul că nu au fost găsite simboluri, și stochează o valoare corespunzătoare în *ptr, astfel încât apelurile ulterioare la wcstok() vor continua să returneze NULL. În caz contrar, funcția wcstok() 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 delim cu un caracter lat nul (L'\0') și actualizează *ptr astfel încât apelurile ulterioare să continue căutarea după sfârșitul simbolului recunoscut.

Funcția wcstok() returnează un indicator către următorul simbol sau NULL dacă nu a fost găsit niciun alt simbol.

Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).

Interfață Atribut Valoare
wcstok() Siguranța firelor MT-Safe

C11, POSIX.1-2008.

POSIX.1-2001, C99.

Șirul original de caractere late wcs este modificat în mod distructiv în timpul operației.

Următorul cod face o buclă printre simbolurile conținute într-un șir de caractere late.

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)) {
... }

strtok(3), wcschr(3)

Traducerea în limba română a acestui manual a fost creată de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă Nicio RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.

20 iulie 2023 Pagini de manual de Linux 6.05.01