--- embedaddon/pcre/doc/html/pcresyntax.html 2012/02/21 23:05:52 1.1.1.1 +++ embedaddon/pcre/doc/html/pcresyntax.html 2012/02/21 23:50:25 1.1.1.2 @@ -46,8 +46,7 @@ man page, in case the conversion went wrong. The full syntax and semantics of the regular expressions that are supported by PCRE are described in the pcrepattern -documentation. This document contains just a quick-reference summary of the -syntax. +documentation. This document contains a quick-reference summary of the syntax.


QUOTING

@@ -76,7 +75,7 @@ syntax.

   .          any character except newline;
                in dotall mode, any character whatsoever
-  \C         one byte, even in UTF-8 mode (best avoided)
+  \C         one data unit, even in UTF mode (best avoided)
   \d         a decimal digit
   \D         a character that is not a decimal digit
   \h         a horizontal whitespace character
@@ -94,7 +93,7 @@ syntax.
   \X         an extended Unicode sequence
 
In PCRE, by default, \d, \D, \s, \S, \w, and \W recognize only ASCII -characters, even in UTF-8 mode. However, this can be changed by setting the +characters, even in a UTF mode. However, this can be changed by setting the PCRE_UCP option.


GENERAL CATEGORY PROPERTIES FOR \p and \P
@@ -367,7 +366,8 @@ The following are recognized only at the start of a pa newline-setting options with similar syntax:
   (*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 \d etc)
 

@@ -439,6 +439,7 @@ The following act immediately they are reached:
   (*ACCEPT)       force successful match
   (*FAIL)         force backtrack; synonym (*F)
+  (*MARK:NAME)    set name to be passed back; synonym (*:NAME)
 
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 @@ -447,14 +448,18 @@ pattern is not anchored.
   (*COMMIT)       overall failure, no advance of starting point
   (*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:NAME)    equivalent to (*MARK:NAME)(*THEN)
 


NEWLINE CONVENTIONS

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.

   (*CR)           carriage return only
   (*LF)           linefeed only
@@ -466,7 +471,7 @@ These are recognized only at the very start of the pat
 
WHAT \R MATCHES

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.

   (*BSR_ANYCRLF)  CR, LF, or CRLF
   (*BSR_UNICODE)  any Unicode newline sequence
@@ -495,9 +500,9 @@ Cambridge CB2 3QH, England.
 


REVISION

-Last updated: 21 November 2010 +Last updated: 10 January 2012
-Copyright © 1997-2010 University of Cambridge. +Copyright © 1997-2012 University of Cambridge.

Return to the PCRE index page.