.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   OpenGroup's Single UNIX specification
.\"     http://www.UNIX-systems.org/online.html
.\"
.\" 2007-03-31 Bruno Haible, Describe the glibc/libiconv //TRANSLIT
.\" and //IGNORE extensions for 'tocode'.
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH iconv_open 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" 
.SH NUME
iconv_open \- alocă descriptorul pentru conversia setului de caractere
.SH BIBLIOTECA
Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP)
.SH REZUMAT
.nf
\fB#include <iconv.h>\fP
.PP
\fBiconv_t iconv_open(const char *\fP\fItocode\fP\fB, const char *\fP\fIfromcode\fP\fB);\fP
.fi
.SH DESCRIERE
Funcția \fBiconv_open\fP() alocă un descriptor de conversie adecvat pentru
conversia secvențelor de octeți din codificarea de caractere \fIfromcode\fP în
codificarea de caractere \fItocode\fP.
.PP
Valorile permise pentru \fIfromcode\fP și \fItocode\fP și combinațiile acceptate
depind de sistem.  Pentru biblioteca GNU C, valorile permise sunt enumerate
de comanda \fIiconv \-\-list\fP, iar toate combinațiile valorilor enumerate sunt
acceptate.  În plus, biblioteca GNU C și biblioteca GNU libiconv acceptă
următoarele două sufixe:
.TP 
//TRANSLIT
Atunci când șirul „//TRANSLIT” este adăugat la \fItocode\fP, 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.
.TP 
//IGNORE
Atunci când șirul „//IGNORE” este adăugat la \fItocode\fP, caracterele care nu
pot fi reprezentate în setul de caractere țintă vor fi eliminate în mod
silențios.
.PP
Descriptorul de conversie rezultat poate fi utilizat cu \fBiconv\fP(3) de un
număr nelimitat de ori.  Acesta rămâne valabil până când este dezalocat
(eliberat) cu \fBiconv_close\fP(3).
.PP
Un descriptor de conversie conține o stare de conversie.  După crearea cu
ajutorul \fBiconv_open\fP(), starea se află în starea inițială.  Utilizarea
\fBiconv\fP(3) modifică starea de conversie a descriptorului.  Pentru a readuce
starea în starea inițială, utilizați \fBiconv\fP(3) cu NULL ca argument
\fIinbuf\fP.
.SH "VALOAREA RETURNATĂ"
În caz de succes, \fBiconv_open\fP() returnează un descriptor de conversie
proaspăt alocat.  În caz de eșec, returnează \fI(iconv_t)\ \-1\fP și
configurează \fIerrno\fP pentru a indica eroarea.
.SH ERORI\-IEȘIRE
Poate apărea, printre altele, următoarea eroare:
.TP 
\fBEINVAL\fP
Conversia de la \fIfromcode\fP la \fItocode\fP nu este acceptată de implementare.
.SH ATRIBUTE
Pentru o explicație a termenilor folosiți în această secțiune, a se vedea
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interfață	Atribut	Valoare
T{
.na
.nh
\fBiconv_open\fP()
T}	Siguranța firelor	MT\-Safe locale
.TE
.sp 1
.SH STANDARDE
POSIX.1\-2008.
.SH ISTORIC
glibc 2.1.  POSIX.1\-2001, SUSv2.
.SH "CONSULTAȚI ȘI"
\fBiconv\fP(1), \fBiconv\fP(3), \fBiconv_close\fP(3)
.PP
.SH TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de
Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>
.
.PP
Această traducere este documentație gratuită; citiți
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licența publică generală GNU Versiunea 3
.UE
sau o versiune ulterioară cu privire la condiții privind drepturile de autor.
NU se asumă NICIO RESPONSABILITATE.
.PP
Dacă găsiți erori în traducerea acestui manual,
vă rugăm să trimiteți un e-mail la
.MT translation-team-ro@lists.sourceforge.net
.ME .