Man page - iconv(1)

Packages contains this manual

Available languages:

en fr es da tr ja ru ro zh_TW zh_CN de

Manual

ICONV

名 前
書 式
説 明
オ プ シ ョ ン
終 了 ス テ ー タ ス
環 境 変 数
フ ァ イ ル
準 拠
例
関 連 項 目
こ の 文 書 に つ い て

名 前

iconv - テ キ ス ト を あ る 文 字 符 号 化 か ら 別 の 文 字 符 号 化 に 変 換 す る

書 式

iconv [ options ] [-f from-encoding ] [-t to-encoding ] [ inputfile ]...

説 明

iconv プ ロ グ ラ ム は あ る 符 号 化 (encoding) か ら テ キ ス ト を 読 み 出 し 、 別 の 符 号 化 で そ の テ キ ス ト を 出 力 す る 。 入 力 が 指 定 さ れ な か っ た 場 合 、 も し く は 入 力 フ ァ イ ル と し て ダ ッ シ ュ (-) が 指 定 さ れ た 場 合 、 iconv は 標 準 入 力 か ら 入 力 を 行 う 。 出 力 が 指 定 さ れ な か っ た 場 合 、 iconv は 標 準 出 力 に 出 力 す る 。

from-encoding が 指 定 さ れ な か っ た 場 合 、 デ フ ォ ル ト は 現 在 の ロ ケ ー ル の 文 字 符 号 化 か ら 取 得 さ れ る 。 to-encoding が 指 定 さ れ な か っ た 場 合 、 デ フ ォ ル ト は 現 在 の ロ ケ ー ル の 文 字 符 号 化 か ら 取 得 さ れ る 。

オ プ シ ョ ン

-f from-encoding , --from-code= from-encoding

文 字 入 力 に from-encoding を 使 用 す る 。

-t to-encoding , --to-code= to-encoding

文 字 出 力 に to-encoding を 使 用 す る 。

to-encoding の 後 ろ に 文 字 列 //IGNORE が 付 い て い た 場 合 、 変 換 で き な か っ た 文 字 は 破 棄 さ れ 、 変 換 後 に エ ラ ー が 表 示 さ れ る 。

to-encoding の 後 ろ に 文 字 列 //TRANSLIT が 付 い て い た 場 合 、 変 換 さ れ る 文 字 の 書 き 直 し (transliterate) が 必 要 で 可 能 な 場 合 、 書 き 直 し が 行 わ れ る 。 変 換 先 の 文 字 集 合 で 文 字 が 表 現 で き な い 場 合 、 変 換 先 の 文 字 集 合 の 文 字 に 近 似 さ れ る こ と を 意 味 す る (1 文 字 の 場 合 も 複 数 文 字 の 場 合 も あ る )。 変 換 先 の 文 字 集 合 外 の 文 字 で 、 書 き 直 し も で き な い 文 字 は 、 出 力 で は 疑 問 符 (?) に 置 き 換 え ら れ る 。

-l , --list

認 識 す る す べ て の 文 字 集 合 符 号 化 の リ ス ト を 表 示 す る 。

-c

変 換 で き な い 文 字 が あ っ た 場 合 に 、 変 換 を 終 了 す る の で は な く 、 そ の 文 字 を 黙 っ て 破 棄 す る 。

-o outputfile , --output= outputfile

出 力 に outputfile を 使 用 す る 。

-s , --silent

こ の オ プ シ ョ ン は 無 視 さ れ る 。 互 換 性 の た め だ け に 存 在 す る 。

--verbose

複 数 の フ ァ イ ル を 処 理 す る 際 に 進 捗 情 報 を 標 準 エ ラ ー に 出 力 す る 。

-? , --help

使 用 方 法 を 表 示 し 、 終 了 す る 。

--usage

簡 潔 な 使 用 方 法 を 出 力 し 、 終 了 す る 。

-V , --version

iconv の バ ー ジ ョ ン 番 号 、 ラ イ セ ン ス 、 保 証 免 責 を 表 示 す る 。

終 了 ス テ ー タ ス

成 功 す る と 0 で 、 エ ラ ー の 場 合 0 以 外 。

環 境 変 数

内 部 で は 、 iconv プ ロ グ ラ ム は iconv (3) 関 数 を 使 用 す る 。 iconv (3) 関 数 は 順 に gconv モ ジ ュ ー ル (動 的 に ロ ー ド さ れ る 共 有 ラ イ ブ ラ リ ) を 使 っ て 、 変 換 元 、 変 換 先 の 文 字 集 合 を 取 り 扱 う 。 iconv (3) を 呼 び 出 す 前 に 、 iconv プ ロ グ ラ ム は 最 初 に iconv_open (3) を 使 っ て 変 換 デ ィ ス ク リ プ タ ー を 割 り 当 て る 。 iconv_open (3) の 動 作 は GCONV_PATH 環 境 変 数 の 設 定 の 影 響 を 受 け る 。

*

GCONV_PATH が 設 定 さ れ て い な い 場 合 、 iconv_open (3) は iconvconfig (8) に よ り 作 成 さ れ た シ ス テ ム の gconv モ ジ ュ ー ル 設 定 キ ャ ッ シ ュ フ ァ イ ル を 読 み 込 み 、 そ れ か ら こ の 設 定 に 基 づ き 、 変 換 を 行 う の に 必 要 な gconv モ ジ ュ ー ル を ロ ー ド す る 。 シ ス テ ム の gconv モ ジ ュ ー ル 設 定 キ ャ ッ シ ュ フ ァ イ ル が 利 用 で き な い 場 合 、 シ ス テ ム の gconv モ ジ ュ ー ル 設 定 フ ァ イ ル が 使 用 さ れ る 。

*

GCONV_PATH (コ ロ ン 区 切 り の パ ス 名 の リ ス ト ) が 定 義 さ れ て い る 場 合 、 シ ス テ ム の gconv モ ジ ュ ー ル 設 定 キ ャ ッ シ ュ は 使 用 さ れ な い 。 代 わ り に iconv_open (3) は 最 初 に GCONV_PATH に 指 定 さ れ た デ ィ レ ク ト リ を 順 番 に 検 索 し て 設 定 フ ァ イ ル の 読 み 出 し を 試 み 、 そ の 後 で シ ス テ ム の デ フ ォ ル ト の gconv モ ジ ュ ー ル 設 定 フ ァ イ ル を ロ ー ド す る 。 デ ィ レ ク ト リ に gconv モ ジ ュ ー ル 設 定 フ ァ イ ル が な い 場 合 、 そ の デ ィ レ ク ト リ に あ る gconv モ ジ ュ ー ル は 無 視 さ れ る 。 デ ィ レ ク ト リ に gconv モ ジ ュ ー ル 設 定 フ ァ イ ル が あ り 、 そ の デ ィ レ ク ト リ に 現 在 の 変 換 に 必 要 な モ ジ ュ ー ル が あ る と 判 断 し た 場 合 、 必 要 な モ ジ ュ ー ル が こ の デ ィ レ ク ト リ か ら ロ ー ド さ れ る 。 GCONV_PATH で 最 初 に 見 つ か っ た 適 切 な モ ジ ュ ー ル が 使 用 さ れ る 。 こ れ に よ り 、 ユ ー ザ ー が 独 自 の モ ジ ュ ー ル を 使 用 し 、 GCONV_PATH デ ィ レ ク ト リ に そ れ ら の モ ジ ュ ー ル を 置 く こ と で シ ス テ ム が 提 供 す る モ ジ ュ ー ル を 置 き 換 え る こ と が で き る 。

フ ァ イ ル

/usr/lib/gconv

通 常 の デ フ ォ ル ト の gconv モ ジ ュ ー ル の パ ス 。

/usr/lib/gconv/gconv-modules

通 常 の デ フ ォ ル ト の gconv モ ジ ュ ー ル の シ ス テ ム 設 定 フ ァ イ ル 。

/usr/lib/gconv/gconv-modules.cache

通 常 の デ フ ォ ル ト の gconv モ ジ ュ ー ル の シ ス テ ム 設 定 キ ャ ッ シ ュ 。

準 拠

POSIX.1-2001.

例

テ キ ス ト を ISO 8859-15 文 字 符 号 化 か ら UTF-8 に 変 換 す る 。

$ iconv -f ISO-8859-15 -t UTF-8 < input.txt > output.txt

以 下 の 例 は UTF-8 か ら ASCII へ の 変 換 を 行 い 、 可 能 で あ れ ば 書 き 直 し (transliterate) を 行 う 。

$ echo abc ß α € àḃç | iconv -f UTF-8 -t ASCII//TRANSLIT
abc ss ? EUR abc

関 連 項 目

locale (1), uconv (1), iconv (3), nl_langinfo (3), charsets (7), iconvconfig (8)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。