diff --git a/reference/spl/arrayiterator.xml b/reference/spl/arrayiterator.xml index 0747c1a8ad..9d70a2dedc 100644 --- a/reference/spl/arrayiterator.xml +++ b/reference/spl/arrayiterator.xml @@ -1,5 +1,5 @@ - + Класс ArrayIterator @@ -69,12 +69,8 @@ &Methods; - - - - - - + + @@ -89,11 +85,11 @@ ArrayIterator::STD_PROP_LIST - При установке флага свойства объекта сохраняют стандартное поведение. - Вызов на объекте функции var_dump() показывает, что свойства хранятся стандартно, а во внутреннее хранилище - попадают только элементы массива. При итерации по объекту языковой конструкцией foreach или другими средствами - доступа к спискам выдаются только элементы хранилища. При этом доступ к элементам хранилища возможен - только через квадратные скобки. + Флаг не изменяет способ доступа к свойствам объекта. + Динамические свойства сохраняются в объекте и выводятся функцией var_dump стандартно, + а во внутреннее хранилище попадают только элементы исходного массива и элементы, которые добавили в объект синтаксисом массивов. + В итерации или обходе объекта языковой конструкцией &foreach; участвуют только элементы хранилища. + Доступ к элементам внутреннего массива возможен только через квадратные скобки. @@ -102,9 +98,10 @@ ArrayIterator::ARRAY_AS_PROPS - При установке флага свойства объекта и элементы массива сохраняются во внутреннем хранилище - и при итерации по объекту выдаются как элементы единого списка. Флаг разрешает обращаться к элементам - внутреннего хранилища для чтения или записи как через синтаксис квадратных скобок, так и через оператор доступа к свойствам объекта. + Установка флага не изменяет способ доступа к текущим свойствам объекта, + но динамические свойства наряду с элементами, которые добавляют в объект синтаксисом массива, + сохраняются во внутреннем хранилище. Флаг разрешает доступ к элементам внутреннего хранилища + как через синтаксис квадратных скобок, так и через оператор доступа к свойствам объекта. @@ -126,6 +123,23 @@ }}} --> +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
+ &reference.spl.entities.arrayiterator; diff --git a/reference/spl/arrayobject.xml b/reference/spl/arrayobject.xml index 1be1bc04f3..805d51477d 100644 --- a/reference/spl/arrayobject.xml +++ b/reference/spl/arrayobject.xml @@ -1,5 +1,5 @@ - + Класс ArrayObject @@ -11,12 +11,12 @@
&reftitle.intro; - Класс разрешает объектам работать как массивы. + Класс разрешает работать со своими экземплярами как с массивами. - Оборачивание объектов этим классом в корне ошибочно, - поэтому не рекомендуют использовать класс с объектами. + Оборачивание объектов классом ArrayObject в корне ошибочно, + поэтому, хотя конструктор и принимает объекты, экземпляры класса инициализируют только массивами.
@@ -63,12 +63,8 @@ &Methods; - - - - - - + + @@ -83,9 +79,11 @@ ArrayObject::STD_PROP_LIST - Свойства объекта функционируют как обычно, но только при доступе - к ним функциями наподобие var_dump, - языковыми конструкциями наподобие &foreach; и т. д. как к элементам списка. + Флаг не изменяет способ доступа к свойствам объекта. + Динамические свойства сохраняются в объекте и выводятся функцией var_dump стандартно, + а во внутреннее хранилище попадают только элементы исходного массива и элементы, которые добавили в объект синтаксисом массивов. + В итерации или обходе объекта языковой конструкцией &foreach; участвуют только элементы хранилища. + Доступ к элементам внутреннего массива возможен только через квадратные скобки. @@ -94,8 +92,11 @@ ArrayObject::ARRAY_AS_PROPS - Записи доступны для чтения и записи и как элементы массива, и как свойства объекта. - Класс ArrayObject использует внутреннюю логику доступа + Установка флага не изменяет способ доступа к текущим свойствам объекта, + но динамические свойства наряду с элементами, которые добавляют в объект синтаксисом массива, + сохраняются во внутреннем хранилище. Флаг разрешает доступ к элементам внутреннего хранилища + как через синтаксис квадратных скобок, так и через оператор доступа к свойствам объекта. + Класс ArrayObject задействует внутреннюю логику доступа к свойствам, поэтому при попытке чтения или записи динамических свойств не возникает предупреждений или ошибок. @@ -119,6 +120,23 @@ }}} --> +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
+ &reference.spl.entities.arrayobject; diff --git a/reference/spl/cachingiterator.xml b/reference/spl/cachingiterator.xml index c9e2005e4a..be7f9c47e9 100644 --- a/reference/spl/cachingiterator.xml +++ b/reference/spl/cachingiterator.xml @@ -1,5 +1,5 @@ - + Класс CachingIterator @@ -11,7 +11,7 @@
&reftitle.intro; - Этот объект поддерживает кеширование итерации над другим итератором. + Объекты класса поддерживают кеширование итерации над другим итератором.
@@ -82,17 +82,11 @@ &Methods; - - - - - - + + &InheritedMethods; - - - + @@ -180,6 +174,24 @@ + +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
+ &reference.spl.entities.cachingiterator; diff --git a/reference/spl/filesystemiterator.xml b/reference/spl/filesystemiterator.xml index cb493c36e7..b3fce7817c 100644 --- a/reference/spl/filesystemiterator.xml +++ b/reference/spl/filesystemiterator.xml @@ -1,5 +1,5 @@ - + @@ -12,7 +12,7 @@
&reftitle.intro; - Итератор файловой системы + Итератор файловой системы.
@@ -106,20 +106,12 @@ &Methods; - - - - - - + + &InheritedMethods; - - - - - - + + @@ -144,7 +136,7 @@ FilesystemIterator::CURRENT_AS_SELF - Заставляет метод FilesystemIterator::current вернуть $this (FilesystemIterator). + Заставляет метод FilesystemIterator::current вернуть $this — FilesystemIterator. @@ -156,13 +148,13 @@ FilesystemIterator::KEY_AS_PATHNAME - Заставляет метод FilesystemIterator::key вернуть путь. + Заставляет метод FilesystemIterator::key вернуть путь. FilesystemIterator::KEY_AS_FILENAME - Заставляет метод FilesystemIterator::key вернуть имя файла. + Заставляет метод FilesystemIterator::key вернуть название файла. @@ -186,23 +178,25 @@ FilesystemIterator::OTHER_MODE_MASK - Маска используется для FilesystemIterator::getFlags и FilesystemIterator::setFlags. + + Маска для извлечения только битов режима доступа к элементам файловой системы + при вызове методов FilesystemIterator::getFlags и FilesystemIterator::setFlags. + FilesystemIterator::SKIP_DOTS - Пропускает точечные файлы (. и ..). + Пропускает записи . и .. при итерации по элементам каталога. FilesystemIterator::UNIX_PATHS - Заставляет все пути использовать обратный слеш в Unix-стиле, независимо от настроек - системы по умолчанию. - Обратите внимание, что path, переданный в конструктор, не - меняется. + Заставляет итератор игнорировать системный разделитель каталогов + и возвращать пути в Unix-стиле — с прямым слешем. + Константа не изменяет путь, который передали в параметр конструктора path. @@ -210,6 +204,23 @@ +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
+ &reference.spl.entities.filesystemiterator; diff --git a/reference/spl/multipleiterator.xml b/reference/spl/multipleiterator.xml index e1457f605b..ed7d0b8076 100644 --- a/reference/spl/multipleiterator.xml +++ b/reference/spl/multipleiterator.xml @@ -1,5 +1,5 @@ - + @@ -12,7 +12,7 @@
&reftitle.intro; - Итератор, который последовательно перебирает по всем присоединённым итераторам + Итератор для параллельного перебора элементов присоединённых итераторов.
@@ -58,12 +58,8 @@ &Methods; - - - - - - + + @@ -78,7 +74,7 @@ MultipleIterator::MIT_NEED_ANY - Не требовать, чтобы все подытераторы были действительными в итерации. + Не требовать, чтобы все подытераторы оставались действительными в итерации. @@ -87,7 +83,7 @@ MultipleIterator::MIT_NEED_ALL - Требовать, чтобы все подытераторы были действительными в итерации. + Требовать, чтобы все подытераторы оставались действительными в итерации. @@ -96,7 +92,7 @@ MultipleIterator::MIT_KEYS_NUMERIC - Ключи создаются из позиции подытераторов. + Ключи создаются на основе позиции подытераторов. @@ -105,7 +101,7 @@ MultipleIterator::MIT_KEYS_ASSOC - Ключи создаются из связанной с подытераторами информации. + Ключи создаются на основе связанной с подытераторами информации. @@ -114,6 +110,22 @@ +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
diff --git a/reference/spl/recursivearrayiterator.xml b/reference/spl/recursivearrayiterator.xml index 77ebad62d4..48515cd1f2 100644 --- a/reference/spl/recursivearrayiterator.xml +++ b/reference/spl/recursivearrayiterator.xml @@ -1,5 +1,5 @@ - + Класс RecursiveArrayIterator @@ -11,8 +11,8 @@
&reftitle.intro; - Этот итератор позволяет сбросить и изменить значения и ключи во время прохода по массивам и объектам - таким же образом, как и ArrayIterator. Кроме того, можно перебирать текущие записи итератора. + Итератор умеет сбрасывать и изменять значения и ключи при проходе по массивам и объектам + аналогично итератору ArrayIterator, и перебирать записи текущего элемента.
@@ -37,9 +37,7 @@ &InheritedConstants; - - - + &Constants; @@ -50,17 +48,11 @@ &Methods; - - - + &InheritedMethods; - - - - - - + + @@ -73,13 +65,30 @@ RecursiveArrayIterator::CHILD_ARRAYS_ONLY - Применим только к массивам (не к объектам) как имеющих детей для итерации. + При рекурсивной итерации перебирать в глубину только элементы массивов, но не объектов. +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
+ &reference.spl.entities.recursivearrayiterator; diff --git a/reference/spl/recursiveiteratoriterator.xml b/reference/spl/recursiveiteratoriterator.xml index 2273e90e91..28c469fd9d 100644 --- a/reference/spl/recursiveiteratoriterator.xml +++ b/reference/spl/recursiveiteratoriterator.xml @@ -1,5 +1,5 @@ - + Класс RecursiveIteratorIterator @@ -11,7 +11,7 @@
&reftitle.intro; - Может быть использован для перебора рекурсивных итераторов. + Класс для перебора рекурсивных итераторов.
@@ -57,12 +57,8 @@ &Methods; - - - - - - + + @@ -104,6 +100,23 @@ +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
+ &reference.spl.entities.recursiveiteratoriterator; diff --git a/reference/spl/recursivetreeiterator.xml b/reference/spl/recursivetreeiterator.xml index 9a76b218c6..9e3f5fba64 100644 --- a/reference/spl/recursivetreeiterator.xml +++ b/reference/spl/recursivetreeiterator.xml @@ -1,5 +1,5 @@ - + @@ -12,7 +12,8 @@
&reftitle.intro; - Позволяет производить итерации по RecursiveIterator для генерации графического дерева в ASCII. + Класс строит ASCII-графическую древовидную структуру + путём перебора элементов рекурсивного итератора RecursiveIterator.
@@ -32,9 +33,7 @@ &InheritedConstants; - - - + &Constants; @@ -92,17 +91,11 @@ &Methods; - - - - - - + + &InheritedMethods; - - - + @@ -173,6 +166,22 @@ +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
diff --git a/reference/spl/regexiterator.xml b/reference/spl/regexiterator.xml index 9a49e35d3f..725a5879cb 100644 --- a/reference/spl/regexiterator.xml +++ b/reference/spl/regexiterator.xml @@ -1,5 +1,5 @@ - + Класс RegexIterator @@ -11,7 +11,7 @@
&reftitle.intro; - Этот итератор может быть использован для фильтрации другого итератора на основе регулярных выражений. + Итератор для фильтрации другого итератора на основе регулярных выражений.
@@ -83,20 +83,12 @@ &Methods; - - - - - - + + &InheritedMethods; - - - - - - + + @@ -104,15 +96,15 @@
&reftitle.constants;
- Режимы работы RegexIterator + Режимы работы итератора RegexIterator RegexIterator::ALL_MATCHES - Возвращать все совпадения для текущий записи - (смотрите preg_match_all). + Возвращать все совпадения для текущий записи. + См. описание функции preg_match_all. @@ -121,8 +113,8 @@ RegexIterator::GET_MATCH - Возвращать первое совпадение для текущей записи - (смотрите preg_match). + Возвращать первое совпадение для текущей записи. + См. описание функции preg_match. @@ -131,8 +123,8 @@ RegexIterator::MATCH - Только выполнение сравнения (фильтра) для текущей записи - (смотрите preg_match). + При совпадении с шаблоном пропускать текущий элемент через фильтр в неизменном виде. + См. описание функции preg_match. @@ -141,8 +133,8 @@ RegexIterator::REPLACE - Заменить текущую запись - (смотрите preg_replace; Полностью пока не реализовано) + Заменять текущую запись; механизм пока реализован частично. + См. описание функции preg_replace. @@ -151,7 +143,7 @@ RegexIterator::SPLIT - Возвращать разделённые значения для текущей записи (смотрите preg_split). + Возвращать разделённые значения для текущей записи. См. описание функции preg_split. @@ -196,6 +188,23 @@
+
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
+ &reference.spl.entities.regexiterator; diff --git a/reference/spl/spldoublylinkedlist.xml b/reference/spl/spldoublylinkedlist.xml index 87e967a821..1243df2316 100644 --- a/reference/spl/spldoublylinkedlist.xml +++ b/reference/spl/spldoublylinkedlist.xml @@ -1,5 +1,5 @@ - + Класс SplDoublyLinkedList @@ -11,7 +11,7 @@
&reftitle.intro; - Класс SplDoublyLinkedList обеспечивает основные функциональные возможности двусвязного списка. + Класс SplDoublyLinkedList включает базовые методы для работы с двусвязным списком и структурами на основе двусвязного списка.
@@ -69,9 +69,7 @@ &Methods; - - - +
@@ -87,7 +85,7 @@ SplDoublyLinkedList::IT_MODE_LIFO - Список будет повторяться по порядку "последним пришёл - первым вышел", как стек. + Список перебирается в порядке «последним вошёл — первым вышел», как стек. @@ -96,7 +94,7 @@ SplDoublyLinkedList::IT_MODE_FIFO - Список будет повторяться по порядку "первым пришёл - первым вышел", как очередь. + Список перебирается в порядке «первым вошёл — первым вышел», как очередь. @@ -112,7 +110,7 @@ SplDoublyLinkedList::IT_MODE_DELETE - Итерация удалит повторяющиеся элементы. + Удалять элементы после обхода. @@ -121,7 +119,7 @@ SplDoublyLinkedList::IT_MODE_KEEP - Итерация не удалит повторяющиеся элементы. + Не удалять элементы после обхода. @@ -145,6 +143,23 @@ }}} --> +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
+ &reference.spl.entities.spldoublylinkedlist; diff --git a/reference/spl/splfileobject.xml b/reference/spl/splfileobject.xml index 658e5330de..224c506dd2 100644 --- a/reference/spl/splfileobject.xml +++ b/reference/spl/splfileobject.xml @@ -1,5 +1,5 @@ - + @@ -12,7 +12,7 @@
&reftitle.intro; - Класс SplFileObject предоставляет объектно-ориентированный интерфейс для файла. + Класс SplFileObject предоставляет объектно-ориентированный интерфейс для работы с файлом.
@@ -67,17 +67,11 @@ &Methods; - - - - - - + + &InheritedMethods; - - - + @@ -90,13 +84,13 @@ SplFileObject::DROP_NEW_LINE - Удаляет символы переноса в конце строки. + Удаляет символы перевода строки в конце каждой строки. SplFileObject::READ_AHEAD - Читает при использовании функций rewind/next. + Включает упреждающее чтение: при вызове метода rewind() или next() отматывает или сдвигает указатель и сразу считывает строку. @@ -116,6 +110,23 @@ +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
+ &reference.spl.entities.splfileobject; diff --git a/reference/spl/splpriorityqueue.xml b/reference/spl/splpriorityqueue.xml index b30e844ef1..00cd078fc8 100644 --- a/reference/spl/splpriorityqueue.xml +++ b/reference/spl/splpriorityqueue.xml @@ -1,5 +1,5 @@ - + Класс SplPriorityQueue @@ -11,14 +11,13 @@
&reftitle.intro; - Класс SplPriorityQueue обеспечивает основные функциональные возможности - приоритетной очереди, реализованный при помощи кучи с максимальным элементом - наверху (max-heap). + Класс SplPriorityQueue реализует приоритетную очередь + на основе кучи с максимальным элементом наверху. - Порядок элементов с одинаковым приоритетом не определён. - Он может отличаться от порядка, в котором элементы были вставлены. + Порядок выдачи элементов с одинаковым приоритетом определяется внутренним алгоритмом структуры, + а не порядком вставки элементов.
@@ -63,9 +62,7 @@ &Methods; - - - + @@ -94,6 +91,23 @@ +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + &changelog.class-constants-typed; + + + +
+ &reference.spl.entities.splpriorityqueue;