106 lines
3.5 KiB
HTML
106 lines
3.5 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>pcregrep specification</TITLE>
|
|
</HEAD>
|
|
<body bgcolor="#FFFFFF" text="#00005A">
|
|
<H1>pcregrep specification</H1>
|
|
This HTML document has been generated automatically from the original man page.
|
|
If there is any nonsense in it, please consult the man page in case the
|
|
conversion went wrong.
|
|
<UL>
|
|
<LI><A NAME="TOC1" HREF="#SEC1">NAME</A>
|
|
<LI><A NAME="TOC2" HREF="#SEC2">SYNOPSIS</A>
|
|
<LI><A NAME="TOC3" HREF="#SEC3">DESCRIPTION</A>
|
|
<LI><A NAME="TOC4" HREF="#SEC4">OPTIONS</A>
|
|
<LI><A NAME="TOC5" HREF="#SEC5">SEE ALSO</A>
|
|
<LI><A NAME="TOC6" HREF="#SEC6">DIAGNOSTICS</A>
|
|
<LI><A NAME="TOC7" HREF="#SEC7">AUTHOR</A>
|
|
</UL>
|
|
<LI><A NAME="SEC1" HREF="#TOC1">NAME</A>
|
|
<P>
|
|
pcregrep - a grep with Perl-compatible regular expressions.
|
|
</P>
|
|
<LI><A NAME="SEC2" HREF="#TOC1">SYNOPSIS</A>
|
|
<P>
|
|
<B>pcregrep [-Vchilnsvx] pattern [file] ...</B>
|
|
</P>
|
|
<LI><A NAME="SEC3" HREF="#TOC1">DESCRIPTION</A>
|
|
<P>
|
|
<B>pcregrep</B> searches files for character patterns, in the same way as other
|
|
grep commands do, but it uses the PCRE regular expression library to support
|
|
patterns that are compatible with the regular expressions of Perl 5. See
|
|
<B>pcre(3)</B> for a full description of syntax and semantics.
|
|
</P>
|
|
<P>
|
|
If no files are specified, <B>pcregrep</B> 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 <B>pcregrep</B> behaves.
|
|
</P>
|
|
<P>
|
|
Lines are limited to BUFSIZ characters. BUFSIZ is defined in <B><stdio.h></B>.
|
|
The newline character is removed from the end of each line before it is matched
|
|
against the pattern.
|
|
</P>
|
|
<LI><A NAME="SEC4" HREF="#TOC1">OPTIONS</A>
|
|
<P>
|
|
<B>-V</B>
|
|
Write the version number of the PCRE library being used to the standard error
|
|
stream.
|
|
</P>
|
|
<P>
|
|
<B>-c</B>
|
|
Do not print individual lines; instead just print a count of the number of
|
|
lines that would otherwise have been printed. If several files are given, a
|
|
count is printed for each of them.
|
|
</P>
|
|
<P>
|
|
<B>-h</B>
|
|
Suppress printing of filenames when searching multiple files.
|
|
</P>
|
|
<P>
|
|
<B>-i</B>
|
|
Ignore upper/lower case distinctions during comparisons.
|
|
</P>
|
|
<P>
|
|
<B>-l</B>
|
|
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.
|
|
</P>
|
|
<P>
|
|
<B>-n</B>
|
|
Precede each line by its line number in the file.
|
|
</P>
|
|
<P>
|
|
<B>-s</B>
|
|
Work silently, that is, display nothing except error messages.
|
|
The exit status indicates whether any matches were found.
|
|
</P>
|
|
<P>
|
|
<B>-v</B>
|
|
Invert the sense of the match, so that lines which do <I>not</I> match the
|
|
pattern are now the ones that are found.
|
|
</P>
|
|
<P>
|
|
<B>-x</B>
|
|
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.
|
|
</P>
|
|
<LI><A NAME="SEC5" HREF="#TOC1">SEE ALSO</A>
|
|
<P>
|
|
<B>pcre(3)</B>, Perl 5 documentation
|
|
</P>
|
|
<LI><A NAME="SEC6" HREF="#TOC1">DIAGNOSTICS</A>
|
|
<P>
|
|
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).
|
|
</P>
|
|
<LI><A NAME="SEC7" HREF="#TOC1">AUTHOR</A>
|
|
<P>
|
|
Philip Hazel <ph10@cam.ac.uk>
|
|
<BR>
|
|
Copyright (c) 1997-2000 University of Cambridge.
|