| 11 |
grep commands do, but it uses the PCRE regular expression library to support |
grep commands do, but it uses the PCRE regular expression library to support |
| 12 |
patterns that are compatible with the regular expressions of Perl 5. See |
patterns that are compatible with the regular expressions of Perl 5. See |
| 13 |
.\" HREF |
.\" HREF |
| 14 |
\fBpcrepattern\fP |
\fBpcrepattern\fP(3) |
| 15 |
.\" |
.\" |
| 16 |
for a full description of syntax and semantics of the regular expressions that |
for a full description of syntax and semantics of the regular expressions |
| 17 |
PCRE supports. |
that PCRE supports. |
| 18 |
.P |
.P |
| 19 |
Patterns, whether supplied on the command line or in a separate file, are given |
Patterns, whether supplied on the command line or in a separate file, are given |
| 20 |
without delimiters. For example: |
without delimiters. For example: |
| 220 |
are guaranteed to be available for lookbehind assertions. |
are guaranteed to be available for lookbehind assertions. |
| 221 |
.TP |
.TP |
| 222 |
\fB-N\fP \fInewline-type\fP, \fB--newline=\fP\fInewline-type\fP |
\fB-N\fP \fInewline-type\fP, \fB--newline=\fP\fInewline-type\fP |
| 223 |
The PCRE library supports three different character sequences for indicating |
The PCRE library supports four different conventions for indicating |
| 224 |
the ends of lines. They are the single-character sequences CR (carriage return) |
the ends of lines. They are the single-character sequences CR (carriage return) |
| 225 |
and LF (linefeed), and the two-character sequence CR, LF. When the library is |
and LF (linefeed), the two-character sequence CRLF, and an "any" convention, in |
| 226 |
built, a default line-ending sequence is specified. This is normally the |
which any Unicode line ending sequence is assumed to end a line. The Unicode |
| 227 |
standard sequence for the operating system. Unless otherwise specified by this |
sequences are the three just mentioned, plus VT (vertical tab, U+000B), FF |
| 228 |
option, \fBpcregrep\fP uses the default. The possible values for this option |
(formfeed, U+000C), NEL (next line, U+0085), LS (line separator, U+2028), and |
| 229 |
are CR, LF, or CRLF. This makes it possible to use \fBpcregrep\fP on files that |
PS (paragraph separator, U+0029). |
| 230 |
have come from other environments without having to modify their line endings. |
.sp |
| 231 |
If the data that is being scanned does not agree with the convention set by |
When the PCRE library is built, a default line-ending sequence is specified. |
| 232 |
this option, \fBpcregrep\fP may behave in strange ways. |
This is normally the standard sequence for the operating system. Unless |
| 233 |
|
otherwise specified by this option, \fBpcregrep\fP uses the library's default. |
| 234 |
|
The possible values for this option are CR, LF, CRLF, or ANY. This makes it |
| 235 |
|
possible to use \fBpcregrep\fP on files that have come from other environments |
| 236 |
|
without having to modify their line endings. If the data that is being scanned |
| 237 |
|
does not agree with the convention set by this option, \fBpcregrep\fP may |
| 238 |
|
behave in strange ways. |
| 239 |
.TP |
.TP |
| 240 |
\fB-n\fP, \fB--line-number\fP |
\fB-n\fP, \fB--line-number\fP |
| 241 |
Precede each output line by its line number in the file, followed by a colon |
Precede each output line by its line number in the file, followed by a colon |
| 345 |
it has no data. |
it has no data. |
| 346 |
. |
. |
| 347 |
. |
. |
| 348 |
.SH MATCHING ERRORS |
.SH "MATCHING ERRORS" |
| 349 |
.rs |
.rs |
| 350 |
.sp |
.sp |
| 351 |
It is possible to supply a regular expression that takes a very long time to |
It is possible to supply a regular expression that takes a very long time to |
| 367 |
code. |
code. |
| 368 |
. |
. |
| 369 |
. |
. |
| 370 |
|
.SH "SEE ALSO" |
| 371 |
|
.rs |
| 372 |
|
.sp |
| 373 |
|
\fBpcrepattern\fP(3), \fBpcretest\fP(1). |
| 374 |
|
. |
| 375 |
|
. |
| 376 |
.SH AUTHOR |
.SH AUTHOR |
| 377 |
.rs |
.rs |
| 378 |
.sp |
.sp |
| 380 |
.br |
.br |
| 381 |
University Computing Service |
University Computing Service |
| 382 |
.br |
.br |
| 383 |
Cambridge CB2 3QG, England. |
Cambridge CB2 3QH, England. |
| 384 |
.P |
.P |
| 385 |
.in 0 |
.in 0 |
| 386 |
Last updated: 06 June 2006 |
Last updated: 29 November 2006 |
| 387 |
.br |
.br |
| 388 |
Copyright (c) 1997-2006 University of Cambridge. |
Copyright (c) 1997-2006 University of Cambridge. |