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. Each line that matches a
49 However, there are options that can change how \fBpcre2grep\fP behaves. For
53 not file names are shown, and the \fB-Z\fP option changes the file name
56 The amount of memory used for buffering files that are being scanned is
63 built; if nothing is specified, the defaults are set to 20KiB and 1MiB
74 each line in the order in which they are defined, except that all the \fB-e\fP
75 patterns are tried before the \fB-f\fP patterns.
77 By default, as soon as one pattern matches a line, no further patterns are
82 different. In this situation, all the patterns are applied to the line. If
96 Patterns that can match an empty string are accepted, but empty string
97 matches are never recognized. An example is the pattern "(super)?(man)?", in
98 which all components are optional. This pattern finds all occurrences of both
100 the matching substrings are being shown.
114 \fB--help\fP option. If the appropriate support is not present, all files are
128 option for a means of changing the way binary files are handled.
134 Patterns passed from the command line are strings that are terminated by a
135 binary zero, so cannot contain internal zeros. However, patterns that are read
156 lines are output if the next match or the end of the file is reached, or if the
158 numbers are being output, a hyphen separator is used instead of a colon for the
161 of lines, unless they are in fact contiguous in the input file. The value of
176 lines are output if the previous match or the start of the file is within
178 file names and/or line numbers are being output, a hyphen separator is used
181 output between each group of lines, unless they are in fact contiguous in the
186 Specify how binary files are to be processed. If the word is "binary" (the
189 which is equivalent to the \fB-a\fP or \fB--text\fP option, binary files are
193 \fB-I\fP option, binary files are not processed at all; they are assumed not to
194 be of interest and are skipped without causing any output or affecting the
199 processing for buffering files that are being scanned. See also
207 Do not output lines from the files that are being scanned; instead output the
214 If no lines are selected, the number zero is output. If several files are are
218 are greater than zero are listed. When \fB-c\fP is used, the \fB-A\fP,
219 \fB-B\fP, and \fB-C\fP options are ignored.
233 More resources are used when colouring is enabled, because \fBpcre2grep\fP has
239 PCREGREP_COLOR, which are checked in that order. If none of these are set,
256 it is to be processed. Valid values are "read" (the default) or "skip"
261 Valid values are "read" (the default in non-Windows environments, for
264 "read" case, directories are read as if they were ordinary files. In some
275 pattern is taken from the command line; all arguments are treated as file
276 names. There is no limit to the number of patterns. They are applied to each
277 line in the order in which they are defined.
279 If \fB-f\fP is used with \fB-e\fP, the command line patterns are matched first,
281 these options are specified.
284 Files (but not directories) whose names match the pattern are skipped without
302 Directories whose names match the pattern are skipped without being processed,
319 strings are found in it (subject to \fB-w\fP or \fB-x\fP, if present). This
320 option applies only to the patterns that are matched against the contents of
329 removed from each line, and blank lines are ignored. An empty file contains no
331 may contain binary zeros, which are treated as ordinary data characters.
333 If this option is given more than once, all the specified files are read. A
336 specified on the command line using \fB-e\fP may also be present; they are
338 command line; all arguments are treated as the names of paths to be searched.
341 Read a list of files and/or directories that are to be scanned from the given
344 blank lines are ignored. These paths are processed before any that are listed
346 input. If \fB--file\fP and \fB--file-list\fP are both specified as "-",
347 patterns are read first. This is useful only when the standard input is a
350 specified files are read.
356 \fB-A\fP, \fB-B\fP, and \fB-C\fP options are ignored. If there is more than one
371 Suppress the output file names when searching multiple files. File names are
372 normally shown when multiple files are searched. By default, for matching
394 If any \fB--include\fP patterns are specified, the only files that are
395 processed are those whose names match one of the patterns and do not match an
409 may be given any number of times; all the files are read.
412 If any \fB--include-dir\fP patterns are specified, the only directories that
413 are processed are those whose names match one of the patterns and do not match
426 they are separated by zero bytes instead of newlines. This option overrides any
432 a separate line, but if the \fB-Z\fP option is set, they are separated by zero
436 have at least one match are listed along with their counts. Using this option
462 offset and length are separated by a comma. In this mode, \fB--colour\fP has no
464 options are ignored. If there is more than one match in a line, each of them is
483 If \fB-v\fP is set, none of the lines in a multi-line match are output. Once a
505 lines if \fB-v\fP is also set. Any trailing context lines are output after the
516 memory. There are three options that set resource limits for matching.
519 usage when processing patterns that are not going to match, but which have a
535 There are no short forms for these options. The default limits can be set
536 when the PCRE2 library is compiled; if they are not specified, the defaults
545 Six different conventions for indicating the ends of lines in scanned files are
551 newline type is NUL, lines are separated by binary zero characters. The other
552 types are the single-character sequences CR (carriage return) and LF
569 \fB--include-from\fP options, which are expected to use the operating system's
590 That is, the \fB-A\fP, \fB-B\fP, and \fB-C\fP options are ignored. The
609 given octal number. In the first form, up to three octal digits are processed.
610 When more digits are needed in Unicode mode to specify a wide character, the
614 given hexadecimal number. In the first form, up to two hexadecimal digits are
615 processed. When more digits are needed in Unicode mode to specify a wide
624 \fB-C\fP options are ignored. If there is more than one match in a line, each
629 name or line number are being printed, in which case they are shown on an
635 given number. Up to 50 capturing parentheses are supported by default. This
646 set in the match, nothing is output unless the file name or line number are
649 If this option is given multiple times, multiple substrings are output for each
650 match, in the order the options are given, and all on one line. For example,
661 is an empty string. Separating strings are never coloured.
679 Suppress error messages about non-existent or unreadable files. Such files are
689 is listed. If file names are being output, the grand total is preceded by
697 \fB--include\fP options) and all lines that are scanned must be valid strings
720 the patterns are the ones that are found. When this option is set, options such
722 that are to be output, are ignored.
728 option applies only to the patterns that are matched against the contents of
736 pattern and ")$" at the end. This option applies only to the patterns that are
750 The environment variables \fBLC_ALL\fP and \fBLC_CTYPE\fP are examined, in that
761 way scanned files are processed. It does not affect the interpretation of files
765 Any parts of the scanned input files that are written to the standard output
775 ends of output lines that are copied from the input is not converted to
784 Many of the short and long forms of \fBpcre2grep\fP's options are the same
792 options are specific to \fBpcre2grep\fP, as is the use of the
795 Although most of the common options work the same way, a few are different in
798 \fB-c\fP and \fB-l\fP options are given, GNU grep lists only file names,
805 There are four different ways in which an option with data can be specified.
828 The exceptions to the above are the \fB--colour\fP (or \fB--color\fP) and
842 completely disabled, all callouts in patterns are ignored by \fBpcre2grep\fP.
844 supported, and callouts that request it are ignored.
851 documentation for details). Numbered callouts are ignored by \fBpcre2grep\fP;
852 only callouts with string arguments are useful.
885 \fBfork()\fP and \fBexecv()\fP are available.
895 started by a dollar character. These are the same as for the \fB--output\fP
931 there are more than 20 such errors, \fBpcre2grep\fP gives up.
934 overall resource limit. There are also other limits that affect the amount of