2000-04-11 17:36:06 +00:00
|
|
|
NAME
|
2001-02-20 22:00:33 +00:00
|
|
|
pcregrep - a grep with Perl-compatible regular expressions.
|
2000-04-11 17:36:06 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
2002-10-15 13:59:58 +00:00
|
|
|
pcregrep [-Vcfhilnrsvx] [pattern] [file1 file2 ...]
|
2000-04-11 17:36:06 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
2001-02-20 22:00:33 +00:00
|
|
|
pcregrep searches files for character patterns, in the same
|
|
|
|
way as other grep commands do, but it uses the PCRE regular
|
2000-04-11 17:36:06 +00:00
|
|
|
expression library to support patterns that are compatible
|
|
|
|
with the regular expressions of Perl 5. See pcre(3) for a
|
|
|
|
full description of syntax and semantics.
|
|
|
|
|
2002-10-15 13:59:58 +00:00
|
|
|
A pattern must be specified on the command line unless the
|
|
|
|
-f option is used (see below).
|
|
|
|
|
2001-02-20 22:00:33 +00:00
|
|
|
If no files are specified, pcregrep reads the standard
|
|
|
|
input. By default, each line that matches the pattern is
|
|
|
|
copied to the standard output, and if there is more than one
|
|
|
|
file, the file name is printed before each line of output.
|
|
|
|
However, there are options that can change how pcregrep
|
|
|
|
behaves.
|
2000-04-11 17:36:06 +00:00
|
|
|
|
|
|
|
Lines are limited to BUFSIZ characters. BUFSIZ is defined in
|
|
|
|
<stdio.h>. The newline character is removed from the end of
|
|
|
|
each line before it is matched against the pattern.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-V Write the version number of the PCRE library being
|
|
|
|
used to the standard error stream.
|
|
|
|
|
|
|
|
-c Do not print individual lines; instead just print
|
|
|
|
a count of the number of lines that would other-
|
|
|
|
wise have been printed. If several files are
|
|
|
|
given, a count is printed for each of them.
|
|
|
|
|
2002-10-15 13:59:58 +00:00
|
|
|
|
|
|
|
|
|
|
|
and
|
|
|
|
-
|
|
|
|
ffilename Read a number of patterns from the file, one per line,
|
|
|
|
match all of them against each line of input. A
|
|
|
|
line is output if any of the patterns match it.
|
|
|
|
When -f is used, no pattern is taken from the com-
|
|
|
|
mand line; all arguments are treated as file
|
|
|
|
names. There is a maximum of 100 patterns. Trail-
|
|
|
|
ing white space is removed, and blank lines are
|
|
|
|
ignored. An empty file contains no patterns and
|
|
|
|
therefore matches nothing.
|
2002-09-14 14:45:35 +00:00
|
|
|
|
2000-04-11 17:36:06 +00:00
|
|
|
-h Suppress printing of filenames when searching mul-
|
|
|
|
tiple files.
|
|
|
|
|
|
|
|
-i Ignore upper/lower case distinctions during com-
|
|
|
|
parisons.
|
|
|
|
|
|
|
|
-l Instead of printing lines from the files, just
|
|
|
|
print the names of the files containing lines that
|
|
|
|
would have been printed. Each file name is printed
|
|
|
|
once, on a separate line.
|
|
|
|
|
|
|
|
-n Precede each line by its line number in the file.
|
|
|
|
|
2002-09-14 14:45:35 +00:00
|
|
|
-r If any file is a directory, recursively scan the
|
|
|
|
files it contains. Without -r a directory is
|
|
|
|
scanned as a normal file.
|
|
|
|
|
2000-04-11 17:36:06 +00:00
|
|
|
-s Work silently, that is, display nothing except
|
|
|
|
error messages. The exit status indicates whether
|
|
|
|
any matches were found.
|
|
|
|
|
|
|
|
-v Invert the sense of the match, so that lines which
|
|
|
|
do not match the pattern are now the ones that are
|
|
|
|
found.
|
|
|
|
|
|
|
|
-x Force the pattern to be anchored (it must start
|
|
|
|
matching at the beginning of the line) and in
|
|
|
|
addition, require it to match the entire line.
|
|
|
|
This is equivalent to having ^ and $ characters at
|
|
|
|
the start and end of each alternative branch in
|
|
|
|
the regular expression.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
pcre(3), Perl 5 documentation
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DIAGNOSTICS
|
|
|
|
Exit status is 0 if any matches were found, 1 if no matches
|
|
|
|
were found, and 2 for syntax errors or inacessible files
|
|
|
|
(even if matches were found).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
AUTHOR
|
|
|
|
Philip Hazel <ph10@cam.ac.uk>
|
|
|
|
|
2002-10-15 13:59:58 +00:00
|
|
|
Last updated: 25 July 2002
|
|
|
|
Copyright (c) 1997-2002 University of Cambridge.
|