<?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 => 'ja',
  ),
  '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' => 'ja',
    '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> は第 1 のキャプチャ用サブパターンにマッチした文字列の配列、
      といったように結果の順序を指定します。
      このフラグは、<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> は 1 回目のマッチングでキャプチャした値の配列、
      <var class="varname">$matches[1]</var> は 2 回目のマッチングでキャプチャした値の配列、
      といったように結果の順序を指定します。
      このフラグは、<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>
      このフラグを設定した場合、各マッチに対応する文字列のオフセットも返されます。
      これにより、戻り値は配列の配列に変わることに注意してください。
      配列のすべての要素が、オフセット 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>
      このフラグは、<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>
      このフラグは、<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> の説明を参照ください。
      このフラグは、<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>
      このフラグは、
      <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> が、
      マッチしなかったサブパターンを <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> として
      <var class="varname">$matches</var> に含むようにします。
      このフラグがないと、マッチしなかったサブパターンは
      空文字列にマッチしたかのように空文字列として報告されます。
      このフラグを設定することで、これらふたつの場合を区別できます。
     </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">backtrack limit</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">recursion limit</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>
      壊れている UTF8 データによって直近のエラーが発生した場合に
      <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> から返されます
      (<a href="reference.pcre.pattern.modifiers.php" class="link">UTF-8 モード</a>
      で正規表現を実行した場合のみ)。
     </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 コードポイントの開始位置に対応しない場合に
      <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> から返されます
      (<a href="reference.pcre.pattern.modifiers.php" class="link">UTF-8 モード</a>
      で正規表現を実行した場合のみ)。
     </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 のバージョンおよびリリース日 (例: &quot;<code class="literal">7.0 18-Dec-2006</code>&quot;)。
     </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); ?>