wcsnrtombs(3)              Library Functions Manual              wcsnrtombs(3)

NUME
       wcsnrtombs - converte<?>te un <?>ir de caractere late intr-un <?>ir
       multi-octet

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <wchar.h>

       size_t wcsnrtombs(char dest[restrict .len], const wchar_t **restrict src,
                         size_t nwc, size_t len, mbstate_t *restrict ps);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       wcsnrtombs():
           Incepand cu glibc 2.10
               _POSIX_C_SOURCE >= 200809L
           Inainte de glibc 2.10:
               _GNU_SOURCE

DESCRIERE
       Func<?>ia wcsnrtombs() este ca <?>i func<?>ia wcsrtombs(3), cu
       excep<?>ia faptului ca numarul de caractere late care urmeaza sa fie
       convertite, incepand de la *src, este limitat la nwc.

       Daca dest nu este NULL, func<?>ia wcsnrtombs() converte<?>te cel mult
       nwc caractere late din <?>irul de caractere late *src intr-un <?>ir
       multi-octet care incepe la dest. Cel mult len octe<?>i sunt scri<?>i in
       dest. Se actualizeaza starea de conversie *ps. Conversia se realizeaza
       efectiv prin apelarea repetata a wcrtomb(dest, *src, ps), atata timp
       cat acest apel reu<?>e<?>te, iar apoi se incrementeaza dest cu numarul
       de octe<?>i scri<?>i <?>i *src cu unu. Conversia se poate opri din trei
       motive:

       o  A fost intalnit un caracter lat care nu poate fi reprezentat ca o
          secven<?>a de mai mul<?>i octe<?>i (in conformitate cu
          configura<?>ia regionala curenta). In acest caz, *src ramane
          indreptat catre caracterul lat nevalid, se returneaza (size_t) -1,
          iar errno este configurata la EILSEQ.

       o  Caracterele late nwc au fost convertite fara a se intalni un
          caracter lat nul (L'\0') sau limita de lungime for<?>eaza o oprire.
          In acest caz, *src ramane indreptat catre urmatorul caracter lat
          care urmeaza sa fie convertit, iar numarul de octe<?>i scris in dest
          este returnat.

       o  <?>irul de caractere late a fost complet convertit, inclusiv
          caracterul lat nul de sfar<?>it (care are ca efect secundar aducerea
          lui *ps la starea ini<?>iala). In acest caz, *src este setat la
          NULL, iar numarul de octe<?>i scri<?>i in dest, cu excep<?>ia
          octetului de sfar<?>it nul ('\0'), este returnat.

       Daca dest este NULL, len este ignorat, iar conversia se desfa<?>oara ca
       mai sus, cu excep<?>ia faptului ca octe<?>ii converti<?>i nu sunt
       scri<?>i in memorie <?>i ca nu exista o limita de lungime a
       destina<?>iei.

       In ambele cazuri de mai sus, daca ps este NULL, se utilizeaza in schimb
       o stare statica anonima cunoscuta doar de func<?>ia wcsnrtombs().

       Programatorul trebuie sa se asigure ca exista spa<?>iu pentru cel
       pu<?>in len octe<?>i la dest.

VALOAREA RETURNATA
       Func<?>ia wcsnrtombs() returneaza numarul de octe<?>i care alcatuiesc
       partea convertita a secven<?>ei multibyte, fara a include octetul nul
       de terminare. In cazul in care a fost intalnit un caracter lat care nu
       a putut fi convertit, se returneaza (size_t) -1, iar errno este
       configurata la EILSEQ.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +-------------+---------------------+----------------------------------+
       |Interfa<?>a  | Atribut             | Valoare                          |
       +-------------+---------------------+----------------------------------+
       |wcsnrtombs() | Siguran<?>a firelor | MT-Unsafe race:wcsnrtombs/!ps    |
       +-------------+---------------------+----------------------------------+
STANDARDE
       POSIX.1-2008.

NOTE
       Comportamentul lui wcsnrtombs() depinde de categoria LC_CTYPE din
       configura<?>ia regionala curenta.

       Transmiterea lui NULL ca ps nu este sigura pentru execu<?>ia cu mai
       multe fire.

CONSULTA<?>I <?>I
       iconv(3), mbsinit(3), wcsrtombs(3)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.9.1  15 iunie 2024                   wcsnrtombs(3)