Diff for /embedaddon/pcre/doc/pcresyntax.3 between versions 1.1.1.1 and 1.1.1.3

version 1.1.1.1, 2012/02/21 23:05:52 version 1.1.1.3, 2012/10/09 09:19:17
Line 1 Line 1
.TH PCRESYNTAX 3.TH PCRESYNTAX 3 "10 January 2012" "PCRE 8.30"
 .SH NAME  .SH NAME
 PCRE - Perl-compatible regular expressions  PCRE - Perl-compatible regular expressions
 .SH "PCRE REGULAR EXPRESSION SYNTAX SUMMARY"  .SH "PCRE REGULAR EXPRESSION SYNTAX SUMMARY"
Line 9  PCRE are described in the Line 9  PCRE are described in the
 .\" HREF  .\" HREF
 \fBpcrepattern\fP  \fBpcrepattern\fP
 .\"  .\"
documentation. This document contains just a quick-reference summary of thedocumentation. This document contains a quick-reference summary of the syntax.
syntax. 
 .  .
 .  .
 .SH "QUOTING"  .SH "QUOTING"
Line 26  syntax. Line 25  syntax.
   \ea         alarm, that is, the BEL character (hex 07)    \ea         alarm, that is, the BEL character (hex 07)
   \ecx        "control-x", where x is any ASCII character    \ecx        "control-x", where x is any ASCII character
   \ee         escape (hex 1B)    \ee         escape (hex 1B)
  \ef         formfeed (hex 0C)  \ef         form feed (hex 0C)
   \en         newline (hex 0A)    \en         newline (hex 0A)
   \er         carriage return (hex 0D)    \er         carriage return (hex 0D)
   \et         tab (hex 09)    \et         tab (hex 09)
Line 40  syntax. Line 39  syntax.
 .sp  .sp
   .          any character except newline;    .          any character except newline;
                in dotall mode, any character whatsoever                 in dotall mode, any character whatsoever
  \eC         one byte, even in UTF-8 mode (best avoided)  \eC         one data unit, even in UTF mode (best avoided)
   \ed         a decimal digit    \ed         a decimal digit
   \eD         a character that is not a decimal digit    \eD         a character that is not a decimal digit
  \eh         a horizontal whitespace character  \eh         a horizontal white space character
  \eH         a character that is not a horizontal whitespace character  \eH         a character that is not a horizontal white space character
   \eN         a character that is not a newline    \eN         a character that is not a newline
   \ep{\fIxx\fP}     a character with the \fIxx\fP property    \ep{\fIxx\fP}     a character with the \fIxx\fP property
   \eP{\fIxx\fP}     a character without the \fIxx\fP property    \eP{\fIxx\fP}     a character without the \fIxx\fP property
   \eR         a newline sequence    \eR         a newline sequence
  \es         a whitespace character  \es         a white space character
  \eS         a character that is not a whitespace character  \eS         a character that is not a white space character
  \ev         a vertical whitespace character  \ev         a vertical white space character
  \eV         a character that is not a vertical whitespace character  \eV         a character that is not a vertical white space character
   \ew         a "word" character    \ew         a "word" character
   \eW         a "non-word" character    \eW         a "non-word" character
   \eX         an extended Unicode sequence    \eX         an extended Unicode sequence
 .sp  .sp
 In PCRE, by default, \ed, \eD, \es, \eS, \ew, and \eW recognize only ASCII  In PCRE, by default, \ed, \eD, \es, \eS, \ew, and \eW recognize only ASCII
characters, even in UTF-8 mode. However, this can be changed by setting thecharacters, even in a UTF mode. However, this can be changed by setting the
 PCRE_UCP option.  PCRE_UCP option.
 .  .
 .  .
Line 128  Armenian, Line 127  Armenian,
 Avestan,  Avestan,
 Balinese,  Balinese,
 Bamum,  Bamum,
   Batak,
 Bengali,  Bengali,
 Bopomofo,  Bopomofo,
   Brahmi,
 Braille,  Braille,
 Buginese,  Buginese,
 Buhid,  Buhid,
 Canadian_Aboriginal,  Canadian_Aboriginal,
 Carian,  Carian,
   Chakma,
 Cham,  Cham,
 Cherokee,  Cherokee,
 Common,  Common,
Line 177  Lisu, Line 179  Lisu,
 Lycian,  Lycian,
 Lydian,  Lydian,
 Malayalam,  Malayalam,
   Mandaic,
 Meetei_Mayek,  Meetei_Mayek,
   Meroitic_Cursive,
   Meroitic_Hieroglyphs,
   Miao,
 Mongolian,  Mongolian,
 Myanmar,  Myanmar,
 New_Tai_Lue,  New_Tai_Lue,
Line 196  Rejang, Line 202  Rejang,
 Runic,  Runic,
 Samaritan,  Samaritan,
 Saurashtra,  Saurashtra,
   Sharada,
 Shavian,  Shavian,
 Sinhala,  Sinhala,
   Sora_Sompeng,
 Sundanese,  Sundanese,
 Syloti_Nagri,  Syloti_Nagri,
 Syriac,  Syriac,
Line 206  Tagbanwa, Line 214  Tagbanwa,
 Tai_Le,  Tai_Le,
 Tai_Tham,  Tai_Tham,
 Tai_Viet,  Tai_Viet,
   Takri,
 Tamil,  Tamil,
 Telugu,  Telugu,
 Thaana,  Thaana,
Line 236  Yi. Line 245  Yi.
   lower       lower case letter    lower       lower case letter
   print       printing, including space    print       printing, including space
   punct       printing, excluding alphanumeric    punct       printing, excluding alphanumeric
  space       whitespace  space       white space
   upper       upper case letter    upper       upper case letter
   word        same as \ew    word        same as \ew
   xdigit      hexadecimal digit    xdigit      hexadecimal digit
Line 337  The following are recognized only at the start of a pa Line 346  The following are recognized only at the start of a pa
 newline-setting options with similar syntax:  newline-setting options with similar syntax:
 .sp  .sp
   (*NO_START_OPT) no start-match optimization (PCRE_NO_START_OPTIMIZE)    (*NO_START_OPT) no start-match optimization (PCRE_NO_START_OPTIMIZE)
  (*UTF8)         set UTF-8 mode (PCRE_UTF8)  (*UTF8)         set UTF-8 mode: 8-bit library (PCRE_UTF8)
   (*UTF16)        set UTF-16 mode: 16-bit library (PCRE_UTF16)
   (*UCP)          set PCRE_UCP (use Unicode properties for \ed etc)    (*UCP)          set PCRE_UCP (use Unicode properties for \ed etc)
 .  .
 .  .
Line 411  The following act immediately they are reached: Line 421  The following act immediately they are reached:
 .sp  .sp
   (*ACCEPT)       force successful match    (*ACCEPT)       force successful match
   (*FAIL)         force backtrack; synonym (*F)    (*FAIL)         force backtrack; synonym (*F)
     (*MARK:NAME)    set name to be passed back; synonym (*:NAME)
 .sp  .sp
 The following act only when a subsequent match failure causes a backtrack to  The following act only when a subsequent match failure causes a backtrack to
 reach them. They all force a match failure, but they differ in what happens  reach them. They all force a match failure, but they differ in what happens
Line 419  pattern is not anchored. Line 430  pattern is not anchored.
 .sp  .sp
   (*COMMIT)       overall failure, no advance of starting point    (*COMMIT)       overall failure, no advance of starting point
   (*PRUNE)        advance to next starting character    (*PRUNE)        advance to next starting character
  (*SKIP)         advance start to current matching position  (*PRUNE:NAME)   equivalent to (*MARK:NAME)(*PRUNE)
   (*SKIP)         advance to current matching position
   (*SKIP:NAME)    advance to position corresponding to an earlier
                   (*MARK:NAME); if not found, the (*SKIP) is ignored
   (*THEN)         local failure, backtrack to next alternation    (*THEN)         local failure, backtrack to next alternation
     (*THEN:NAME)    equivalent to (*MARK:NAME)(*THEN)
 .  .
 .  .
 .SH "NEWLINE CONVENTIONS"  .SH "NEWLINE CONVENTIONS"
 .rs  .rs
 .sp  .sp
 These are recognized only at the very start of the pattern or after a  These are recognized only at the very start of the pattern or after a
(*BSR_...) or (*UTF8) or (*UCP) option.(*BSR_...), (*UTF8), (*UTF16) or (*UCP) option.
 .sp  .sp
   (*CR)           carriage return only    (*CR)           carriage return only
   (*LF)           linefeed only    (*LF)           linefeed only
Line 440  These are recognized only at the very start of the pat Line 455  These are recognized only at the very start of the pat
 .rs  .rs
 .sp  .sp
 These are recognized only at the very start of the pattern or after a  These are recognized only at the very start of the pattern or after a
(*...) option that sets the newline convention or UTF-8 or UCP mode.(*...) option that sets the newline convention or a UTF or UCP mode.
 .sp  .sp
   (*BSR_ANYCRLF)  CR, LF, or CRLF    (*BSR_ANYCRLF)  CR, LF, or CRLF
   (*BSR_UNICODE)  any Unicode newline sequence    (*BSR_UNICODE)  any Unicode newline sequence
Line 474  Cambridge CB2 3QH, England. Line 489  Cambridge CB2 3QH, England.
 .rs  .rs
 .sp  .sp
 .nf  .nf
Last updated: 21 November 2010Last updated: 10 January 2012
Copyright (c) 1997-2010 University of Cambridge.Copyright (c) 1997-2012 University of Cambridge.
 .fi  .fi

Removed from v.1.1.1.1  
changed lines
  Added in v.1.1.1.3


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>