agrep - リファレンスマニュアル、オプション、コマンド例

名前

agrep - パターンにほぼ一致する行を印刷します

概要

agrep [OPTION]... PATTERN [FILE]...

説明

各 FILE または標準入力内の PATTERN にほぼ一致するものを検索します。例：

agrep -2 optimize foo.txt

2 つのエラー以内で「optimize」に一致するファイル `foo.txt' 内のすべての行を出力します。例えば。「optimise」、「optmise」、および「opitmize」を含む行はすべて一致します。

オプション

正規表現の選択と解釈:

-e PATTERN, - -regexp=PATTERN: PATTERN を正規表現として使用します。 - で始まるパターンを保護するのに役立ちます。
-i, - -ignore-case: PATTERN および入力ファイルの大文字と小文字の区別 (現在のロケールで定義されている) を無視します。
-k, - -literal: PATTERN をリテラル文字列、つまり特殊文字を含まない固定文字列として扱います。
-w, - -word-regexp: PATTERN が単語全体のみに一致するように強制します。「単語全体」とは、先頭またはレコードで始まるか、単語以外の構成文字が前にある部分文字列です。同様に、部分文字列はレコードの最後で終わるか、単語以外の構成文字が後に続く必要があります。単語を構成する文字は、英数字 (現在のロケールで定義されている) とアンダースコア文字です。単語以外の構成文字が一致を囲む必要があることに注意してください。それらはエラーとしてカウントされません。

おおよそのマッチング設定:

-D NUM, - -delete-cost=NUM: 欠落文字のコストを NUM に設定します。
-I NUM, - -insert-cost=NUM: 追加文字のコストを NUM に設定します。
-S NUM, - -substitute-cost=NUM: 間違った文字のコストを NUM に設定します。削除 (欠落文字) と挿入 (余分な文字) は一緒に置換文字を構成しますが、コストは削除と挿入の合計のコストになることに注意してください。したがって、置換の const が削除と挿入のコストの合計よりも大きく設定されている場合、直接置換は行われません。
-E NUM, - -max-errors=NUM: 最大で NUM 個のエラーがあるレコードを選択します。
-#: 最大で # 個のエラーがあるレコードを選択します (# は 0 ～ 9 の数字です)。

その他:

-d PATTERN, - -delimiter=PATTERN: レコード区切り文字の正規表現を PATTERN に設定します。 2 つの区切り文字の間、最初の区切り文字の前、および最後の区切り文字の後のテキストは、レコードとみなされます。デフォルトのレコード区切り文字は正規表現「\n」であるため、デフォルトではレコードは行になります。 PATTERN には、空の文字列に一致しない任意の正規表現を指定できます。たとえば、-d "^From " を使用すると、メールメッセージがメールボックス形式ファイル内のレコードとして定義されます。
-v, - -invert-match: 一致するレコードの代わりに一致しないレコードを選択します。
-V, - -version: バージョン情報を出力して終了します。
-y, - -nothing: 何もしません。このオプションは、非フリーの agrep プログラムとの互換性のためだけに存在します。
- -help: 簡単なヘルプメッセージを表示して終了します。

出力制御:

-B, - -best-match: 最も一致するレコード、つまりコストが最も低いレコードのみを出力します。これは現在、入力ファイルに対して 2 つのパスを作成することによって実装されており、標準入力から読み取る場合には使用できません。
- -color, - -colour: 出力内の一致する文字列をカラーマーカーで強調表示します。色の文字列はGREP_COLOR環境変数から取得されます。デフォルトの色は赤です。
-c, - -count: 各入力ファイルごとに一致するレコードの数のみを出力し、通常の出力を抑制します。
-h, - -no-filename: 複数のファイルが検索される場合、出力時にファイル名の接頭辞を抑制します。
-H, - -with-filename: 各出力レコードの先頭に、レコードが読み取られた入力ファイルの名前を付けます。
-l, - -files-with-matches: 少なくとも 1 つの一致を含む各入力ファイルの名前のみを出力し、通常の出力を抑制します。各ファイルのスキャンは、最初に一致した時点で停止します。
-n, - -record-number: 入力ファイル内の各出力レコードの先頭にシーケンス番号を付けます。最初のレコードの番号は 1 です。
-q, - -quiet, - -silent: 標準出力には何も書き込まないでください。一致するものが見つかった場合は、終了ステータス 0 で直ちに終了します。
-s, - -show-cost: 出力に一致するコストを出力します。
- -show-position: 各出力レコードの先頭に、レコード内の最初の一致の開始オフセットと終了オフセットを付けます。レコードの最初の文字のオフセットは 0 です。終了位置は、一致後の最初の文字のオフセットとして指定されます。
-M, - -delimiter-after: デフォルトでは、レコード区切り文字は改行文字であり、一致するレコードの後に出力されます。 -d を使用すると、レコード区切り文字が一致するレコードの前に出力されます。このオプションを指定すると、一致するレコードの後に区切り文字が出力されます。

FILE がない場合、または FILE が - の場合、標準入力を読み取ります。指定された FILE が 2 つ未満の場合は -h が想定され、それ以外の場合は -H がデフォルトです。

診断

終了ステータスは、一致するものが見つかった場合は 0、一致しない場合は 1、エラーがあった場合は 2 です。 -E または -# が指定されていない場合は、完全一致のみが選択されます。

PATTERN は、TRE 拡張を備えた POSIX 拡張正規表現 (ERE) です。

バグの報告

バグを TRE メーリングリスト <tre-general@lists.laurikari.net> に報告してください。