p4 grep

概要

パターンに一致するファイル(またはファイルのリビジョン)内の行を出力します。

構文


p4 [g-opts] grep [-a -i -n -s -T] [-v | -l | -L] [-F | -G] [-A num] [-B num] [-C num]
                 -e pattern file[revRange] …

解説

p4 grepコマンドは指定された正規表現に一致する行を探します。

デフォルトでは、p4 grepは最新リビジョンに対して動作します。ファイル引数でリビジョンが指定されている場合、そのリビジョン番号のすべてのファイルが検索されます。ファイル引数でリビジョン範囲が指定されている場合、そのリビジョン範囲によって選択されたファイルだけが検索され、その範囲内で最も上位にあるリビジョンが各ファイルに使用されます。

次の例では、単語全体のすべての一致を検索することができます。 

p4 grep -e "voodoo" //depot/main/myDir/....

オプション

-a

指定された範囲で最も上位のリビジョンだけでなく、範囲内のすべてのリビジョンを検索します。

-A num

一致する行に後続するnum行を表示します。

-B num

一致する行に先行するnum行を表示します。

-C num

出力コンテキストのnum行を表示します。

-e pattern

p4 grepによって使用されるpatternは、UNIXで使用される正規表現に相当します。そのシンタックスはp4 help grepの出力に詳細に明記されます。

-F

パターンを固定文字列として解釈します。

-G

パターンを正規表現として解釈します。

-i

大文字/小文字を区別しないパターンマッチングを実行します。(デフォルトでは、大文字と小文字を区別してマッチングします。)

-L

通常では出力が表示されなかったであろう選択済みの各ファイルの名前を表示して、最初の一致でスキャンは停止します。

-n

ファイルリビジョン番号の後に、一致する行番号を表示します。

-v

一致しない行があるファイルを表示します。

-l

出力が表示されなかったであろう選択済みの各ファイルの名前を表示して、最初の一致でスキャンは停止します。

-s

1行に含まれる文字が4096文字を超える行のあるファイルからのエラーメッセージを抑止します。(p4 grepはデフォルトで、これらのファイルへの処理を停止してエラーを報告します)

-t

バイナリファイルをテキストとして扱います。(デフォルトでは、textタイプのファイルだけがパターンマッチング対象として選択されます。)

g-opts

「“グローバルオプション”」を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか？

ファイル引数にリビジョン範囲を使えるか？

最低限必要なアクセスレベル

適用外

適用外

read

  • デフォルトでは、p4 grepはリビジョンを10000個まで検索します。この制限は構成可能変数dm.grep.maxrevsによって制御されます。