.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) Bruno Haible .\" .\" 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 "15 декабря 2022 г." "Linux man\-pages 6.03" .SH ИМЯ iconv_open \- создаёт дескриптор преобразования кодировки набора символов .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \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. .PP Значения, допустимые для кодировок \fIfromcode\fP и \fItocode\fP, и поддерживаемые комбинации, зависят от операционной системы. Для библиотеки GNU C разрешённые значения выводятся по команде \fIiconv \-\-list\fP, а также поддерживаются все комбинации перечисленных значений. Кроме этого, библиотеки GNU C и GNU libiconv поддерживают два следующих суффикса: .TP //TRANSLIT Если к \fItocode\fP добавлена строка «//TRANSLIT», то включается транслитерация. Это означает, что когда символ не может быть представлен в целевом наборе символов, то он аппроксимируется одним или несколькими похожими символами. .TP //IGNORE Если к \fItocode\fP добавлена строка «//IGNORE», то символы, которые не могут быть представлены в целевом наборе символов, будут просто отбрасываться. .PP Полученный дескриптор преобразования может использоваться функцией \fBiconv\fP(3) любое количество раз. Он остается неизменным до тех пор, пока не будет освобождён функцией \fBiconv_close\fP(3). .PP Дескриптор преобразования содержит состояние перекодировки После создания с помощью функции \fBiconv_open\fP(), состояние равно начальному значению. Использование \fBiconv\fP(3) меняет состояние преобразования. Чтобы вернуть состояние в начальное значение, необходимо использовать функцию \fBiconv\fP(3) с параметром \fIinbuf\fP, равным NULL. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" On success, \fBiconv_open\fP() returns a freshly allocated conversion descriptor. On failure, it returns \fI(iconv_t)\ \-1\fP and sets \fIerrno\fP to indicate the error. .SH ОШИБКИ Среди прочих, может возникнуть следующая ошибка: .TP \fBEINVAL\fP Преобразование из кодировки \fIfromcode\fP в \fItocode\fP не поддерживается в данной реализации. .SH ВЕРСИИ This function is available since glibc 2.1. .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .ad l .nh .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ \fBiconv_open\fP() T} Безвредность в нитях MT\-Safe locale .TE .hy .ad .sp 1 .SH СТАНДАРТЫ POSIX.1\-2001, POSIX.1\-2008, SUSv2. .SH "СМ. ТАКЖЕ" \fBiconv\fP(1), \fBiconv\fP(3), \fBiconv_close\fP(3) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Azamat Hackimov , Dmitriy S. Seregin , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .