wprintf(3)                 Library Functions Manual                 wprintf(3)

NUME
       wprintf, fwprintf, swprintf, vwprintf, vfwprintf, vswprintf - conversia
       de ie<?>ire formatata a caracterelor late

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <stdio.h>
       #include <wchar.h>

       int wprintf(const wchar_t *restrict format, ...);
       int fwprintf(FILE *restrict stream,
                    const wchar_t *restrict format, ...);
       int swprintf(wchar_t wcs[restrict .maxlen], size_t maxlen,
                    const wchar_t *restrict format, ...);

       int vwprintf(const wchar_t *restrict format, va_list args);
       int vfwprintf(FILE *restrict stream,
                    const wchar_t *restrict format, va_list args);
       int vswprintf(wchar_t wcs[restrict .maxlen], size_t maxlen,
                    const wchar_t *restrict format, va_list args);

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

       Toate func<?>iile prezentate mai sus:
           _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE
               || _POSIX_C_SOURCE >= 200112L

DESCRIERE
       Familia de func<?>ii wprintf() este echivalentul in caractere late al
       familiei de func<?>ii printf(3). Aceasta realizeaza o ie<?>ire
       formatata a caracterelor late.

       Func<?>iile wprintf() <?>i vwprintf() efectueaza ie<?>irea de caractere
       late catre stdout (ie<?>irea standard). stdout nu trebuie sa fie
       orientata pe octe<?>i; a se vedea fwide(3) pentru mai multe
       informa<?>ii.

       Func<?>iile fwprintf() <?>i vfwprintf() efectueaza ie<?>irea de
       caractere late catre stream. stream nu trebuie sa fie orientat pe
       octe<?>i; a se vedea fwide(3) pentru mai multe informa<?>ii.

       Func<?>iile swprintf() <?> i vswprintf() efectueaza ie<?>irea de
       caractere late catre o matrice de caractere late. Programatorul trebuie
       sa se asigure ca exista spa<?>iu pentru cel pu<?>in maxlen caractere
       late la wcs.

       Aceste func<?>ii sunt similare func<?>iilor printf(3), vprintf(3),
       fprintf(3), vfprintf(3), sprintf(3), sprintf(3), vsprintf(3), cu
       excep<?>ia urmatoarelor diferen<?>e:

       o      <?>irul format este un <?>ir de caractere late.

       o      Ie<?>irea consta in caractere late, nu in octe<?>i.

       o      swprintf() <?>i vswprintf() accepta un argument maxlen,
              sprintf(3) <?>i vsprintf(3) nu; (snprintf(3) <?>i vsnprintf(3)
              accepta un argument maxlen, dar aceste func<?>ii nu returneaza
              -1 la depa<?>irea memoriei tampon in Linux).

       Tratamentul caracterelor de conversie c <?>i s este diferit:

       c      Daca nu este prezent nici un modificator l, argumentul int este
              convertit intr-un caracter lat printr-un apel la func<?>ia
              btowc(3), iar caracterul lat rezultat este scris. Daca este
              prezent un modificator l, se scrie argumentul wint_t (caracter
              lat).

       s      Daca nu este prezent nici un modificator l: se a<?>teapta ca
              argumentul const char * sa fie un indicator la o matrice de tip
              caracter (indicator la un <?>ir de caractere) care con<?>ine o
              secven<?>a de caractere de mai mul<?>i octe<?>i care incepe in
              starea ini<?>iala de deplasare. Caracterele din matrice sunt
              convertite in caractere late (fiecare prin apelarea func<?>iei
              mbrtowc(3) cu o stare de conversie care incepe in starea
              ini<?>iala inainte de primul octet). Caracterele late rezultate
              se scriu pana la (dar fara a include) caracterul lat nul de
              sfar<?>it (L,,\0"). In cazul in care se specifica o precizie, nu
              se scriu mai multe caractere late decat numarul specificat.
              Re<?>ine<?>i ca precizia determina numarul de caractere late
              scrise, nu numarul de octe<?>i sau pozi<?>ii pe ecran. Matricea
              trebuie sa con<?>ina un octet de sfar<?>it nul (,,\0"), cu
              excep<?>ia cazului in care se indica o precizie <?>i aceasta
              este atat de mica incat numarul de caractere late convertite il
              atinge inainte de a se ajunge la sfar<?>itul matricei. In cazul
              in care este prezent un modificator l: se a<?>teapta ca
              argumentul const wchar_t * sa fie un indicator la o matrice de
              caractere late. Caracterele late din matrice se scriu pana la
              (dar fara a include) un caracter lat nul de sfar<?>it. In cazul
              in care se specifica o precizie, nu se scriu mai multe caractere
              decat numarul specificat. Matricea trebuie sa con<?>ina un
              caracter lat nul de sfar<?>it, cu excep<?>ia cazului in care se
              indica o precizie <?>i aceasta este mai mica sau egala cu
              numarul de caractere late din matrice.

VALOAREA RETURNATA
       Func<?>iile returneaza numarul de caractere late scrise, cu excep<?>ia
       caracterului lat de sfar<?>it nul in cazul func<?>iilor swprintf() <?>i
       vswprintf(). Ele returneaza -1 atunci cand apare o eroare.

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

       +-------------------------------+---------------------+----------------+
       |Interfa<?>a                    | Atribut             | Valoare        |
       +-------------------------------+---------------------+----------------+
       |wprintf(), fwprintf(),         | Siguran<?>a firelor | MT-Safe locale |
       |swprintf(), vwprintf(),        |                     |                |
       |vfwprintf(), vswprintf()       |                     |                |
       +-------------------------------+---------------------+----------------+
STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       POSIX.1-2001, C99.

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

       In cazul in care <?>irul format con<?>ine caractere late non-ASCII,
       programul va func<?>iona corect numai daca categoria LC_CTYPE a
       configura<?>iei regionale curente in momentul execu<?>iei este
       aceea<?>i cu categoria LC_CTYPE a configura<?>iei regionale curente in
       momentul compilarii. Acest lucru se datoreaza faptului ca reprezentarea
       wchar_t este dependenta de platforma <?>i de configura<?>ia regionala;
       (glibc reprezinta caracterele late folosind punctul de cod Unicode
       (ISO/IEC 10646) al acestora, dar alte platforme nu fac acest lucru; de
       asemenea, utilizarea numelor de caractere universale C99 de forma
       \unnnn nu rezolva aceasta problema). Prin urmare, in programele
       interna<?>ionalizate, <?>irul format ar trebui sa fie format numai din
       caractere ASCII late sau ar trebui sa fie construit in timpul
       execu<?>iei intr-un mod interna<?>ionalizat (de exemplu, folosind
       gettext(3) sau iconv(3), urmat de mbstowcs(3)).

CONSULTA<?>I <?>I
       fprintf(3), fputwc(3), fwide(3), printf(3), snprintf(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                      wprintf(3)