.\" -*- 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 "23 июля 2024 г." "Linux man\-pages 6.12" .SH НАИМЕНОВАНИЕ iconv_open \- создаёт дескриптор преобразования кодировки набора символов .SH БИБЛИОТЕКА Standard C library (\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 , Иван Павлов и Kirill Rekhov . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .