NAME

nkf - ネットワーク用漢字コード変換フィルタ

SYNOPSIS

nkf [-butjnesliohrTVvwWJESZxXFfmMBOcdILg] [file ...]

DESCRIPTION

nkf はネットワークでメールやニュースの読み書きをするために作られた、漢字コードの変換フィルタである。

このnkfの特徴としては、入力漢字コード系の統計的な自動認識機能がある。 このため、利用者は、入力漢字コード系が何であるかを知らなくても、出力漢字コード系のみ指定すれば良いことになる。 ただ、この判定機構は、理論的には完全ではないが、通常のニュースやメールのメッセージについては確実に動作する安全なものにはなっている。

現在、nkfが認識できる入力の漢字コード系は、いわゆる JIS コード (ISO-2022-JP に基づくもの)、Shift_JIS (MS 漢字コード)、 日本語 EUC (AT&T コード)、UTF-8、UTF-16 のいずれかである。 出力する漢字コード系も、これらである。 入力は、ファイルを指定しなければ、標準入力となる。 出力は標準出力である。

OPTIONS

指定できるオプションは、以下の通り。 -mu のように続けることができる。

-j

JIS コードを出力する。

-e

EUC コードを出力する。

-s

Shift_JIS コードを出力する。

-w -w8[0] -w16[BL][0]

Unicode を出力する。

-m[BQSN0]

MIME を解読する。(デフォルト) ISO-2022-JP (B encode) と ISO-8859-1 (Q encode) のみを解読する。 ISO-8859-1 (Latin-1) を解読する時は、-l フラグも必要である。 -m0 では MIME を解読しない。 -mB, -mQ では、BASE64, Q encode されているものとして処理する。

-M[BQ]

MIME に変換する。

-J -E -S -W

期待される入力コードの性質を指定する。

-x

通常おこなわれる、いわゆる半角カナ (JIS X 0201 片仮名) からいわゆる全角カナ (JIS X 0208 片仮名) への変換を行わず、半角カナを保存する。 入力は、Shift_JIS の 1byte カナ、SO/SI、ESC-(-I, SSO を受け付ける。 出力は、日本語 EUC 中では SSO、JIS コード中では ESC-(-I をデフォルトで用いる。

-X

いわゆる半角カナ (JIS X 0201 片仮名) を いわゆる全角カナ (JIS X 0208 片仮名) へと変換する。

-B

壊れた (Broken) JIS コード。 ESC がなくなったと仮定する。

-f[m[-n]]

一行 m 文字になるように、マージンを n として簡単な整形をおこなう。 デフォルトは文字数は 60、マージンは 10 である。

-Z[0-3]

JIS X 0208 英数字と若干の記号を ASCII に変換する。 つまり、全角を半角に変換する。

-b

バッファリング出力を行う。(デフォルト)

-u

出力時に、バッファリングしない。 ssh localhost | nkf -u というように使う。

-t

何もしない。

-I

ISO-2022-JP 以外の漢字コードを〓に変換。

-i[@B]

JIS 漢字を指示するシーケンスを指定する。

-o[BJH]

1 バイト英数文字セットを指示するシーケンスを指定する。

-r

ROT13/47 の変換をする。

-g

自動判別の結果を出力します。

-T

テキストモードで出力する。(MS-DOS 上でのみ効力を持つ)

-l

0x80-0xfe のコードを ISO-8859-1 (Latin-1) として扱う。 JIS コードアウトプットとの組合せみのみ有効。 -s, -e, -x とは両立しない。

-O

ファイルに出力する。 UNIX では不要な機能だが Windows や MSDOS では必要らしい。 直後の引き数でなく、最後のファイル名が出力ファイル名となり上書きされてしまうので注意。 ファイル名がない場合は nkf.out。

-L[uwm] -d -c

改行コードを変換する。

--ic=<input_codeset --oc=<output_codeset>>

入力・出力の漢字コード系を指定します。

--fj --unix --mac --msdos --windows

これらのシステムに適した変換をします。

--jis --euc --sjis --mime --base64

対応する変換をします。

--hiragana --katakana

平仮名、片仮名変換

--fb-{skip, html, xml, perl, java, subchar}

Unicode から Shift_JIS, EUC-JP, ISO-2022-JP に変換する際に、変換できなかった文字をどう扱うかを指定できます。

--prefix=escape charactertarget character..

EUC-JP から Shift_JIS への変換の際、2 バイト目 に現れた文字の前にエスケープ文字をつけることができます。 引数の 1 文字目がエスケープ文字、2 文字目以降にエスケープされるべき文字を指定します。

例えば、

--prefix=\$@ とすると、Shift_JIS の 2 文字目に $ か @ が来たら、その前に \ が挿入されます --prefix=@@ とすると、Shift_JIS の 2 文字目に @ が来たら、その前に @ が挿入されます

--no-cp932ext

CP932 において拡張された、NEC 特殊文字、NEC 選定 IBM 拡張文字 (89-92 区)、IBM 拡張文字を変換しません。

--no-best-fit-chars

Unicode からの変換の際に、往復安全性が確保されない文字の変換を行いません。 Unicode から Unicode の変換の際に -x と共に指定すると、nkf を UTF 形式の変換に用いることができます。 (逆に言えば、これを指定しないと一部の文字が保存されません)

パスに関わる文字列を変換する際には、このオプションを指定することを強く推奨します。

--cap-input, --url-input

それぞれ :、% に続く 16 進数を文字に変換する

--numchar-input

&#....; のような Unicode 文字参照を変換する

--in-place[=SUFFIX] --overwrite[=SUFFIX]

元のファイルを変換結果で置き換える。 複数のファイルを書き換えることも可能。 元のファイルのタイムスタンプとパーミッションが保持される。 現在、作成日時や inode は変更されるが、将来にわたってこの実装のままである保証は無い。

--guess

自動判別の結果を出力する

--help

コマンドの簡単な説明を表示する。

-V

nkf の設定を表示する。

-v --version

nkf のバージョンを表示する。

--

これ以降のオプションを無視する

--exec-in

nkf [options] --exec-in cmd args... とやると、cmd の出力を nkf の入力とする (config.h で EXEC_IO を define してコンパイルした時のみ有効)

--exec-out

nkf [options] --exec-out cmd args... とやると、nkf の出力を cmd の入力とする (config.h で EXEC_IO を define してコンパイルした時のみ有効)

BUGS

実は、入力のコード系の判定は、Shift_JIS と EUC との自動判定であり、最初に特定できる文字が来た時点で確定してしまう。 そして、特定不能の間は保留バッファにためておかれ、確定後に処理される。 このため、7 ビット JIS は常に認識される。 Shift_JIS、EUC 混合もほとんどの場合は問題がない。 ただし、Shift_JIS のいわゆる半角カナ (JIS X 0201 片仮名) と EUC 漢字が識別できない。 したがって、デフォルトでは Shift_JIS のいわゆる半角カナはないと仮定している。 (つまり、Shift_JIS か EUC か迷った時は EUC とみなす)

Unicode の日本語以外の部分の変換には対応していないが、--no-best-fit-chars を指定すれば、UTF-8 と UTF-16 の相互変換をすることは可能である。

ACKNOWLEDGE

以下のかたがた、どうもありがとうございました。

AUTHOR

市川 至 ichikawa@flab.fujitsu.co.jp (was ichikawa@fujitsu.JUNET)

河野 真治 kono@ie.u-ryukyu.acjp

Rei FURUKAWA furukawa@tcp-ip.or.jp

成瀬

mastodon

https://osdn.jp/projects/nkf/

Copyright (C) 1987, FUJITSU LTD. (I.Ichikawa).

Copyright (C) 1996-2018, The nkf Project.