.\" -*- coding: UTF-8 -*- '\" t .\" Copyright, Bruno Haible .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH iconv_open 3 "8 февраля 2026 г." "Справочные страницы Linux 6.17" .SH НАИМЕНОВАНИЕ iconv_open \- создаёт дескриптор преобразования кодировки набора символов .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP,\ \fI\-lc\fP) .SH ОБЗОР .nf \fB#include \fP .P \fBiconv_t iconv_open(const char *\fP\fItocode\fP\fB, const char *\fP\fIfromcode\fP\fB);\fP .fi .SH ОПИСАНИЕ Функция \fBiconv_open\fP() создаёт дескриптор, предназначенный для преобразования последовательности байтов с кодировкой \fIfromcode\fP в кодировку \fItocode\fP. .P Значения, допустимые для кодировок \fIfromcode\fP и \fItocode\fP, и поддерживаемые комбинации, зависят от операционной системы. Для библиотеки GNU C разрешённые значения выводятся по команде \fIiconv \-\-list\fP, а также поддерживаются все комбинации перечисленных значений. Кроме этого, библиотеки GNU C и GNU libiconv поддерживают два следующих суффикса: .TP //TRANSLIT Если к \fItocode\fP добавлена строка «//TRANSLIT», то включается транслитерация. Это означает, что когда символ не может быть представлен в целевом наборе символов, то он аппроксимируется одним или несколькими похожими символами. .TP //IGNORE Если к \fItocode\fP добавлена строка «//IGNORE», то символы, которые не могут быть представлены в целевом наборе символов, будут просто отбрасываться. .P Полученный дескриптор преобразования может использоваться функцией \fBiconv\fP(3) любое количество раз. Он остается неизменным до тех пор, пока не будет освобождён функцией \fBiconv_close\fP(3). .P Дескриптор преобразования содержит состояние перекодировки После создания с помощью функции \fBiconv_open\fP(), состояние равно начальному значению. Использование \fBiconv\fP(3) меняет состояние преобразования. Чтобы вернуть состояние в начальное значение, необходимо использовать функцию \fBiconv\fP(3) с параметром \fIinbuf\fP, равным NULL. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" В случае успеха \fBiconv_open\fP() возвращает вновь выделенный дескриптор преобразования. В случае неудачи она возвращает \fI(iconv_t)\ \-1\fP и устанавливает \fIerrno\fP, чтобы указать на ошибку. .SH ОШИБКИ Среди прочих, может возникнуть следующая ошибка: .TP \fBEINVAL\fP Преобразование из кодировки \fIfromcode\fP в \fItocode\fP не поддерживается в данной реализации. .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ .na .nh \fBiconv_open\fP() T} Безвредность в нитях MT\-Safe locale .TE .SH СТАНДАРТЫ POSIX.1\-2008. .SH ИСТОРИЯ glibc 2.1. POSIX.1\-2001, SUSv2. .SH "СМОТРИТЕ ТАКЖЕ" \fBiconv\fP(1), \fBiconv\fP(3), \fBiconv_close\fP(3) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) Azamat Hackimov , Dmitriy S. Seregin , Yuri Kozlov и Иван Павлов . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .