Files
php-doc-ru/reference/pcre/constants.xml
2024-07-07 02:33:59 +03:00

262 lines
9.9 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 47551a95525f8e2ecc8f89f623c82c3962b5e4cf Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<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>&Constants;</entry>
<entry>&Description;</entry>
<entry>С версии</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.preg-pattern-order">
<entry>
<constant>PREG_PATTERN_ORDER</constant>
(<type>int</type>)
</entry>
<entry>
Меняет порядок элементов в результирующем массиве так, чтобы
элемент <varname>$matches[0]</varname> содержал полные
вхождения шаблона, элемент <varname>$matches[1]</varname>
каждое вхождение первой подмаски в круглых скобках и т. д.
Этот флаг указывают только при вызове функции <function>preg_match_all</function>.
</entry>
<entry/>
</row>
<row xml:id="constant.preg-set-order">
<entry>
<constant>PREG_SET_ORDER</constant>
(<type>int</type>)
</entry>
<entry>
Меняет порядок элементов в результирующем массиве так, чтобы
элемент <varname>$matches[0]</varname> содержал первый набор
вхождений (полное вхождение, вхождение первой подмаски,
заключённой в круглые скобки...), аналогично элемент
<varname>$matches[1]</varname> — второй набор вхождений и т. д.
Этот флаг указывают только при вызове функции <function>preg_match_all</function>.
</entry>
<entry/>
</row>
<row xml:id="constant.preg-offset-capture">
<entry>
<constant>PREG_OFFSET_CAPTURE</constant>
(<type>int</type>)
</entry>
<entry>
Смотрите описание флага
<constant>PREG_SPLIT_OFFSET_CAPTURE</constant>.
</entry>
<entry/>
</row>
<row xml:id="constant.preg-split-no-empty">
<entry>
<constant>PREG_SPLIT_NO_EMPTY</constant>
(<type>int</type>)
</entry>
<entry>
С этим флагом функция <function>preg_split</function> вернёт только непустые подстроки.
</entry>
<entry/>
</row>
<row xml:id="constant.preg-split-delim-capture">
<entry>
<constant>PREG_SPLIT_DELIM_CAPTURE</constant>
(<type>int</type>)
</entry>
<entry>
С этим флагом функция <function>preg_split</function>
также возвращает выражение, которое
в шаблоне разделителя заключили в круглые скобки.
</entry>
<entry/>
</row>
<row xml:id="constant.preg-split-offset-capture">
<entry>
<constant>PREG_SPLIT_OFFSET_CAPTURE</constant>
(<type>int</type>)
</entry>
<entry>
С этим флагом функция укажет для каждой подстроки, которую нашла, позицию в исходной строке.
Когда указывают этот флаг,
учитывают, что флаг меняет формат данных, которые возвращает функция: каждое
вхождение возвращается как массив, в нулевом элементе
которого содержится найденная подстрока, а в первом — смещение.
Этот флаг указывают только при вызове функции <function>preg_split</function>.
</entry>
<entry/>
</row>
<row xml:id="constant.preg-unmatched-as-null">
<entry>
<constant>PREG_UNMATCHED_AS_NULL</constant>
(<type>int</type>)
</entry>
<entry>
Этот флаг указывает функциям <function>preg_match</function>
и <function>preg_match_all</function> включать несовпадающие подмаски
в переменной <varname>$matches</varname> в виде значений &null;. Без этого флага
несовпадающие подмаски отображаются как пустые строки, как если бы функция
не нашла совпадений.
Установка этого флага разрешает проводить различие между двумя этими случаями.
</entry>
<entry>7.2.0</entry>
</row>
<row xml:id="constant.preg-no-error">
<entry>
<constant>PREG_NO_ERROR</constant>
(<type>int</type>)
</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>
(<type>int</type>)
</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>
(<type>int</type>)
</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>
(<type>int</type>)
</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>
(<type>int</type>)
</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>
(<type>int</type>)
</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>
(<type>int</type>)
</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>
(<type>string</type>)
</entry>
<entry>
Версия и дата релиза модуля PCRE (например, «<literal>7.0 18-Dec-2006</literal>»).
</entry>
<entry>5.2.4</entry>
</row>
<row xml:id="constant.pcre-version-major">
<entry>
<constant>PCRE_VERSION_MAJOR</constant>
(<type>int</type>)
</entry>
<entry>
Номер мажорной версии модуля PCRE.
</entry>
<entry></entry>
</row>
<row xml:id="constant.pcre-version-minor">
<entry>
<constant>PCRE_VERSION_MINOR</constant>
(<type>int</type>)
</entry>
<entry>
Номер минорной версии модуля PCRE.
</entry>
<entry></entry>
</row>
<row xml:id="constant.pcre-jit-support">
<entry>
<constant>PCRE_JIT_SUPPORT</constant>
(<type>bool</type>)
</entry>
<entry>
Указывает, доступна ли для модуля PCRE поддержка JIT-компиляции.
</entry>
<entry></entry>
</row>
<row xml:id="constant.preg-grep-invert">
<entry>
<constant>PREG_GREP_INVERT</constant>
(<type>int</type>)
</entry>
<entry>
Возвращает элементы, которые не соответствуют шаблону.
</entry>
<entry></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
-->