Skip to content

Update Spl to En #1853

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mmalferov merged 16 commits into from
Sep 7, 2026
Merged

Update Spl to En #1853

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
1a2a5fc
Update arrayiterator.xml
mmalferov Aug 21, 2026
9d4c7ef
Update arrayobject.xml
mmalferov Aug 31, 2026
2bda5d0
Update cachingiterator.xml
mmalferov Aug 31, 2026
9bda2ad
Update filesystemiterator.xml
mmalferov Sep 1, 2026
4749f5d
Update multipleiterator.xml
mmalferov Sep 1, 2026
67f6ded
Update recursivearrayiterator.xml
mmalferov Sep 1, 2026
07fc480
Update recursiveiteratoriterator.xml
mmalferov Sep 1, 2026
8352936
Update recursivetreeiterator.xml
mmalferov Sep 1, 2026
cb31c7e
Update regexiterator.xml
mmalferov Sep 2, 2026
e51231a
Update spldoublylinkedlist.xml
mmalferov Sep 7, 2026
b6c2b0e
Update splfileobject.xml
mmalferov Sep 7, 2026
4abd299
Update splpriorityqueue.xml
mmalferov Sep 7, 2026
cd3ab6d
Update splpriorityqueue.xml remove trailing whitespace
mmalferov Sep 7, 2026
a182a6e
Update spldoublylinkedlist.xml remove trailing whitespace
mmalferov Sep 7, 2026
fb198aa
Update arrayobject.xml remove trailing whitespace
mmalferov Sep 7, 2026
8ddefd7
Update arrayiterator.xml remove trailing whitespace
mmalferov Sep 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 29 additions & 15 deletions reference/spl/arrayiterator.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 077aab2687db07bcf71c2c7e26f677ea61f5916a Maintainer: mch Status: ready -->
<!-- EN-Revision: 6a2ad3ecf9b77855446019ed2d74aa6f734d35a8 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.arrayiterator" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс ArrayIterator</title>
Expand Down Expand Up @@ -69,12 +69,8 @@
</fieldsynopsis>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.arrayiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='ArrayIterator'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.arrayiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='ArrayIterator'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.arrayiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='ArrayIterator'])"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.arrayiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='ArrayIterator'])"/>
</classsynopsis>

</section>
Expand All @@ -89,11 +85,11 @@
<term><constant>ArrayIterator::STD_PROP_LIST</constant></term>
<listitem>
<para>
При установке флага свойства объекта сохраняют стандартное поведение.
Вызов на объекте функции var_dump() показывает, что свойства хранятся стандартно, а во внутреннее хранилище
попадают только элементы массива. При итерации по объекту языковой конструкцией foreach или другими средствами
доступа к спискам выдаются только элементы хранилища. При этом доступ к элементам хранилища возможен
только через квадратные скобки.
Флаг не изменяет способ доступа к свойствам объекта.
Динамические свойства сохраняются в объекте и выводятся функцией <function>var_dump</function> стандартно,
а во внутреннее хранилище попадают только элементы исходного массива и элементы, которые добавили в объект синтаксисом массивов.
В итерации или обходе объекта языковой конструкцией &foreach; участвуют только элементы хранилища.
Доступ к элементам внутреннего массива возможен только через квадратные скобки.
</para>
</listitem>
</varlistentry>
Expand All @@ -102,9 +98,10 @@
<term><constant>ArrayIterator::ARRAY_AS_PROPS</constant></term>
<listitem>
<para>
При установке флага свойства объекта и элементы массива сохраняются во внутреннем хранилище
и при итерации по объекту выдаются как элементы единого списка. Флаг разрешает обращаться к элементам
внутреннего хранилища для чтения или записи как через синтаксис квадратных скобок, так и через оператор доступа к свойствам объекта.
Установка флага не изменяет способ доступа к текущим свойствам объекта,
но динамические свойства наряду с элементами, которые добавляют в объект синтаксисом массива,
сохраняются во внутреннем хранилище. Флаг разрешает доступ к элементам внутреннего хранилища
как через синтаксис квадратных скобок, так и через оператор доступа к свойствам объекта.
</para>
</listitem>
</varlistentry>
Expand All @@ -126,6 +123,23 @@
</section>
}}} -->

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&changelog.class-constants-typed;
</tbody>
</tgroup>
</informaltable>
</section>

</partintro>

&reference.spl.entities.arrayiterator;
Expand Down
48 changes: 33 additions & 15 deletions reference/spl/arrayobject.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: eff22719b03a83400103686b87d5b470c1d5c785 Maintainer: mch Status: ready -->
<!-- EN-Revision: 6a2ad3ecf9b77855446019ed2d74aa6f734d35a8 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.arrayobject" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс ArrayObject</title>
Expand All @@ -11,12 +11,12 @@
<section xml:id="arrayobject.intro">
&reftitle.intro;
<para>
Класс разрешает объектам работать как массивы.
Класс разрешает работать со своими экземплярами как с массивами.
</para>
<note>
<simpara>
Оборачивание объектов этим классом в корне ошибочно,
поэтому не рекомендуют использовать класс с объектами.
Оборачивание объектов классом ArrayObject в корне ошибочно,
поэтому, хотя конструктор и принимает объекты, экземпляры класса инициализируют только массивами.
</simpara>
</note>
</section>
Expand Down Expand Up @@ -63,12 +63,8 @@
</fieldsynopsis>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.arrayobject')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='ArrayObject'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.arrayobject')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='ArrayObject'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.arrayobject')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='ArrayObject'])"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.arrayobject')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='ArrayObject'])"/>
</classsynopsis>

</section>
Expand All @@ -83,9 +79,11 @@
<term><constant>ArrayObject::STD_PROP_LIST</constant></term>
<listitem>
<para>
Свойства объекта функционируют как обычно, но только при доступе
к ним функциями наподобие <function>var_dump</function>,
языковыми конструкциями наподобие &foreach; и т. д. как к элементам списка.
Флаг не изменяет способ доступа к свойствам объекта.
Динамические свойства сохраняются в объекте и выводятся функцией <function>var_dump</function> стандартно,
а во внутреннее хранилище попадают только элементы исходного массива и элементы, которые добавили в объект синтаксисом массивов.
В итерации или обходе объекта языковой конструкцией &foreach; участвуют только элементы хранилища.
Доступ к элементам внутреннего массива возможен только через квадратные скобки.
</para>
</listitem>
</varlistentry>
Expand All @@ -94,8 +92,11 @@
<term><constant>ArrayObject::ARRAY_AS_PROPS</constant></term>
<listitem>
<para>
Записи доступны для чтения и записи и как элементы массива, и как свойства объекта.
Класс <classname>ArrayObject</classname> использует внутреннюю логику доступа
Установка флага не изменяет способ доступа к текущим свойствам объекта,
но динамические свойства наряду с элементами, которые добавляют в объект синтаксисом массива,
сохраняются во внутреннем хранилище. Флаг разрешает доступ к элементам внутреннего хранилища
как через синтаксис квадратных скобок, так и через оператор доступа к свойствам объекта.
Класс <classname>ArrayObject</classname> задействует внутреннюю логику доступа
к свойствам, поэтому при попытке чтения или записи динамических свойств
не возникает предупреждений или ошибок.
</para>
Expand All @@ -119,6 +120,23 @@
</section>
}}} -->

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&changelog.class-constants-typed;
</tbody>
</tgroup>
</informaltable>
</section>

</partintro>

&reference.spl.entities.arrayobject;
Expand Down
34 changes: 23 additions & 11 deletions reference/spl/cachingiterator.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: mch Status: ready -->
<!-- EN-Revision: 6a2ad3ecf9b77855446019ed2d74aa6f734d35a8 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.cachingiterator" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс CachingIterator</title>
Expand All @@ -11,7 +11,7 @@
<section xml:id="cachingiterator.intro">
&reftitle.intro;
<para>
Этот объект поддерживает кеширование итерации над другим итератором.
Объекты класса поддерживают кеширование итерации над другим итератором.
</para>
</section>
<!-- }}} -->
Expand Down Expand Up @@ -82,17 +82,11 @@
</fieldsynopsis>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.cachingiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='CachingIterator'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.cachingiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='CachingIterator'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.cachingiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='CachingIterator'])"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.cachingiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='CachingIterator'])"/>

<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.iteratoriterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='IteratorIterator'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.iteratoriterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='IteratorIterator'])"/>
</classsynopsis>
<!-- }}} -->

Expand Down Expand Up @@ -180,6 +174,24 @@
</informaltable>
</section>


<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&changelog.class-constants-typed;
</tbody>
</tgroup>
</informaltable>
</section>

</partintro>

&reference.spl.entities.cachingiterator;
Expand Down
Loading
Loading