plucky (3) iconv_open.3.gz

Provided by: manpages-ro-dev_4.25.1-1_all bug

NUME

       iconv_open - alocă descriptorul pentru conversia setului de caractere

BIBLIOTECA

       Biblioteca C standard (libc, -lc)

SINOPSIS

       #include <iconv.h>

       iconv_t iconv_open(const char *tocode, const char *fromcode);

DESCRIERE

       Funcția  iconv_open() alocă un descriptor de conversie adecvat pentru conversia secvențelor de octeți din
       codificarea de caractere fromcode în codificarea de caractere tocode.

       Valorile permise pentru fromcode și tocode și combinațiile acceptate depind de sistem.  Pentru biblioteca
       GNU  C,  valorile  permise  sunt  enumerate  de  comanda  iconv  --list, iar toate combinațiile valorilor
       enumerate sunt acceptate.  În plus, biblioteca GNU C și biblioteca GNU libiconv acceptă următoarele  două
       sufixe:

       //TRANSLIT
              Atunci  când  șirul  „//TRANSLIT”  este  adăugat  la tocode, se activează transliterarea.  Aceasta
              înseamnă că, atunci când un caracter nu poate fi reprezentat în setul de caractere  țintă,  acesta
              poate fi aproximat prin intermediul unuia sau mai multor caractere cu aspect similar.

       //IGNORE
              Atunci  când  șirul  „//IGNORE” este adăugat la tocode, caracterele care nu pot fi reprezentate în
              setul de caractere țintă vor fi eliminate în mod silențios.

       Descriptorul de conversie rezultat poate fi utilizat cu iconv(3) de un număr nelimitat  de  ori.   Acesta
       rămâne valabil până când este dezalocat (eliberat) cu iconv_close(3).

       Un  descriptor  de conversie conține o stare de conversie.  După crearea cu ajutorul iconv_open(), starea
       se află în starea inițială.  Utilizarea iconv(3) modifică starea de conversie a descriptorului.  Pentru a
       readuce starea în starea inițială, utilizați iconv(3) cu NULL ca argument inbuf.

VALOAREA RETURNATĂ

       În  caz  de  succes, iconv_open() returnează un descriptor de conversie proaspăt alocat.  În caz de eșec,
       returnează (iconv_t) -1 și configurează errno pentru a indica eroarea.

ERORI-IEȘIRE

       Poate apărea, printre altele, următoarea eroare:

       EINVAL Conversia de la fromcode la tocode nu este acceptată de implementare.

ATRIBUTE

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

       ┌───────────────────────────────────────────────────────────────────┬───────────────────┬────────────────┐
       │InterfațăAtributValoare        │
       ├───────────────────────────────────────────────────────────────────┼───────────────────┼────────────────┤
       │iconv_open()                                                       │ Siguranța firelor │ MT-Safe locale │
       └───────────────────────────────────────────────────────────────────┴───────────────────┴────────────────┘

STANDARDE

       POSIX.1-2008.

ISTORIC

       glibc 2.1.  POSIX.1-2001, SUSv2.

CONSULTAȚI ȘI

       iconv(1), iconv(3), iconv_close(3)

TRADUCERE

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

       Această   traducere  este  documentație  gratuită;  citiți  Licența  publică  generală  GNU  Versiunea  3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.