<?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 => 'ru',
  ),
  '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' => 'ru',
    '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> —
      каждое вхождение первой подмаски в круглых скобках и т. д.
      Этот флаг указывают только при вызове функции <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> — второй набор вхождений и т. д.
      Этот флаг указывают только при вызове функции <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> включать несовпадающие подмаски
      в переменной <var class="varname">$matches</var> в виде значений <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>. Без этого флага
      несовпадающие подмаски отображаются как пустые строки, как если бы функция
      не нашла совпадений.
      Установка этого флага разрешает проводить различие между двумя этими случаями.
     </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>
      Возвращается функцией <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span>,
      если возникла внутренняя ошибка модуля PCRE.
     </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>
      Возвращается функцией <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span>,
      если исчерпался <a href="pcre.configuration.php#ini.pcre.backtrack-limit" class="link">лимит обратных ссылок</a>.
     </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>
      Возвращается функцией <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span>,
      если исчерпался <a href="pcre.configuration.php#ini.pcre.recursion-limit" class="link">лимит рекурсии</a>.
     </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>
      Возвращается функцией <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span>,
      если последнюю ошибку вызвали неправильные UTF-8-данные
      (только при запуске регулярного выражения <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>
      Возвращается функцией <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span>,
      если смещение не соответствует началу допустимой кодовой точки
      кодировки UTF-8 (только при запуске <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>
      Возвращается функцией <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span>, если последняя
      функция модуля PCRE завершилась неудачно из-за лимита JIT-стека.
     </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); ?>