<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.pcre.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'pcre.constants.php',
    1 => '预定义常量',
    2 => '预定义常量',
  ),
  'up' => 
  array (
    0 => 'book.pcre.php',
    1 => 'PCRE',
  ),
  'prev' => 
  array (
    0 => 'pcre.configuration.php',
    1 => '运行时配置',
  ),
  'next' => 
  array (
    0 => 'pcre.examples.php',
    1 => '示例',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/pcre/constants.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="pcre.constants" class="appendix">
 <h1 class="title">预定义常量</h1>

 <p class="simpara">下列常量由此扩展定义，且仅在此扩展编译入 PHP 或在运行时动态载入时可用。</p>
 <table class="doctable table">
  <caption><strong>PREG 常量</strong></caption>
  
   <thead>
    <tr>
     <th>常量</th>
     <th>说明</th>
     <th>开始可用的版本</th>
    </tr>

   </thead>

   <tbody class="tbody">
    <tr id="constant.preg-pattern-order">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-pattern-order">PREG_PATTERN_ORDER</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      对结果进行排序，以便 <var class="varname">$matches[0]</var> 是完整模式匹配的数组，<var class="varname">$matches[1]</var>
      是第一个括号子模式匹配的字符串数组，以此类推。此 flag 仅与 <span class="function"><a href="function.preg-match-all.php" class="function">preg_match_all()</a></span> 一起使用。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-set-order">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-set-order">PREG_SET_ORDER</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      对结果进行排序，以便 <var class="varname">$matches[0]</var> 是第一组匹配的数组，<var class="varname">$matches[1]</var>
      是第二组匹配的数组，以此类推。此 flag 仅与 <span class="function"><a href="function.preg-match-all.php" class="function">preg_match_all()</a></span> 一起使用。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-offset-capture">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-offset-capture">PREG_OFFSET_CAPTURE</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      如果设置了此 flag，则对于每次发生的匹配，还将附带返回字节偏移量。注意，这会改变返回数组中的值，
      每个元素都是由匹配子串作为第 0 个元素，它相对目标字符串的偏移量作为第 1 个元素的数组。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-split-no-empty">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-split-no-empty">PREG_SPLIT_NO_EMPTY</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
     这个 flag 告诉 <span class="function"><a href="function.preg-split.php" class="function">preg_split()</a></span> 仅返回非空部分。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-split-delim-capture">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-split-delim-capture">PREG_SPLIT_DELIM_CAPTURE</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      这个 flag 告诉 <span class="function"><a href="function.preg-split.php" class="function">preg_split()</a></span> 也捕获分隔符模式中带括号的表达式。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-split-offset-capture">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-split-offset-capture">PREG_SPLIT_OFFSET_CAPTURE</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      查看 <strong><code><a href="pcre.constants.php#constant.preg-offset-capture">PREG_OFFSET_CAPTURE</a></code></strong> 的描述。该
      flag 只能用于 <span class="function"><a href="function.preg-split.php" class="function">preg_split()</a></span>。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-unmatched-as-null">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-unmatched-as-null">PREG_UNMATCHED_AS_NULL</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      此 flag 告诉 <span class="function"><a href="function.preg-match.php" class="function">preg_match()</a></span> 和 <span class="function"><a href="function.preg-match-all.php" class="function">preg_match_all()</a></span>
      在 <var class="varname">$matches</var> 将包含的未匹配子模式作为 <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> 值。没有此
      flag，未匹配的子模式将报告为空字符串，就像是空匹配一样。设置此 flag 可以区分这两种情况。
     </td>
     <td>7.2.0</td>
    </tr>

    <tr id="constant.preg-no-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-no-error">PREG_NO_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
     如果没有错误，则由 <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> 返回。
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-internal-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-internal-error">PREG_INTERNAL_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      如果有 PCRE 内部错误，则由 <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> 返回。
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-backtrack-limit-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-backtrack-limit-error">PREG_BACKTRACK_LIMIT_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      如果超出了<a href="pcre.configuration.php#ini.pcre.backtrack-limit" class="link">回溯限制</a>，则由 <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> 返回。
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-recursion-limit-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-recursion-limit-error">PREG_RECURSION_LIMIT_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      如果超出了<a href="pcre.configuration.php#ini.pcre.recursion-limit" class="link">递归限制</a>，则由 <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> 返回。
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-bad-utf8-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-bad-utf8-error">PREG_BAD_UTF8_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      如果最后一个错误是由格式错误的 UTF-8 数据引起的（仅在 <a href="reference.pcre.pattern.modifiers.php" class="link">UTF-8
      模式</a>下运行正则表达式时），则由 <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> 返回。
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-bad-utf8-offset-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-bad-utf8-offset-error">PREG_BAD_UTF8_OFFSET_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      如果偏移量不对应可用的 UTF-8 开始码位（仅在 <a href="reference.pcre.pattern.modifiers.php" class="link">UTF-8
      模式</a>下运行正则表达式时），则由 <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> 返回。
     </td>
     <td>5.3.0</td>
    </tr>

    <tr id="constant.preg-jit-stacklimit-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-jit-stacklimit-error">PREG_JIT_STACKLIMIT_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      当最后一个 PCRE 函数因 JIT 栈空间限制而失败，则由 <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> 返回。
     </td>
     <td>7.0.0</td>
    </tr>

    <tr id="constant.pcre-version">
     <td>
      <strong><code><a href="pcre.constants.php#constant.pcre-version">PCRE_VERSION</a></code></strong>
      (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
     </td>
     <td>
      PCRE 版本号和发布日期（比如：“<code class="literal">7.0 18-Dec-2006</code>”）。
     </td>
     <td>5.2.4</td>
    </tr>

    <tr id="constant.pcre-version-major">
     <td>
      <strong><code><a href="pcre.constants.php#constant.pcre-version-major">PCRE_VERSION_MAJOR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      PCRE 主版本号。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.pcre-version-minor">
     <td>
      <strong><code><a href="pcre.constants.php#constant.pcre-version-minor">PCRE_VERSION_MINOR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      PCRE 次版本号。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.pcre-jit-support">
     <td>
      <strong><code><a href="pcre.constants.php#constant.pcre-jit-support">PCRE_JIT_SUPPORT</a></code></strong>
      (<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>)
     </td>
     <td>
      指示 PCRE JIT 支持是否可用。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-grep-invert">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-grep-invert">PREG_GREP_INVERT</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      返回与指定模式不匹配的元素。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

   </tbody>
  
 </table>

</div>
<?php manual_footer($setup); ?>