名前

       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/ に書かれている。