iconv(3)                   Library Functions Manual                   iconv(3)

NUME
       iconv - efectueaza conversia setului de caractere

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <iconv.h>

       size_t iconv(iconv_t cd,
                    char **restrict inbuf, size_t *restrict inbytesleft,
                    char **restrict outbuf, size_t *restrict outbytesleft);

DESCRIERE
       Func<?>ia iconv() converte<?>te o secven<?>a de caractere dintr-o
       codificare de caractere intr-o secven<?>a de caractere dintr-o alta
       codificare de caractere. Argumentul cd este un descriptor de conversie,
       creat anterior printr-un apel la iconv_open(3); descriptorul de
       conversie define<?>te codificarile de caractere pe care iconv() le
       utilizeaza pentru conversie. Argumentul inbuf este adresa unei
       variabile care indica primul caracter din secven<?>a de intrare;
       inbytesleft indica numarul de octe<?>i din memoria tampon respectiva.
       Argumentul outbuf este adresa unei variabile care indica primul octet
       disponibil in memoria tampon de ie<?>ire; outbytesleft indica numarul
       de octe<?>i disponibili in memoria tampon de ie<?>ire.

       Cazul principal este atunci cand inbuf nu este NULL <?>i *inbuf nu este
       NULL. In acest caz, func<?>ia iconv() converte<?>te secven<?>a de mai
       mul<?>i octe<?>i care incepe la *inbuf intr-o secven<?>a de mai mul<?>i
       octe<?>i care incepe la *outbuf. Vor fi citi<?>i cel mult *inbytesleft
       octe<?>i, incepand de la *inbuf. Se vor scrie cel mult *outbytesleft
       octe<?>i, incepand de la *outbuf.

       Func<?>ia iconv() converte<?>te cate un caracter multi-octet la un
       moment dat <?>i, pentru fiecare convertire de caracter, mare<?>te
       *inbuf <?>i descre<?>te *inbytesleft cu numarul de octe<?>i de intrare
       converti<?>i, mare<?>te *outbuf <?>i descre<?>te *outbytesleft cu
       numarul de octe<?>i de ie<?>ire converti<?>i <?>i actualizeaza starea
       de conversie con<?>inuta in cd. In cazul in care codificarea
       caracterelor de intrare este de tip statutar, func<?>ia iconv() poate,
       de asemenea, sa converteasca o secven<?>a de octe<?>i de intrare intr-o
       actualizare a starii de conversie fara a produce niciun octet de
       ie<?>ire; o astfel de intrare se nume<?>te secven<?>a ,,shift".
       Conversia se poate opri din cinci motive:

       o  O secven<?>a multi-octet nevalida este intalnita la intrare.  In
          acest caz, configureaza errno la EILSEQ <?>i returneaza (size_t) -1.
          *inbuf ramane indreptat spre inceputul secven<?>ei multi-octet
          nevalide.

       o  Se intalne<?>te o secven<?>a multi-octet care este valida, dar care
          nu poate fi convertita in codificarea caracterelor de ie<?>ire.
          Aceasta condi<?>ie depinde de implementare <?>i de descriptorul de
          conversie. In biblioteca GNU C <?>i GNU libiconv, daca cd a fost
          creat fara sufixul //TRANSLIT sau //IGNORE, conversia este stricta:
          conversiile cu pierderi produc aceasta condi<?>ie. Daca a fost
          specificat sufixul //TRANSLIT, transliterarea poate evita aceasta
          condi<?>ie in unele cazuri. In biblioteca musl C, aceasta condi<?>ie
          nu poate aparea deoarece se utilizeaza o conversie in '*' ca
          solu<?>ie de rezerva. Nici in implementarile FreeBSD, NetBSD <?>i
          Solaris ale iconv() nu poate aparea aceasta condi<?>ie, deoarece se
          utilizeaza o conversie in '?' ca solu<?>ie de rezerva. Atunci cand
          aceasta condi<?>ie este indeplinita, iconv() stabile<?>te errno la
          EILSEQ <?>i returneaza (size_t) -1. *inbuf este lasata indicand
          inceputul secven<?>ei multi-octet neconvertibile.

       o  Secven<?>a de octe<?>i de intrare a fost convertita in intregime,
          adica *inbytesleft a coborat la 0. In acest caz, iconv() returneaza
          numarul de conversii nereversibile efectuate in timpul acestui apel.

       o  O secven<?>a de mai mul<?>i octe<?>i incompleta este intalnita la
          intrare, iar secven<?>a de octe<?>i de intrare se termina dupa ea.
          In acest caz, se stabile<?>te errno la EINVAL <?>i se returneaza
          (size_t) -1.  *inbuf ramane indreptat spre inceputul secven<?>ei
          multi-octet incomplete.

       o  Memoria tampon de ie<?>ire nu mai are loc pentru urmatorul caracter
          convertit.  In acest caz, configureaza errno la E2BIG <?>i
          returneaza (size_t) -1.

       Un caz diferit este atunci cand inbuf este NULL sau *inbuf este NULL,
       dar outbuf nu este NULL <?>i *outbuf nu este NULL. In acest caz,
       func<?>ia iconv() incearca sa fixeze starea de conversie a lui cd la
       starea ini<?>iala <?>i sa stocheze o secven<?>a de transformare
       corespunzatoare in *outbuf. Se vor scrie cel mult *outbytesleft
       octe<?>i, incepand de la *outbuf. Daca memoria tampon de ie<?>ire nu
       mai are loc pentru aceasta secven<?>a de reini<?>ializare, configureaza
       errno la E2BIG <?>i returneaza (size_t) -1.  In caz contrar, se
       incrementeaza *outbuf <?>i se decrementeaza *outbytesleft cu numarul de
       octe<?>i scri<?>i.

       Un al treilea caz este atunci cand inbuf este NULL sau *inbuf este
       NULL, iar outbuf este NULL sau *outbuf este NULL. In acest caz,
       func<?>ia iconv() stabile<?>te starea de conversie a lui cd la starea
       ini<?>iala.

VALOAREA RETURNATA
       Func<?>ia iconv() returneaza numarul de caractere convertite intr-un
       mod nereversibil in timpul acestui apel; conversiile reversibile nu
       sunt luate in considerare. In caz de eroare, iconv() returneaza
       (size_t) -1 <?>i configureaza errno pentru a indica eroarea.

ERORI-IE<?>IRE
       Pot aparea, printre altele, urmatoarele erori:

       E2BIG  Nu exista spa<?>iu suficient la *outbuf.

       EILSEQ O secven<?>a multi-octet nevalida a fost intalnita la intrare.

       EINVAL O secven<?>a multi-octet incompleta a fost intalnita la intrare.

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

       +------------------------------+---------------------+-----------------+
       |Interfa<?>a                   | Atribut             | Valoare         |
       +------------------------------+---------------------+-----------------+
       |iconv()                       | Siguran<?>a firelor | MT-Safe race:cd |
       +------------------------------+---------------------+-----------------+
       Func<?>ia iconv() este MT-Safe, atata timp cat apelan<?>ii iau masuri
       de excludere reciproca pentru argumentul cd.

STANDARDE
       POSIX.1-2008.

ISTORIC
       glibc 2.1.  POSIX.1-2001.

NOTE
       In fiecare serie de apeluri catre iconv(), ultimul ar trebui sa fie
       unul cu inbuf sau *inbuf egal cu NULL, pentru a elimina orice intrare
       par<?>ial convertita.

       De<?>i inbuf <?>i outbuf sunt tipizate ca char **, acest lucru nu
       inseamna ca obiectele pe care le indica pot fi interpretate ca <?>iruri
       de caractere C sau ca matrice de caractere: interpretarea secven<?>elor
       de octe<?>i de caractere este gestionata in mod intern de catre
       func<?>iile de conversie. In unele codificari, un octet zero poate fi o
       parte valida a unui caracter multi-octet.

       Cel care apeleaza iconv() trebuie sa se asigure ca indicatorii
       trecu<?>i in func<?>ie sunt adecva<?>i pentru accesarea caracterelor
       din setul de caractere corespunzator. Aceasta include asigurarea
       alinierii corecte pe platformele care au restric<?>ii stricte privind
       alinierea.

CONSULTA<?>I <?>I
       iconv_close(3), iconv_open(3), iconvconfig(8)

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 31 octombrie 2023                      iconv(3)