Skip to content

[Sync-EN] Document that SimpleXML get methods no longer implicitly rewind #1785

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

Open
lacatoire wants to merge 1 commit into
base: master
Choose a base branch
from
+27 −8
Open

[Sync-EN] Document that SimpleXML get methods no longer implicitly rewind #1785

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
22 changes: 15 additions & 7 deletions reference/simplexml/simplexmlelement.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: 418ec505128707215c5c99ad4a66a88bfd84a0ff Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.simplexmlelement" 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>Класс SimpleXMLElement</title>
Expand Down Expand Up @@ -39,12 +39,8 @@
</oointerface>

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

Expand All @@ -61,6 +57,18 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Методы получения данных, например
<methodname>SimpleXMLElement::asXML</methodname> или
<methodname>SimpleXMLElement::getName</methodname>, и приведение
объекта класса <classname>SimpleXMLElement</classname> к строке
(&string;) больше не перематывают итератор неявно.
Теперь итератор при необходимости перематывают явно — методом
<methodname>SimpleXMLElement::rewind</methodname>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
13 changes: 12 additions & 1 deletion reference/simplexml/simplexmlelement/rewind.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: dcb657b7e9e4f7622ce3394ae1fa3c14538721e1 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 418ec505128707215c5c99ad4a66a88bfd84a0ff Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="simplexmlelement.rewind" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -23,6 +23,17 @@
<para>
Метод перематывает <classname>SimpleXMLElement</classname> к первому элементу.
</para>

<note>
<simpara>
Начиная с PHP 8.4.0 вызов методов получения данных, например
<methodname>SimpleXMLElement::asXML</methodname> или
<methodname>SimpleXMLElement::getName</methodname>, и приведение
объекта класса <classname>SimpleXMLElement</classname> к строке
(&string;) больше не перематывают итератор неявно. При необходимости
итератор перематывают явно вызовом этого метода.
</simpara>
</note>
</refsect1>

<refsect1 role="parameters">
Expand Down
Loading