mbsinit(3)                 Library Functions Manual                 mbsinit(3)

NUME
       mbsinit - test pentru starea ini<?>iala de schimbare (conversie)

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <wchar.h>

       int mbsinit(const mbstate_t *ps);

DESCRIERE
       Conversia caracterelor intre reprezentarea multi-octet <?>i
       reprezentarea caracterelor late utilizeaza starea de conversie, de tip
       mbstate_t. Conversia unui <?>ir de caractere utilizeaza o ma<?>ina cu
       stare finita; atunci cand aceasta este intrerupta dupa conversia
       completa a unui numar de caractere, poate fi necesar sa salveze o stare
       pentru procesarea caracterelor ramase. O astfel de stare de conversie
       este necesara pentru codificari precum ISO/IEC 2022 <?>i UTF-7.

       Starea ini<?>iala este starea de la inceputul conversiei unui <?>ir de
       caractere.  Exista doua tipuri de stare: cea utilizata de func<?>iile
       de conversie de la multi-octet la caractere late, cum ar fi
       mbsrtowcs(3), <?>i cea utilizata de func<?>iile de conversie de la
       caractere late la mult-octet, cum ar fi wcsrtombs(3), dar ambele incap
       intr-un mbstate_t <?>i ambele au aceea<?>i reprezentare pentru o stare
       ini<?>iala.

       Pentru codificarile pe 8 bi<?>i, toate starile sunt echivalente cu
       starea ini<?>iala.  In cazul codificarilor multi-octet, cum ar fi
       UTF-8, EUC-*, BIG5 sau SJIS, func<?>iile de conversie de la caracter
       lat la multi-octet nu produc niciodata stari ne-ini<?>iale, dar
       func<?>iile de conversie de la multi-octet la caracter lat, cum ar fi
       mbrtowc(3), produc stari ne-ini<?>iale atunci cand sunt intrerupte in
       mijlocul unui caracter.

       Un mod posibil de a crea un mbstate_t in starea ini<?>iala este de a-l
       fixa la zero:

           mbstate_t state;
           memset(&state, 0, sizeof(state));

       In Linux, func<?>ioneaza la fel de bine, dar ar putea genera
       avertismente de compilare:

           mbstate_t state = { 0 };

       Func<?>ia mbsinit() verifica daca *ps corespunde unei stari ini<?>iale.

VALOAREA RETURNATA
       mbsinit() returneaza o valoare diferita de zero daca *ps este o stare
       ini<?>iala sau daca ps este NULL.  In caz contrar, returneaza 0.

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

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |mbsinit()                             | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       POSIX.1-2001, C99.

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

CONSULTA<?>I <?>I
       mbrlen(3), mbrtowc(3), mbsrtowcs(3), wcrtomb(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.06 28 ianuarie 2024                     mbsinit(3)