Lines Matching full:are
12 patterns that are compatible with the regular expressions of Perl 5. See
23 Patterns, whether supplied on the command line or in a separate file, are given
29 slashes, as is common in Perl scripts), they are interpreted as part of the
31 because they are interpreted by the shell, and indeed quotes are required if a
36 Conversely, when one or both of these options are used to specify patterns, all
37 arguments are treated as path names. At least one of \fB-e\fP, \fB-f\fP, or an
40 If no files are specified, \fBpcre2grep\fP reads the standard input. The
46 By default, input files are searched line by line, so pattern assertions about
50 output at the start of each line, followed by a colon. However, there are
54 The \fB-h\fP and \fB-H\fP options control whether or not file names are shown,
57 The amount of memory used for buffering files that are being scanned is
64 built; if nothing is specified, the defaults are set to 20KiB and 1MiB
78 each line in the order in which they are defined, except that all the \fB-e\fP
79 patterns are tried before the \fB-f\fP patterns.
81 By default, as soon as one pattern matches a line, no further patterns are
86 different. In this situation, all the patterns are applied to the line. If
100 Patterns that can match an empty string are accepted, but empty string
101 matches are never recognized. An example is the pattern "(super)?(man)?", in
102 which all components are optional. This pattern finds all occurrences of both
104 the matching substrings are being shown.
118 \fB--help\fP option. If the appropriate support is not present, all files are
132 option for a means of changing the way binary files are handled.
138 Patterns passed from the command line are strings that are terminated by a
139 binary zero, so cannot contain internal zeros. However, patterns that are read
160 lines are output if the next match or the end of the file is reached, or if the
162 numbers are being output, a hyphen separator is used instead of a colon for the
165 of lines, unless they are in fact contiguous in the input file. The value of
180 lines are output if the previous match or the start of the file is within
182 file names and/or line numbers are being output, a hyphen separator is used
185 output between each group of lines, unless they are in fact contiguous in the
190 Specify how binary files are to be processed. If the word is "binary" (the
193 which is equivalent to the \fB-a\fP or \fB--text\fP option, binary files are
197 \fB-I\fP option, binary files are not processed at all; they are assumed not to
198 be of interest and are skipped without causing any output or affecting the
203 processing for buffering files that are being scanned. See also
211 Do not output lines from the files that are being scanned; instead output the
218 If no lines are selected, the number zero is output. If several files are
222 are greater than zero are listed. When \fB-c\fP is used, the \fB-A\fP,
223 \fB-B\fP, and \fB-C\fP options are ignored.
237 More resources are used when colouring is enabled, because \fBpcre2grep\fP has
243 PCREGREP_COLOR, which are checked in that order. If none of these are set,
260 it is to be processed. Valid values are "read" (the default) or "skip"
265 Valid values are "read" (the default in non-Windows environments, for
268 "read" case, directories are read as if they were ordinary files. In some
276 When case distinctions are being ignored in Unicode mode, two ASCII letters (K
279 this option is set, case equivalences are restricted such that no ASCII
286 pattern is taken from the command line; all arguments are treated as file
287 names. There is no limit to the number of patterns. They are applied to each
288 line in the order in which they are defined.
290 If \fB-f\fP is used with \fB-e\fP, the command line patterns are matched first,
292 these options are specified.
295 Files (but not directories) whose names match the pattern are skipped without
313 Directories whose names match the pattern are skipped without being processed,
330 strings are found in it (subject to \fB-w\fP or \fB-x\fP, if present). This
331 option applies only to the patterns that are matched against the contents of
340 removed from each line, and blank lines are ignored. An empty file contains no
342 may contain binary zeros, which are treated as ordinary data characters.
344 If this option is given more than once, all the specified files are read. A
347 specified on the command line using \fB-e\fP may also be present; they are
349 command line; all arguments are treated as the names of paths to be searched.
352 Read a list of files and/or directories that are to be scanned from the given
355 blank lines are ignored. These paths are processed before any that are listed
357 input. If \fB--file\fP and \fB--file-list\fP are both specified as "-",
358 patterns are read first. This is useful only when the standard input is a
361 specified files are read.
367 \fB-A\fP, \fB-B\fP, and \fB-C\fP options are ignored. If there is more than one
386 Suppress the output file names when searching multiple files. File names are
387 normally shown when multiple files are searched. By default, for matching
411 If any \fB--include\fP patterns are specified, the only files that are
412 processed are those whose names match one of the patterns and do not match an
426 may be given any number of times; all the files are read.
429 If any \fB--include-dir\fP patterns are specified, the only directories that
430 are processed are those whose names match one of the patterns and do not match
443 they are separated by zero bytes instead of newlines. This option overrides any
449 a separate line, but if the \fB-Z\fP option is set, they are separated by zero
453 have at least one match are listed along with their counts. Using this option
479 offset and length are separated by a comma. In this mode, \fB--colour\fP has no
481 options are ignored. If there is more than one match in a line, each of them is
507 multi-line match are output. Once a match has been handled, scanning restarts
530 lines if \fB-v\fP is also set. Any trailing context lines are output after the
541 memory. There are three options that set resource limits for matching.
544 usage when processing patterns that are not going to match, but which have a
560 There are no short forms for these options. The default limits can be set
561 when the PCRE2 library is compiled; if they are not specified, the defaults
570 Six different conventions for indicating the ends of lines in scanned files are
576 newline type is NUL, lines are separated by binary zero characters. The other
577 types are the single-character sequences CR (carriage return) and LF
594 \fB--include-from\fP options, which are expected to use the operating system's
620 That is, the \fB-A\fP, \fB-B\fP, and \fB-C\fP options are ignored. The
639 given octal number. In the first form, up to three octal digits are processed.
640 When more digits are needed in Unicode mode to specify a wide character, the
644 given hexadecimal number. In the first form, up to two hexadecimal digits are
645 processed. When more digits are needed in Unicode mode to specify a wide
654 \fB-C\fP options are ignored. If there is more than one match in a line, each
659 name or line number are being printed, in which case they are shown on an
665 given number. Up to 50 capturing parentheses are supported by default. This
676 set in the match, nothing is output unless the file name or line number are
679 If this option is given multiple times, multiple substrings are output for each
680 match, in the order the options are given, and all on one line. For example,
691 is an empty string. Separating strings are never coloured.
699 as was the case in earlier releases. Note that there are now more fine-grained
720 Suppress error messages about non-existent or unreadable files. Such files are
730 is listed. If file names are being output, the grand total is preceded by
738 \fB--exclude\fP and \fB--include\fP options) and all lines that are scanned
761 the patterns are the ones that are found. When this option is set, options such
763 that are to be output, are ignored.
769 option applies only to the patterns that are matched against the contents of
777 pattern and ")$" at the end. This option applies only to the patterns that are
791 The environment variables \fBLC_ALL\fP and \fBLC_CTYPE\fP are examined, in that
802 way scanned files are processed. It does not affect the interpretation of files
806 Any parts of the scanned input files that are written to the standard output
816 ends of output lines that are copied from the input is not converted to
825 Many of the short and long forms of \fBpcre2grep\fP's options are the same as
833 \fB-U\fP, and \fB--utf-allow-invalid\fP options are specific to
837 Although most of the common options work the same way, a few are different in
840 the \fB-i\fP option applies. If both the \fB-c\fP and \fB-l\fP options are
848 There are four different ways in which an option with data can be specified.
871 The exceptions to the above are the \fB--colour\fP (or \fB--color\fP) and
885 completely disabled, all callouts in patterns are ignored by \fBpcre2grep\fP.
887 supported, and callouts that request it are ignored.
894 documentation for details). Numbered callouts are ignored by \fBpcre2grep\fP;
895 only callouts with string arguments are useful.
928 \fBfork()\fP and \fBexecv()\fP are available.
938 started by a dollar character. These are the same as for the \fB--output\fP
974 there are more than 20 such errors, \fBpcre2grep\fP gives up.
977 overall resource limit. There are also other limits that affect the amount of