リナックスコマンド

iconv_openのヘルプ・マニュアル

日本語 英語

• help
• man

iconv_open --help

man iconv_open

ICONV_OPEN(3) Linux Programmer’s Manual ICONV_OPEN(3) 名前 iconv_open - 文字セット変換のためのディスクリプタを割り当てる 書式 #include iconv_t iconv_open(const char *tocode, const char *fromcode); 説明 iconv_open() 関数は、文字エンコーディング fromcode から文字エンコーディ ング tocode へのバイト文字列変換に適した変換ディスクリプタを割り当て る 。 fromcode と tocode に使うことのできる値と、サポートされる組み合わせは、 システムに依存する。 GNU C ライブラリでは、使うことのできる値 は iconv --list コマンドでリストされ、リストされたすべての値の組み合わせがサポー トされる。さらに、 GNU C ライブラリと GNU libiconv ライブラリでは、以下 の接尾辞がサポートされている。 //TRANSLIT tocode の 後 ろ に 文 字列 "//TRANSLIT" が付いている場合、翻訳 (transliteration) が有効になる。この場合、変換先の文字セットで表 現できない文字を、その文字と同じように見える文字 (複数文字の場合 もある) で表現することができる。 //IGNORE tocode の後ろに文字列 "//IGNORE" が付いている場合、変換先の文 字 セットで表現できない文字は黙って無視される。 こ の関数を読んで得られた変換ディスクリプタは、 iconv(3) で何度でも使う ことができる。これは iconv_close(3) を使って解放されるまで有効である。 変換ディスクリプタは変換状態を持つ。 iconv_open() を用いて生成された 後 、 変換状態は初期状態である。 iconv(3) を使うことにより、ディスクリプタ の変換状態が変更される。 (変換ディスクリプタはマルチスレッドで同時に 使 う こ と ができないことを意味している。) 変換状態を初期状態に戻すには、 inbuf 引き数を NULL として iconv(3) を用いること。 返り値 iconv_open() 関数は、新たに割り当てられた変換ディスクリプタを返す。エラ ーの場合、この関数は errno を設定し、 (iconv_t) -1 を返す。 エラー 他のいろいろなエラーのうち、以下のエラーが起こりうる。 EINVAL fromcode から tocode への変換は、この実装ではサポートされていな い。 バージョン この関数はバージョン 2.1 以降の glibc で利用可能である。 準拠 UNIX98, POSIX.1-2001. 関連項目 iconv(1), iconv(3), iconv_close(3) GNU 2008-08-11 ICONV_OPEN(3)

ICONV_OPEN(3) Linux Programmer’s Manual ICONV_OPEN(3) NAME iconv_open - allocate descriptor for character set conversion SYNOPSIS #include iconv_t iconv_open(const char *tocode, const char *fromcode); DESCRIPTION The iconv_open() function allocates a conversion descriptor suitable for converting byte sequences from character encoding fromcode to char- acter encoding tocode. The values permitted for fromcode and tocode and the supported combina- tions are system-dependent. For the GNU C library, the permitted val- ues are listed by the iconv --list command, and all combinations of the listed values are supported. Furthermore the GNU C library and the GNU libiconv library support the following two suffixes: //TRANSLIT When the string "//TRANSLIT" is appended to tocode, translitera- tion is activated. This means that when a character cannot be represented in the target character set, it can be approximated through one or several similarly looking characters. //IGNORE When the string "//IGNORE" is appended to tocode, characters that cannot be represented in the target character set will be silently discarded. The resulting conversion descriptor can be used with iconv(3) any num- ber of times. It remains valid until deallocated using iconv_close(3). A conversion descriptor contains a conversion state. After creation using iconv_open(), the state is in the initial state. Using iconv(3) modifies the descriptor’s conversion state. (This implies that a con- version descriptor can not be used in multiple threads simultaneously.) To bring the state back to the initial state, use iconv(3) with NULL as inbuf argument. RETURN VALUE The iconv_open() function returns a freshly allocated conversion descriptor. In case of error, it sets errno and returns (iconv_t) -1. ERRORS The following error can occur, among others: EINVAL The conversion from fromcode to tocode is not supported by the implementation. VERSIONS This function is available in glibc since version 2.1. CONFORMING TO UNIX98, POSIX.1-2001. SEE ALSO iconv(1), iconv(3), iconv_close(3) COLOPHON This page is part of release 3.22 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/. GNU 2008-08-11 ICONV_OPEN(3)