array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'regexp.reference.alternation.php', 1 => 'Alternation', 2 => 'Alternation', ), 'up' => array ( 0 => 'reference.pcre.pattern.syntax.php', 1 => 'PCRE regex syntax', ), 'prev' => array ( 0 => 'regexp.reference.character-classes.php', 1 => 'Character classes', ), 'next' => array ( 0 => 'regexp.reference.internal-options.php', 1 => 'Internal option setting', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/pcre/pattern.syntax.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Alternation

Vertical bar characters are used to separate alternative patterns. For example, the pattern gilbert|sullivan matches either "gilbert" or "sullivan". Any number of alternatives may appear, and an empty alternative is permitted (matching the empty string). The matching process tries each alternative in turn, from left to right, and the first one that succeeds is used. If the alternatives are within a subpattern (defined below), "succeeds" means matching the rest of the main pattern as well as the alternative in the subpattern.

It is possible to record which alternative was matched by using (*MARK:NAME) or (*:NAME). Any number of such (*MARK) verbs may appear and their names do not have to be unique. When a match succeeds, the name of the last-encountered (*MARK:NAME) will be placed among matches as if it were a capture group called MARK so it can be read from the matches of preg_match() and will be passed to the callback of preg_replace_callback() etc.