プログラムについての一般情報¶

--help

使用法を出力して終了します。

-V, --version

grep のバージョン番号を出力して終了します。

正規表現の選択¶

-E, --extended-regexp

PATTERN を拡張正規表現 (ERE) として扱います (下記参照)。

-F, --fixed-strings

PATTERN を改行で区切られた固定文字列 (正規表現のかわりに) のリストとして扱い、 その文字列のいずれかとマッチするかどうかを調べます。

-G, --basic-regexp

PATTERN を基本正規表現 (BRE) として扱います (下記参照)。これがデフォルトです。

-P, --perl-regexp

パターンを Perl 互換の正規表現 (PCRE) として扱います。 きわめて実験的なものなので、 grep -P を使うと、その機能は実装されていませんという 警告が出るかもしれません。

マッチングの制御¶

-e PATTERN, --regexp=PATTERN

PATTERN をパターンとして指定します。 このオプションを複数回使ったときや、 -f (--file) オプションと組み合わせたときは、与えられたすべてのパターンを検索します。 このオプションは、ハイフン “-” で始まるパターンを保護するのにも使えます。

-f FILE, --file=FILE

パターンを FILE から 1 行 1 パターンとして読み込みます。 このオプションを複数回使ったときや、 -e (--regexp) オプションと組み合わせたときは、与えられたすべてのパターンを検索します。 空のファイルはパターンを含まないので、何にもマッチしません。

-i, --ignore-case

PATTERN と入力ファイルの双方で、アルファベットの大文字と小文字を 区別しないようにします。

-v, --invert-match

マッチの意味を逆にして、マッチしない行を抜き出して表示します。

-w, --word-regexp

マッチする部分が完全な単語を形成するときにのみ、その行を選択します。 次の条件を検査します。パターンにマッチする部分文字列は、行頭にあるか、 さもなければ、単語構成文字以外の文字の直後になければならない。 また、その部分文字列は、行末にあるか、さもなければ、単語構成文字以外の文字の 直前になければならない (訳注: ここで「完全な単語を形成する」というのは、 それが空白、改行、引用符、句読点などで前後を区切られた文字列だ ということです。たとえば、文字列「A word with you」中の word という 部分文字列は完全な単語ですが、文字列「two words」中の部分文字列 word は 完全な単語を形成しません)。 単語構成文字とは、アルファベット、数字、アンダスコアです (訳注: 実は漢字や仮名も単語構成文字として扱われます)。 このオプションは、 -x が同時に指定されたときには無効になります。

-x, --line-regexp

パターンが行全体とぴったりマッチしたときにのみ、その行を選択します。 正規表現でいうと、これはパターンを括弧で囲み、前後に ^ と $ を付けるようなものです。

-y

-i と同じ意味を持つ旧式のオプションです。

一般的な出力の制御¶

-c, --count

通常の出力はせず、各入力ファイルについてマッチした行数を表示します。 -v, --invert-match オプション (上記参照) と共に指定した場合は、 マッチしなかった行数を表示します。

--color[=WHEN], --colour[=WHEN]

マッチした (空文字列ではない) 文字列、マッチする行、前後の文脈行、 ファイル名、行番号、バイトオフセット、(フィールドや、前後の文脈行を含む グループ同士の) 区切り記号をエスケープ・シーケンスで囲み、ターミナル上に 色付きで表示します。 どの色を使うかは、環境変数 GREP_COLORS で定義します。非推奨の環境変数 GREP_COLOR も、これまでどおり使用できますが、その設定は優先されません。 WHEN は never, always, auto のいづれかです。

-L, --files-without-match

通常の出力はしません。その代わりに、 grep を普通に実行した際に、何の検索結果も表示しないような入力ファイルの名前を 列挙します (訳注: すなわち、-L オプションを指定すると、 -v オプションを同時に指定しない場合は、パターンにマッチする 文字列を含む行がまったく存在しないファイルの名前を列挙するということです)。 個々のファイルに対する走査は、最初のマッチで終了します。

-l, --files-with-matches

通常の出力はしません。その代わりに、 grep を普通に実行した際に、何らかの検索結果を表示するような入力ファイルの名前を 列挙します (訳注: すなわち、-l オプションを指定すると、 -v オプションを同時に指定しない場合は、パターンにマッチする 文字列を含む行が存在するファイルの名前を列挙するということです)。 個々のファイルに対する走査は、最初のマッチで終了します。

-m NUM, --max-count=NUM

マッチした行数が NUM に達したら、ファイルの読み込みを中止します。 入力が通常ファイルから標準入力を介して行われている場合は、マッチした行を NUM 行出力した時点で、 grep は標準入力の読み出し位置を最後にマッチした行の直後に来るようにしてから、 終了します。続いて表示する文脈行がある場合でも、この動作は変わりません。 このことは、 grep を呼び出すプロセスが、中止したところから検索を 再開することを可能にします。 grep はマッチした行数が NUM に達してストップしたとき、それに続く文脈行があれば、それを出力します。 -c や --count オプションを同時に使用した場合、 grep は NUM よりも大きい数を出力しません。 -v や --invert-match を同時に使用した場合は、マッチしない行を NUM 行出力したところで、 grep はストップします。

-o, --only-matching

マッチする行のマッチした部分だけを (それが空文字列でなければ) 表示します。 マッチした各文字列は、それぞれ別の行に書き出します。

-q, --quiet, --silent

沈黙モードです。標準出力に何も書き出しません。 マッチするものが 1 つでも見つかると、エラーを検出していた場合でも、 終了ステータス 0 で即座に終了します。 -s や --no-messages オプションも参照してください。

-s, --no-messages

ファイルが存在しないことや読み込みめないことを示す エラーメッセージを抑止します。

出力する行の前に付ける情報の制御¶

-b, --byte-offset

出力する各行の前に、その入力ファイル内での 0 から始まる バイト単位のオフセットを表示します。 -o (--only-matching) も指定されているときは、マッチする部分そのもののオフセットを示します。

-H, --with-filename

各々のマッチに対してそのファイル名を表示します。 検索するファイルが 2 個以上の場合は、これがデフォルトの動作です。

-h, --no-filename

出力する行の前にファイル名を付けないようにします。 検索するファイルが 1 つしかない (あるいは、標準入力だけだった) 場合は、 これがデフォルトの動作です。

--label=LABEL

実際には標準入力から来た入力を LABEL というファイルから来たもののように見せかけます。 これは zgrep のようなツールを自分で作成する際にとりわけ便利です。たとえば、 gzip -cd foo.gz | grep --label=foo -H something といった具合です。 -H オプションも参照してください。

-n, --line-number

各出力行の前に、その入力ファイル内での 1 から始まる行番号を表示します。

-T, --initial-tab

行の実際の内容をなす最初の文字が、必ずタブ・ストップの位置に 来るようにします。その結果、タブがきちんと揃って見えるようになります。 このオプションは -H,-n,-b といった、実際の内容の前に情報を付加するオプションを使うときに 役に立ちます。 また、このオプションは、 1 つのファイルから抜き出した行の先頭ができるだけ揃うように、 行番号やバイトオフセットがある場合は、そのフィールド幅を 必要最小のサイズにして表示します。

-u, --unix-byte-offsets

Unix 形式のバイトオフセットを報告します。 このスイッチを使うと、 grep は、検索対象のファイルが Unix 形式のテキストファイルであるかのように、 バイトオフセットを報告します。すなわち、CR 文字を切り捨てるのです。 そのため、表示される結果は、Unix マシンで grep を実行したときと同じものになります。 このオプションは、 -b オプションを同時に使用しないかぎり、効果がありません。 また、このオプションは、MS-DOS と MS-Windows 以外の プラットホームでは、何の効果もありません。

-Z, --null

ファイル名に続いて通常出力される文字の代わりに、 値が 0 の 1 バイト (ASCII NUL 文字) を出力します。 たとえば、 grep -lZ は、いつもの改行 (newline) ではなく、値が 0 の 1 バイトを各ファイル名の後ろに 出力するのです。 このオプションは、改行のような変わった文字を含むファイル名があるときでも、 出力の曖昧さをなくしてくれます。 このオプションを find -print0, perl -0, sort -z, xargs -0 などのコマンドと組み合わせて使うと、行儀の悪いファイル名も 処理することができます。 ファイル名が改行文字を含んでいても処理できるのです。

前後の文脈行の制御¶

-A NUM, --after-context=NUM

NUM で指定した行数だけ、パターンにマッチした行の後に続く文脈も表示します。 マッチした行を含むグループ同士の間には、グループを区切る印 (--) からなる行を置きます。 -o や --only-matching と同時に使うと、このオプションは効果がなく、警告メッセージを出します。

-B NUM, --before-context=NUM

NUM で指定した行数だけ、パターンにマッチした行に先行する文脈も表示します。 マッチした行を含むグループ同士の間には、グループを区切る印 (--) からなる行を置きます。 -o や --only-matching と同時に使うと、このオプションは効果がなく、警告メッセージを出します。

-C NUM, -NUM, --context=NUM

NUM で指定した行数だけ、パターンにマッチした行の前後の文脈も表示します。 マッチした行を含むグループ同士の間には、グループを区切る印 (--) からなる行を置きます。 -o や --only-matching と同時に使うと、このオプションは効果がなく、警告メッセージを出します。

ファイルやディレクトリの選択¶

-a, --text

バイナリファイルをテキストファイルであるかのように処理します。 これは --binary-files=text オプションと等価です。

--binary-files=TYPE

ファイルのデータやメタデータが、 ファイルにバイナリデータが含まれていることを示す場合に、 ファイルのタイプを TYPE だと見なします。 テキストではないバイトが見つかれば、バイナリデータです。 テキストではないバイトが、 現在使用しているロケールに不適切にエンコードして出力されたバイトや、 -z オプションが指定されていないときの入力中のヌルバイトだということもあります。

デフォルトでは TYPE は binary であり、 grep はファイルがバイナリだとわかると、 その先の出力を抑制します。そのかわりにバイナリファイルにマッチしたという 1 行のメッセージを表示します。マッチする部分がない場合には何も表示しません。

TYPE が without-match の場合、 grep はファイルがバイナリだとわかると、残りはマッチしないものと仮定します。 これは -I オプションと等価です。

TYPE が text の場合、 grep はバイナリファイルをテキストであるかのように扱います。 これは -a オプションと等価です。

type が binary の場合、 grep は -z がなくてもテキスト以外の文字を行の区切りとして扱う場合があります。 これは、 binary を選ぶか text を選ぶかによって、 パターンがファイルにマッチするかどうかに影響があることを意味します。 たとえば、 type が binary の場合は q$ というパターンが q の直後に NULL 文字が続く箇所にマッチする可能性があるのに対し、 type が text の場合にはマッチしません。 逆に、 type が binary の場合、 . (period) というパターンは NULL 文字にはマッチしないかもしれません。

警告: -a オプションはバイナリのゴミを出力するかもしれません。 出力先が端末であり、しかも 端末ドライバがゴミの一部をコマンドだと解釈する場合には、 このゴミが厄介な副作用を起こす可能性があります。 一方、テキストのエンコーディングが不明なファイルを読み込むとき、 マッチした結果をそのまま表示するのが安全でなくても、 より多くのマッチを探すために、 -a を指定するか、環境変数で LC_ALL='C' を指定するのが役に立つ場合があります。

-D ACTION, --devices=ACTION

入力ファイルがデバイス、FIFO、ソケットのいづれかである場合に、 ACTION を使ってその処理を行います。 デフォルトの ACTION は read です。すなわち、デバイスなどを、それが普通のファイルであるかのように、 読み込みます。 ACTION が skip ならば、デバイスなどを黙ってスキップします。

-d ACTION, --directories=ACTION

入力ファイルがディレクトリの場合に、 ACTION を使ってその処理を行います。デフォルトの ACTION は read です。すなわち、ディレクトリを、それが普通のファイルであるかのように、 読み込みます。 ACTION が skip ならば、ディレクトリを黙ってスキップします。 ACTION が recurse なら、 grep は各ディレクトリの下にあるすべてのファイルを再帰的に読み込みます。 ただし、シンボリックリンクはコマンドラインで指定されたときにのみたどります。 これは -r オプションと等価です。

--exclude=GLOB

コマンドラインで指定されているファイルについては、 その名前の尾部が、 ワイルドカードによるマッチングでパターン GLOB にマッチするファイルをスキップします。 ここで言う「名前の尾部」とは、 ファイル名の全体か、 / の直後に始まり / 以外の文字で終るファイル名の最後の部分のことです。 また、ディレクトリを再帰検索しているときに出会うファイルについては、 ベースネームが GLOB にマッチするファイルをスキップします。 ベースネームとは最後の / より後の部分です。 パターンには、 *, ?, [...] がワイルドカードとして使えます。 \ を文字の前に置けば、 ワイルドカード文字やバックスラッシュ文字を本来の意味で使用できます。

--exclude-from=FILE

ファイル FILE を読み込み、そこに書かれているファイル名 (ワイルドカード可) のどれかに ベースネームがマッチするファイルをスキップします (--exclude の項で説明したワイルドカードのマッチングを使用します)。

--exclude-dir=GLOB

コマンドラインで指定されているディレクトリのうち、 名前の尾部がパターン GLOB にマッチするディレクトリをスキップします。 また、ディレクトリを再帰検索しているときに出会うサブディレクトリについては、 ベースネームが GLOB にマッチするサブディレクトリをスキップします。 GLOB 末尾の余分なスラッシュは無視されます。

-I

バイナリファイルをマッチするデータを含んでいないものとして 処理します。これは --binary-files=without-match オプションと等価です。

--include=GLOB

ベースネームが GLOB にマッチするファイルのみを検索します (--exclude の項で説明したワイルドカードのマッチングを使用します)。

-r, --recursive

各ディレクトリの下にあるすべてのファイルを再帰的に読み込みます。 ただし、シンボリックリンクはコマンドラインで指定されたときにのみたどります。 検索対象のファイルが指定されなかった場合には grep は現在のディレクトリを探すことに注意してください。 これは -d recurse オプションと等価です。

-R, --dereference-recursive

各ディレクトリの下にあるすべてのファイルを再帰的に読み込みます。 -r と異なり、すべてのシンボリックリンクを追跡します。

その他のオプション¶

--line-buffered

行ごとに出力を行います。 実行速度が落ちるかもしれません。

-U, --binary

ファイルをバイナリとして扱います。 MS-DOS や MS-Windows の環境下で、 grep はデフォルトでは、 ファイルがテキストかバイナリかを --binary-files オプションで記述された方法で推測します。 grep はファイルをテキストファイルと判断した場合、オリジナルのファイル内容から (^ や $ を使った正規表現が正しく動作するように) CR 文字を取り除きます。 -U を指定すると、この推測を抑制し、すべてのファイルを読み取って、 そのまま手を加えずにマッチ処理へ渡すのです。もしファイルが 各行の末尾に CR/LF の組み合わせを持つテキストファイルなら、 このオプションのせいで正規表現がうまく働かないことがあるかもしれません。 このオプションは MS-DOS や MS-Windows 以外のプラットフォームでは 効果がありません。

-z, --null-data

入力と出力のデータを、 改行のかわりに、 値が 0 のバイト (ASCII NULL 文字) で区切られた一連の行として扱います。 -Z や --null と同様、このオプションは sort -z などのコマンドと組み合わせて、 行儀の悪いファイル名の処理に使用することができます。

文字クラスと角括弧式 (ブラケット式)¶

角括弧式 とは、 [ と ] で囲まれた文字のリストのことです。 角括弧式 は、リスト中の任意の 1 文字にマッチします。 また、リストの最初の文字がキャレット ^ の場合は、リスト中の文字以外の任意の 1 文字にマッチします。 たとえば、正規表現 [0123456789] は任意の数字 1 個にマッチするわけです。

角括弧式の内側に 範囲式 を置くことができますが、これはハイフンで区切られた 2 つの文字から なっています。範囲式は、現在使用中のロケールにおける照合順序と 文字集合を使ったときに、その 2 文字の間に並ぶ、その 2 文字を含む 任意の 1 文字にマッチします。 たとえば、デフォルトの C ロケールでは、 [a-d] は [abcd] と等価です。 多くのロケールでは文字を辞書式の順序で並べていますが、そうしたロケールで [a-d] が [abcd] と等価でないこともよくあります。 たとえば、 [aBbCcDd] と等価かもしれないのです。 角括弧式を伝統的な意味に解釈させたいなら、 環境変数 LC_ALL の値を C に設定して、C ロケールを使用するとよいでしょう。

最後に、角括弧式内で使えるように、特定の名前を持つ文字クラスが あらかじめ定義されています。 名前が内容を示しており、それは次のようなものです。 [:alnum:], [:alpha:], [:cntrl:], [:digit:], [:graph:], [:lower:], [:print:], [:punct:], [:space:], [:upper:], [:xdigit:]。 たとえば、 [[:alnum:]] は 現在のロケールの文字クラスで数字と文字を意味します。 C ロケールや ASCII 文字集合のエンコーディングの場合、 これは [0-9A-Za-z] と同じです。 (こうしたクラス名に使用されている角括弧は、シンボル名の一部なので、 角括弧式の前後に付く角括弧とは別に指定する必要があることに 注意してください。) 角括弧式の内側では、ほとんどのメタ文字がその特別な意味を 持たなくなります。 ] という記号そのものを角括弧式に含めるには、 それをリストの先頭に置いてください。 同様に、 ^ という記号そのものを含めるには、 それを先頭以外のどこかに置けばよいでしょう。 最後に、 - そのものを含めるには、 それをリストの最後に置きます。

行頭と行末 (アンカリング)¶

キャレット ^ と ドル記号 $ は、それぞれ行頭と行末の空文字列にマッチするメタ文字です。

バックスラッシュ付きの特別な表現¶

シンボル \< とシンボル \> は、それぞれ単語の先頭と末尾の空文字列にマッチするメタ文字です。 シンボル \b は単語の端の空文字列にマッチします。 シンボル \B は単語の端 以外 の空文字列にマッチします。 シンボル \w は [_[:alnum:]] と同じ意味で、 シンボル \W は [^_[:alnum:]] と同じ意味です。

繰り返し¶

正規表現の後には、繰り返し演算子のどれかが続くことがあります。

?

直前の項目があってもなくてもよく、マッチするとしても 1 回だけということ。

*

直前の項目が 0 回以上マッチするということ。

+

直前の項目が 1 回以上マッチするということ。

{n}

直前の項目がちょうど n 回マッチするということ。

{n,}

直前の項目が n 回以上マッチするということ。

{,m}

直前の項目が m 回以下マッチするということ。 これは GNU 拡張です。

{n,m}

直前の項目が n 回以上 m 回以下マッチするということ。

結合¶

2 つの正規表現は結合することができます。 結果としてできあがる正規表現は、 結合対象となる部分表現にそれぞれマッチする 2 つの部分文字列を結合して作られる、どんな文字列にもマッチします。

選択¶

2 つの正規表現は中置き型演算子の | で繋ぐことができます。 結果としてできあがる正規表現は、 どちらかの部分表現にマッチするどんな文字列にもマッチします。

優先順位¶

繰り返しは結合に優先します。また結合は選択に優先します。 表現の 1 つのまとまりを括弧でくくると、その内側の式をこうした優先規則より さらに優先させることができます。 括弧でくくった部分は、1 つの部分表現になるのです。

後方参照と部分表現¶

n が 1 個の数字であるような 後方参照 \n は、正規表現中の括弧で囲まれた n 番目の部分表現が前もってマッチした文字列とマッチします。

基本正規表現と拡張正規表現¶

基本正規表現では、メタ文字 ?, +, {, |, (, ) は、その特殊な意味を失います。バックスラッシュを付けた \?, \+, \{, \|, \(, \) を代わりに使用してください。

バグの報告¶

バグ報告は 宛に E メールで送ってください。 と も用意されています。

既知のバク¶

{n,m} を使って何度も繰り返しを行うと、 grep は大量のメモリを消費するかもしれません。 また、ほかの曖昧な正規表現にも、指数関数的な時間と メモリ空間を要するものがあり、 grep がメモリ不足を起こすことがあります。

後方参照は非常に遅く、とんでもなく時間がかかることがあります。

標準のマニュアルページ¶

awk(1), cmp(1), diff(1), find(1), gzip(1), perl(1), sed(1), sort(1), xargs(1), zgrep(1), read(2), pcre(3), pcresyntax(3), pcrepattern(3), terminfo(5), glob(7), regex(7).

POSIX プログラマーズ・マニュアルページ¶

grep(1p).

完全版の文書¶

が用意されています。 info と grep プログラムが御使用のサイトにきちんとインストールされているならば、

info grep

とコマンドを打ち込むことで、完備したマニュアルが読めるはずです。