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.

VERSIUNI¶

Această funcție este disponibilă începând cu glibc 2.1.

ATRIBUTE¶

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

STANDARDE¶

POSIX.1-2001, POSIX.1-2008, 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 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.