<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/reference.pcre.pattern.syntax.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'regexp.reference.alternation.php',
    1 => '可选路径(|)',
    2 => '可选路径(|)',
  ),
  'up' => 
  array (
    0 => 'reference.pcre.pattern.syntax.php',
    1 => 'PCRE 正则语法',
  ),
  'prev' => 
  array (
    0 => 'regexp.reference.character-classes.php',
    1 => '字符类(方括号)',
  ),
  'next' => 
  array (
    0 => 'regexp.reference.internal-options.php',
    1 => '内部选项设置',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/pcre/pattern.syntax.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="regexp.reference.alternation" class="section">
  <h2 class="title">可选路径(|)</h2>
  <p class="para">
  竖线字符用于分离模式中的可选路径。
  比如模式<code class="literal">gilbert|Sullivan</code>匹配 ”gilbert” 或者 ”sullivan”。
  竖线可以在模式中出现任意多个，并且允许有空的可选路径(匹配空字符串)。
  匹配的处理从左到右尝试每一个可选路径，并且使用第一个成功匹配的。
  如果可选路径在子组(下面定义)中，
  则”成功匹配”表示同时匹配了子模式中的分支以及主模式中的其他部分。
  </p>
  <p class="para">
   可以通过使用 <code class="literal">(*MARK:NAME)</code> 或 <code class="literal">(*:NAME)</code> 记录匹配到的是哪个可选分支。
   可以出现任意数量的 <code class="literal">(*MARK)</code> 动词，并且它们的名称不必唯一。
   当匹配成功时，最后遇到的 <code class="literal">(*MARK:NAME)</code> 的名称会作为名为
   <code class="literal">MARK</code> 的捕获组出现在匹配结果中，因此可以从
   <span class="function"><a href="function.preg-match.php" class="function">preg_match()</a></span> 的 <code class="parameter">matches</code> 读取，
   也会传递给 <span class="function"><a href="function.preg-replace-callback.php" class="function">preg_replace_callback()</a></span> 的 <code class="parameter">callback</code> 等。
  </p>
 </div><?php manual_footer($setup); ?>