Skip to content

[Sync-EN] Iterator::rewind: refer to this method instead of the rewind() function #1743

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 2 commits into from
Sep 22, 2026
Merged

[Sync-EN] Iterator::rewind: refer to this method instead of the rewind() function #1743

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0be8ab1
iterator/rewind.xml: refer to this method instead of linking the rewi…
lacatoire Aug 31, 2026
88c569a
Update rewind.xml
mmalferov Sep 22, 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
21 changes: 10 additions & 11 deletions language/predefined/iterator/rewind.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7fbb16f538011636999459326a55d5f153ef2c61 Maintainer: das Status: ready -->
<!-- EN-Revision: f0a5e4f7d35f0af1a7e93b383445657bc459914b Maintainer: das Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="iterator.rewind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Iterator::rewind</refname>
<refpurpose>Возвращает итератор на первый элемент</refpurpose>
<refpurpose>Отматывает итератор на первый элемент</refpurpose>
</refnamediv>

<refsect1 role="description">
Expand All @@ -14,22 +14,21 @@
<void/>
</methodsynopsis>
<para>
Возвращает итератор обратно на первый элемент.
Метод отматывает итератор на первый элемент.
</para>
<note>
<para>
В начале цикла &foreach; этот метод вызывается <emphasis>первым</emphasis>.
Метод <emphasis>не будет</emphasis> вызван <emphasis>после</emphasis>
В начале цикла &foreach; метод вызывается <emphasis>первым</emphasis>.
Метод <emphasis>не вызывается</emphasis> <emphasis>после</emphasis>
цикла &foreach;.
</para>
<simpara>
Поскольку &foreach; всегда вызывает метод <methodname>rewind</methodname> перед началом итерации,
ручное перемещение позиции итератора (например, с помощью метода <methodname>SplFileObject::seek</methodname>)
будет сброшено.
Запуск цикла &foreach; сбросит ручное продвижение позиции итератора методом наподобие <methodname>SplFileObject::seek</methodname>,
поскольку цикл каждый раз вызывает метод перед началом итерации.
</simpara>
<simpara>
Для выполнения итерации без перемотки итератора, оберните его в
<classname>NoRewindIterator</classname>.
Для итерации без перемотки
итератор оборачивают объектом <classname>NoRewindIterator</classname>.
</simpara>
</note>
</refsect1>
Expand All @@ -42,7 +41,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Любое возвращаемое значение игнорируется.
Возвращаемое значение игнорируется.
</para>
</refsect1>

Expand Down
Loading