diff --git a/language-snippets.ent b/language-snippets.ent index 023e405c4..24300cb61 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -326,7 +326,7 @@ xmlns="http://docbook.org/ns/docbook">Эта функция Сравнение функций сортировки массивов'> -callback'> +callback'> предопределенные переменные массивов PHP могут быть отключены директивой register_long_arrays.'> diff --git a/reference/pcre/book.xml b/reference/pcre/book.xml index c1724d4ce..4e56b55e6 100644 --- a/reference/pcre/book.xml +++ b/reference/pcre/book.xml @@ -1,6 +1,6 @@ - + @@ -17,17 +17,17 @@ Разделителем могут выступать произвольные символы, кроме буквенно-цифровых, обратного слеша '\' и нулевого байта. Если символ разделителя встречается в шаблоне, его необходимо - экранировать. Начиная с PHP 4.0.4 в качестве разделителя + экранировать. Начиная с PHP 4.0.4, в качестве разделителя доступны комбинации, используемые в Perl: (), {}, [] и <>. Подробней об этом рассказано в разделе - "Синтаксис регулярных выражений". + Синтаксис регулярных выражений. После закрывающего разделителя можно указывать различные модификаторы, влияющие на работу регулярных выражений. Детальная информация доступна в разделе - "Модификаторы шаблонов". + Модификаторы шаблонов. PHP также поддерживает POSIX-совместимые регулярные выражения, используя @@ -35,20 +35,20 @@ - Этот модуль хранит глобальный (1 на поток) кэш компилированных + Этот модуль хранит глобальный (1 на поток) кеш компилированных регулярных выражений (до 4096). Помните об ограничениях PCRE. См. документацию по PCRE &url.pcre.man; для информации. + xlink:href="&url.pcre.man;">&url.pcre.man; для дополнительной информации. Библиотека PCRE - это набор функций, реализующих разбор регулярных выражений с помощью того же синтаксиса и семантики, которая была - реализована в Perl 5, с некоторыми небольшими отличиями (см. ниже). + реализована в Perl 5, но с некоторыми небольшими отличиями (см. ниже). Текущая реализация соответствует версии Perl 5.005. diff --git a/reference/pcre/configure.xml b/reference/pcre/configure.xml index 464383a66..62ea8e506 100644 --- a/reference/pcre/configure.xml +++ b/reference/pcre/configure.xml @@ -6,15 +6,15 @@ &reftitle.install; Расширение PCRE является расширением ядра, поэтому оно всегда доступно. - По умолчанию, это расширение собирается с использованием встроенной библиотеки PCRE. - Также можно использовать внешнюю PCRE библиотеку, указав при сборке + По умолчанию это расширение собирается с использованием встроенной библиотеки PCRE. + Также можно использовать внешнюю PCRE-библиотеку, указав при сборке параметр , где DIR указывает на директорию с библиотеками и подключаемыми файлами PCRE. Для PHP 5.6 и 7.0 рекомендуется использовать PCRE 8.10 и выше. - Начиная с PHP 7.0.0, по умолчанию поддерживается JIT компиляция PCRE. Ее можно + Начиная с PHP 7.0.0, по умолчанию поддерживается JIT-компиляция PCRE. Ее можно отключить с помощью опции начиная с PHP 7.0.12. diff --git a/reference/pcre/constants.xml b/reference/pcre/constants.xml index a6ff8a4c1..529f7c7a7 100644 --- a/reference/pcre/constants.xml +++ b/reference/pcre/constants.xml @@ -6,7 +6,7 @@ &reftitle.constants; &extension.constants; - PREG константы + Константы PREG @@ -22,7 +22,7 @@ Меняет порядок элементов в результирующем массиве так, чтобы элемент $matches[0] содержал полные вхождения шаблона, элемент $matches[1] - - все вхождения первой взятой в круглые скобки подмаски, и так далее. + все вхождения первой взятой в круглые скобки подмаски и т.д. Только preg_match_all реагирует на данный модификатор. @@ -35,7 +35,7 @@ элемент $matches[0] содержал первый набор вхождений (полное вхождение, вхождение первой подмаски, заключенной в круглые скобки...), аналогично элемент - $matches[1] - второй набор вхождений, и так далее. + $matches[1] - второй набор вхождений и т.д. Только preg_match_all реагирует на данный модификатор. @@ -114,7 +114,7 @@ PREG_BAD_UTF8_ERROR Возвращается функцией preg_last_error, если - последняя ошибка была вызвана поврежденными UTF-8 данными + последняя ошибка была вызвана поврежденными данными UTF-8 (только при запуске в режиме UTF-8). 5.2.0 @@ -131,7 +131,7 @@ PREG_JIT_STACKLIMIT_ERROR - Возвращается функцией preg_last_error если последняя + Возвращается функцией preg_last_error, если последняя функция PCRE завершилась неудачно из-за лимита стека JIT. 7.0.0 diff --git a/reference/pcre/examples.xml b/reference/pcre/examples.xml index afdb7fa1b..ee72fe7bb 100644 --- a/reference/pcre/examples.xml +++ b/reference/pcre/examples.xml @@ -1,5 +1,6 @@ + &reftitle.examples; diff --git a/reference/pcre/functions/preg-grep.xml b/reference/pcre/functions/preg-grep.xml index be082102f..1fb005514 100644 --- a/reference/pcre/functions/preg-grep.xml +++ b/reference/pcre/functions/preg-grep.xml @@ -1,6 +1,6 @@ - + @@ -31,7 +31,7 @@ pattern - Искомый шаблон, строка. + Искомый шаблон в виде строки. diff --git a/reference/pcre/functions/preg-last-error.xml b/reference/pcre/functions/preg-last-error.xml index 2c7c41def..4c48fb806 100644 --- a/reference/pcre/functions/preg-last-error.xml +++ b/reference/pcre/functions/preg-last-error.xml @@ -46,7 +46,7 @@ if (preg_last_error() == PREG_BACKTRACK_LIMIT_ERROR) { &reftitle.returnvalues; - Возвращает одну из следующих констант, (описанных на отдельной странице.): PREG_NO_ERROR @@ -56,8 +56,8 @@ if (preg_last_error() == PREG_BACKTRACK_LIMIT_ERROR) { PREG_RECURSION_LIMIT_ERROR (см. также pcre.recursion_limit) PREG_BAD_UTF8_ERROR - PREG_BAD_UTF8_OFFSET_ERROR (начиная с PHP 5.3.0) - PREG_JIT_STACKLIMIT_ERROR (начиная с PHP 7.0.0) + PREG_BAD_UTF8_OFFSET_ERROR (с PHP 5.3.0) + PREG_JIT_STACKLIMIT_ERROR (с PHP 7.0.0) diff --git a/reference/pcre/functions/preg-match-all.xml b/reference/pcre/functions/preg-match-all.xml index 65ae8cc05..b3767b91e 100644 --- a/reference/pcre/functions/preg-match-all.xml +++ b/reference/pcre/functions/preg-match-all.xml @@ -38,7 +38,7 @@ pattern - Искомый шаблон, строка. + Искомый шаблон в виде строки. @@ -73,7 +73,7 @@ Упорядочивает результаты так, что элемент $matches[0] содержит массив полных вхождений шаблона, элемент $matches[1] - содержит массив вхождений первой подмаски, и так далее. + содержит массив вхождений первой подмаски и т.д. @@ -142,7 +142,7 @@ Array Упорядочивает результаты так, что элемент $matches[0] содержит первый набор вхождений, элемент $matches[1] содержит второй набор вхождений, - и так далее. + и т.д. \w+): (?P\d+)/', $str, $matches); /* Это также работает в PHP 5.2.2 (PCRE 7.0) и более поздних версиях, - * однако, вышеуказанная форма рекомендуется для обратной совместимости */ + * однако вышеуказанная форма рекомендуется для обратной совместимости */ // preg_match_all('/(?\w+): (?\d+)/', $str, $matches); print_r($matches); @@ -452,7 +452,7 @@ Array &reftitle.seealso; - "Регулярные выражения PCRE" + Регулярные выражения PCRE preg_quote preg_match preg_replace diff --git a/reference/pcre/functions/preg-match.xml b/reference/pcre/functions/preg-match.xml index 0f6466a7f..e94f3a8ac 100644 --- a/reference/pcre/functions/preg-match.xml +++ b/reference/pcre/functions/preg-match.xml @@ -32,7 +32,7 @@ pattern - Искомый шаблон, строка. + Искомый шаблон в виде строки. @@ -53,7 +53,7 @@ результатами поиска. Элемент $matches[0] будет содержать часть строки, соответствующую вхождению всего шаблона, $matches[1] - часть строки, - соответствующую первой подмаске, и так далее. + соответствующую первой подмаске и так далее. @@ -191,7 +191,7 @@ Array В качестве альтернативы substr(), используйте - утверждение \G вместо якоря ^, + утверждение \G вместо якоря ^ или модификатор A. Оба они работают с параметром offset. @@ -228,7 +228,7 @@ Array 5.3.6 - Возвращает &false; если offset больше, чем длина + Возвращает &false;, если offset больше, чем длина subject. @@ -275,7 +275,7 @@ if (preg_match("/php/i", "PHP is the web scripting language of choice.")) { \w+): (?P\d+)/', $str, $matches); /* Это также работает в PHP 5.2.2 (PCRE 7.0) и более поздних версиях, - * однако, вышеуказанная форма рекомендуется для обратной совместимости */ + однако вышеуказанная форма рекомендуется для обратной совместимости */ // preg_match('/(?\w+): (?\d+)/', $str, $matches); print_r($matches); diff --git a/reference/pcre/functions/preg-quote.xml b/reference/pcre/functions/preg-quote.xml index 632b6f3eb..47b74b700 100644 --- a/reference/pcre/functions/preg-quote.xml +++ b/reference/pcre/functions/preg-quote.xml @@ -54,7 +54,7 @@ В случае, если указан необязательный параметр delimiter, он будет также экранироваться. Это удобно для экранирования - разделителя, который используется в PCRE функциях. Наиболее + разделителя, который используется в PCRE-функциях. Наиболее распространенным разделителем является символ /. @@ -98,7 +98,7 @@ &reftitle.examples; - <function>preg_quote</function> пример + Пример использования <function>preg_quote</function> - + @@ -59,7 +59,7 @@ count - Если задан, то в указанную переменную будет записано число произведенных замен. + Если задан, то в указанную переменную будет записано количество произведенных замен. @@ -93,10 +93,10 @@ $subject = 'Aaaaaa Bbb'; preg_replace_callback_array( [ '~[a]+~i' => function ($match) { - echo strlen($match[0]), ' matches for "a" found', PHP_EOL; + echo 'Найдено ', strlen($match[0]), ' совпадений "a"', PHP_EOL; }, '~[b]+~i' => function ($match) { - echo strlen($match[0]), ' matches for "b" found', PHP_EOL; + echo 'Найдено ', strlen($match[0]), ' совпадений "b"', PHP_EOL; } ], $subject @@ -107,8 +107,8 @@ preg_replace_callback_array( &example.outputs; diff --git a/reference/pcre/functions/preg-replace-callback.xml b/reference/pcre/functions/preg-replace-callback.xml index d3b3c06bb..70ec5ef9f 100644 --- a/reference/pcre/functions/preg-replace-callback.xml +++ b/reference/pcre/functions/preg-replace-callback.xml @@ -170,14 +170,14 @@ fclose($fp); diff --git a/reference/pcre/functions/preg-replace.xml b/reference/pcre/functions/preg-replace.xml index 9f622ed32..436a965ec 100644 --- a/reference/pcre/functions/preg-replace.xml +++ b/reference/pcre/functions/preg-replace.xml @@ -351,7 +351,7 @@ xp***to &reftitle.seealso; - "Регулярные выражения PCRE" + Регулярные выражения PCRE preg_quote preg_filter preg_match diff --git a/reference/pcre/ini.xml b/reference/pcre/ini.xml index 8ac81f1a8..0fd62a88b 100644 --- a/reference/pcre/ini.xml +++ b/reference/pcre/ini.xml @@ -22,19 +22,19 @@ pcre.backtrack_limit "1000000" PHP_INI_ALL - Доступна с PHP 5.2.0. + Доступно с PHP 5.2.0. pcre.recursion_limit "100000" PHP_INI_ALL - Доступна с PHP 5.2.0. + Доступно с PHP 5.2.0. pcre.jit "1" PHP_INI_ALL - Доступна с PHP 7.0.0. + Доступно с PHP 7.0.0. @@ -53,7 +53,7 @@ - Лимит обратных ссылок PCRE. Для PHP < 5.3.7, значение по умолчанию 100000. + Лимит обратных ссылок PCRE. Для PHP < 5.3.7 значение по умолчанию 100000. @@ -67,7 +67,7 @@ Лимит на рекурсию. Не забывайте о том, что если вы установите достаточно высокое значение, то PCRE может превысить размер стека (установленный операционной системой) и в конце концов - вызовет крушение PHP. + вызовет падение PHP. @@ -78,7 +78,7 @@ - Будет использоваться PCRE just-in-time компиляция. + Будет ли использоваться JIT-компиляция PCRE. diff --git a/reference/pcre/pattern.differences.xml b/reference/pcre/pattern.differences.xml index 43ba7aa62..9e763d01a 100644 --- a/reference/pcre/pattern.differences.xml +++ b/reference/pcre/pattern.differences.xml @@ -1,6 +1,6 @@ - +
@@ -11,20 +11,20 @@ - По умолчанию, пробельный символ - это любой символ, который функция isspace() + По умолчанию пробельный символ - это любой символ, который функция isspace() из библиотеки C опознает таковым, хотя возможно скомпилировать PCRE с альтернативными таблицами символов. Функция isspace() определяет как пробельный следующие символы: пробел, конец страницы (formfeed), перевод строки, возврат каретки, горизонтальную - табуляцию и вертикальную табуляцию. Perl 5 же, не включает вертикальную табуляцию в - список пробельных символов. Экранирование \v, долгое время присутствовавшее в - документации Perl, на самом деле никогда не распознавалось. Однако, символ как таковой, + табуляцию и вертикальную табуляцию. Perl 5 же не включает вертикальную табуляцию в + список пробельных символов. Экранирование \v долгое время присутствовавшее в + документации Perl на самом деле никогда не распознавалось. Однако, символ как таковой, считался за пробельный до версии 5.002. В 5.004 и 5.005 он не определяется как \s. PCRE не позволяет использовать квантификаторы повторения в опережающих - предположениях. Perl разрешает, но они не означаю того, о чем вы могли подумать. К + предположениях. Perl разрешает, но они не означают того, о чем вы могли подумать. К примеру, (?!a){3} не проверяет, что следующие три символа не "a". Проверяется только то, что следующий символ не "a" три раза. @@ -41,7 +41,7 @@ Хотя бинарные нулевые символы поддерживаются в проверяемой строке, они недопустимы - в строке шаблона, потому, что она передается как нормальная C строка, в которой этот + в строке шаблона, потому что она передается как нормальная C-строка, в которой этот символ обозначает конец строки. Для его использования в строке шаблона необходимо пользоваться конструкцией "\x00". @@ -49,7 +49,7 @@ Следующие экранирующие последовательности Perl не поддерживаются: - \l, \u, \L, \U. Фактически, они реализованы стандартным обработчикос строк Perl и + \l, \u, \L, \U. Фактически они реализованы стандартным обработчиком строк Perl и не являются частью модуля обработки регулярных выражений. @@ -71,8 +71,8 @@ когда часть шаблона повторяется. К примеру, проверка "aba" шаблоном /^(a(b)?)+$/, устанавливает $2 в значение "b", но проверка "aabbaa" шаблоном /^(aa(bb)?)+$/, оставляет $2 не выставленной. Хотя, если шаблон поменять на /^(aa(b(b))?)+$/, то $2 - (и $3) будут установлены. В Perl 5.004, $2 установится в обоих случаях, и это, также, - истинно и для PCRE. Если в будущем Perl как либо зафиксирует это поведение, PRCE + (и $3) будут установлены. В Perl 5.004, $2 установится в обоих случаях, и это также + истинно и для PCRE. Если в будущем Perl как-либо зафиксирует это поведение, PRCE будет ему следовать. @@ -99,7 +99,7 @@ Если установлена PCRE_DOLLAR_ENDONLY и не установлена PCRE_MULTILINE, - мета-символ $ распознается только в самом конце строки. + метасимвол $ распознается только в самом конце строки. @@ -112,8 +112,8 @@ Если установлена PCRE_UNGREEDY, - жадность квантификаторов повторения инвертирована. То есть, по умолчанию они не - жадные, но если за ними знак вопроса, то да. + жадность квантификаторов повторения инвертирована. То есть по умолчанию они не + жадные, пока за ними не будет знак вопроса. diff --git a/reference/pcre/pattern.modifiers.xml b/reference/pcre/pattern.modifiers.xml index 9f414d6bd..09b19bf19 100644 --- a/reference/pcre/pattern.modifiers.xml +++ b/reference/pcre/pattern.modifiers.xml @@ -7,7 +7,7 @@ Описывает возможные модификаторы шаблонов Perl-совместимых регулярных выражений (PCRE) Ниже перечислены все доступные на сегодняшний день модификаторы. - Имя, взятое в круглые скобки, указывает внутреннее PCRE имя для данного модификатора. + Имя, взятое в круглые скобки, указывает внутреннее PCRE-имя для данного модификатора. Пробелы и переводы строк в модификаторах игнорируются, другие символы вызывают ошибки. @@ -27,7 +27,7 @@ m (PCRE_MULTILINE) - По умолчанию, PCRE обрабатывает данные как однострочную символьную строку + По умолчанию PCRE обрабатывает данные как однострочную символьную строку (даже если она содержит несколько разделителей строк). Метасимвол начала строки '^' соответствует только началу обрабатываемого текста, в то время как метасимвол "конец строки" @@ -54,7 +54,7 @@ Если данный модификатор используется, метасимвол "точка" в шаблоне соответствует всем символам, включая перевод - строк. Без него - всем, за исключением переводов строк. + строк. Без него - все символы, кроме переводов строк. Этот модификатор эквивалентен записи /s в Perl. Класс символов, построенный на отрицании, например [^a], всегда соответствует переводу строки, независимо от @@ -175,7 +175,7 @@ $html = preg_replace_callback( Если используется данный модификатор, соответствие шаблону - будет достигаться только в том случае, если он "заякорен", т.е. + будет достигаться только в том случае, если он "заякорен", то есть соответствует началу строки, в которой производится поиск. Того же эффекта можно достичь подходящей конструкцией с вложенным шаблоном, которая является единственным способом реализации diff --git a/reference/pcre/pattern.posix.xml b/reference/pcre/pattern.posix.xml index 7f82e2c1e..2098569d6 100644 --- a/reference/pcre/pattern.posix.xml +++ b/reference/pcre/pattern.posix.xml @@ -1,12 +1,12 @@ - +
Отличия от регулярных выражений POSIX - По состоянию на PHP 5.3.0, расширение регулярные выражения POSIX‎ + По состоянию на PHP 5.3.0 расширение регулярных выражений POSIX‎ считается устаревшим. Существует целый ряд отличий между регулярными выражениями POSIX и PCRE. На этой странице перечислены наиболее важные из них, которые необходимо знать для того, чтобы выполнить преобразование в PCRE. @@ -21,7 +21,7 @@ - В отличие от POSIX, в расширении PCRE нет специальных функция для поиска совпадений + В отличие от POSIX, в расширении PCRE нет специальных функций для поиска совпадений без учета регистра. Вместо них используется модификатор шаблона i (PCRE_CASELESS). Также доступны другие модификаторы шаблонов для изменения стратегии поиска совпадений. @@ -54,8 +54,8 @@ не поддерживаются. - Передача выражения с символьным классом, начинающегося и заканчивающегося на - :, . или = символы, + Передача выражения с символьным классом, начинающегося и заканчивающегося на символы + :, . или =, в PCRE рассматривается как попытка использования одной из этих неподдерживаемых функций и вызывает ошибку компиляции. diff --git a/reference/pcre/reference.xml b/reference/pcre/reference.xml index e50067a6d..d18e79143 100644 --- a/reference/pcre/reference.xml +++ b/reference/pcre/reference.xml @@ -1,9 +1,9 @@ + - Функции для работы с регулярными выражениями (Perl-совместимые) - PCRE + &Functions; PCRE &reference.pcre.entities.functions;