pcregrep man page on Aros

Man page or keyword search:  
man Server   366 pages
apropos Keyword Search (all sections)
Output format
Aros logo
[printable version]

PCREGREP(1)							   PCREGREP(1)

       pcregrep - a grep with Perl-compatible regular expressions.

       pcregrep [-Vcfhilnrsuvx] [long options] [pattern] [file1 file2 ...]


       pcregrep	 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 pcrepattern for a full description of syntax and  semantics
       of the regular expressions that PCRE supports.

       A pattern must be specified on the command line unless the -f option is
       used (see below).

       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.

       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.


       -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 otherwise have	been  printed.
		 If  several  files  are given, a count is printed for each of

		 Read a number of patterns from the file, one  per  line,  and
		 match	all of them against each line of input. A line is out‐
		 put if any of the patterns match it.  When  -f	 is  used,  no
		 pattern  is  taken  from  the command line; all arguments are
		 treated as file names. There is a maximum  of	100  patterns.
		 Trailing white space is removed, and blank lines are ignored.
		 An empty file contains	 no  patterns  and  therefore  matches

       -h	 Suppress printing of filenames when searching multiple files.

       -i	 Ignore upper/lower case distinctions during comparisons.

       -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.

       -r	 If  any  file	is  a directory, recursively scan the files it
		 contains. Without -r a directory is scanned as a normal file.

       -s	 Work silently, that is, display  nothing  except  error  mes‐
		 sages.	  The  exit  status indicates whether any matches were

       -u	 Operate in UTF-8 mode. This option is available only if  PCRE
		 has  been  compiled  with UTF-8 support. Both the pattern and
		 each subject line are assumed to be valid  strings  of	 UTF-8

       -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.


       Long forms of all the options are available, as in GNU grep.  They  are
       shown in the following table:

	 -c   --count
	 -h   --no-filename
	 -i   --ignore-case
	 -l   --files-with-matches
	 -n   --line-number
	 -r   --recursive
	 -s   --no-messages
	 -u   --utf-8
	 -V   --version
	 -v   --invert-match
	 -x   --line-regex
	 -x   --line-regexp

       In  addition,  --file=filename  is equivalent to -ffilename, and --help
       shows the list of options and then exits.


       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


       Philip Hazel <ph10@cam.ac.uk>
       University Computing Service
       Cambridge CB2 3QG, England.

Last updated: 03 February 2003
Copyright (c) 1997-2003 University of Cambridge.


List of man pages available for Aros

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net