php-doc-ru/reference/pcre/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 84a87a7fa91e844c792ba31f12d226bb5b1a57a2 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<appendix xml:id="pcre.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants;
 <table>
  <title>Константы PREG</title>
  <tgroup cols="2">
   <thead>
    <row>
     <entry>Константа</entry>
     <entry>Описание</entry>
     <entry>С версии</entry>
    </row>
   </thead>
   <tbody>
    <row xml:id="constant.preg-pattern-order">
     <entry><constant>PREG_PATTERN_ORDER</constant></entry>
     <entry>
      Меняет порядок элементов в результирующем массиве так, чтобы 
      элемент <varname>$matches[0]</varname> содержал полные
      вхождения шаблона, элемент <varname>$matches[1]</varname> -
      все вхождения первой взятой в круглые скобки подмаски и т.д.
      Только <function>preg_match_all</function> реагирует на
      данный модификатор.
     </entry>
     <entry></entry>
    </row>
    <row xml:id="constant.preg-set-order">
     <entry><constant>PREG_SET_ORDER</constant></entry>
     <entry>
      Меняет порядок элементов в результирующем массиве так, чтобы 
      элемент <varname>$matches[0]</varname> содержал первый набор
      вхождений (полное вхождение, вхождение первой подмаски,
      заключенной в круглые скобки...), аналогично элемент
      <varname>$matches[1]</varname> - второй набор вхождений и т.д.
      Только <function>preg_match_all</function> реагирует на данный модификатор.
     </entry>
     <entry></entry>
    </row>
    <row xml:id="constant.preg-offset-capture">
     <entry><constant>PREG_OFFSET_CAPTURE</constant></entry>
     <entry>
      Смотрите описание флага
      <constant>PREG_SPLIT_OFFSET_CAPTURE</constant>.
     </entry>
     <entry>4.3.0</entry>
    </row>
    <row xml:id="constant.preg-split-no-empty">
     <entry><constant>PREG_SPLIT_NO_EMPTY</constant></entry>
     <entry>
      В случае, если этот флаг указан, функция <function>preg_split</function>
      вернет только непустые подстроки.
     </entry>
     <entry></entry>
    </row>
    <row xml:id="constant.preg-split-delim-capture">
     <entry><constant>PREG_SPLIT_DELIM_CAPTURE</constant></entry>
     <entry>
      В случае, если этот флаг указан, то <function>preg_split</function>
      также возвращает выражение, заключенное в круглые скобки в
      шаблоне разделителя.
     </entry>
     <entry>4.0.5</entry>
    </row>
    <row xml:id="constant.preg-split-offset-capture">
     <entry><constant>PREG_SPLIT_OFFSET_CAPTURE</constant></entry>
     <entry>
      В случае, если этот флаг указан, для каждой найденной подстроки
      будет указана ее позиция в исходной строке. Необходимо помнить,
      что этот флаг меняет формат возвращаемых данных: каждое
      вхождение возвращается в виде массива, в нулевом элементе
      которого содержится найденная подстрока, а в первом - смещение.
      Этот флаг используется только в функции <function>preg_split</function>.
     </entry>
     <entry>4.3.0</entry>
    </row>
    <row xml:id="constant.preg-no-error">
     <entry><constant>PREG_NO_ERROR</constant></entry>
     <entry>
      Возвращается функцией <function>preg_last_error</function>, если ошибок нет.
     </entry>
     <entry>5.2.0</entry>
    </row>
    <row xml:id="constant.preg-internal-error">
     <entry><constant>PREG_INTERNAL_ERROR</constant></entry>
     <entry>
      Возвращается функцией <function>preg_last_error</function> в случае,
      если произошла внутренняя ошибка PCRE.
     </entry>
     <entry>5.2.0</entry>
    </row>
    <row xml:id="constant.preg-backtrack-limit-error">
     <entry><constant>PREG_BACKTRACK_LIMIT_ERROR</constant></entry>
     <entry>
      Возвращается функцией <function>preg_last_error</function> в случае,
      когда <link linkend="ini.pcre.backtrack-limit">лимит обратных ссылок</link>
      был исчерпан.
     </entry>
     <entry>5.2.0</entry>
    </row>
    <row xml:id="constant.preg-recursion-limit-error">
     <entry><constant>PREG_RECURSION_LIMIT_ERROR</constant></entry>
     <entry>
      Возвращается функцией <function>preg_last_error</function> в случае,
      если <link linkend="ini.pcre.recursion-limit">лимит рекурсии</link> был
      исчерпан.
     </entry>
     <entry>5.2.0</entry>
    </row>
    <row xml:id="constant.preg-bad-utf8-error">
     <entry><constant>PREG_BAD_UTF8_ERROR</constant></entry>
     <entry>
      Возвращается функцией <function>preg_last_error</function>, если
      последняя ошибка была вызвана поврежденными данными UTF-8
      (только при запуске в <link linkend="reference.pcre.pattern.modifiers">режиме UTF-8</link>).
     </entry>
     <entry>5.2.0</entry>
    </row>
    <row xml:id="constant.preg-bad-utf8-offset-error">
     <entry><constant>PREG_BAD_UTF8_OFFSET_ERROR</constant></entry>
     <entry>
      Возвращается функцией <function>preg_last_error</function>,
      если смещение не соответствует началу корректной кодовой точки
      UTF-8 (только при запуске в <link linkend="reference.pcre.pattern.modifiers">режиме UTF-8</link>).
     </entry>
     <entry>5.3.0</entry>
    </row>
    <row xml:id="constant.preg-jit-stacklimit-error">
     <entry><constant>PREG_JIT_STACKLIMIT_ERROR</constant></entry>
     <entry>
      Возвращается функцией <function>preg_last_error</function>, если последняя
      функция PCRE завершилась неудачно из-за лимита стека JIT.
     </entry>
     <entry>7.0.0</entry>
    </row>
    <row xml:id="constant.pcre-version">
     <entry><constant>PCRE_VERSION</constant></entry>
     <entry>
      Версия и дата релиза PCRE (например, "<literal>7.0 18-Dec-2006</literal>").
     </entry>
     <entry>5.2.4</entry>
    </row>
   </tbody>
  </tgroup>
 </table>
</appendix>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->