Man page - iconv_open(3)

Packages contains this manual

Available languages:

en fr es ja ru ro zh_TW zh_CN

Manual

ICONV_OPEN

名 前
書 åŧ
čĒŦ 明
čŋ” り 値
エ ナ ãƒŧ
バ ãƒŧ ジ ョ ãƒŗ
åąž 性
æē– 拠
é–ĸ é€Ŗ 項 į›Ž
こ ぎ 文 書 ãĢ つ い ãĻ

名 前

iconv_open - 文 字 ã‚ģ ッ ト 変 換 ぎ た め ぎ デ ã‚Ŗ ã‚š ク ãƒĒ プ ã‚ŋ ãƒŧ を å‰˛ り åŊ“ ãĻ る

書 åŧ

#include <iconv.h>

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 で 刊 į”¨ 可 čƒŊ で あ る 。

åąž 性

こ ぎ į¯€ で äŊŋ į”¨ さ れ ãĻ い る į”¨ čĒž ぎ čĒŦ 明 ãĢ つ い ãĻ は 、 attributes (7) を 参 į…§ 。

Image grohtml-36424-1.png

æē– 拠

POSIX.1-2001, POSIX.1-2008, SUSv2.

é–ĸ é€Ŗ 項 į›Ž

iconv (1), iconv (3), iconv_close (3)

こ ぎ 文 書 ãĢ つ い ãĻ

こ ぎ man ペ ãƒŧ ジ は Linux man-pages プ ロ ジ ェ ク ト ぎ ãƒĒ ãƒĒ ãƒŧ ã‚š 5.10 ぎ 一 部 で あ る 。 プ ロ ジ ェ ク ト ぎ čĒŦ 明 と バ グ å ą 告 ãĢ é–ĸ す る 情 å ą は https://www.kernel.org/doc/man-pages/ ãĢ 書 か れ ãĻ い る 。