From 8621b331a7ba4ab34677cf6ad7cf73b36c3cf973 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@php.net>
Date: Tue, 28 Jan 2025 11:00:50 +0300
Subject: [PATCH] =?UTF-8?q?Update=20each.xml=20=D0=98=D1=81=D0=BF=D1=80?=
 =?UTF-8?q?=D0=B0=D0=B2=D0=B8=D0=BB=20=D0=BF=D1=80=D0=B8=D1=81=D0=B2=D0=BE?=
 =?UTF-8?q?=D0=B5=D0=BD=D0=B8=D0=B5=20=E2=86=92=20=D0=BF=D1=80=D0=B8=D1=81?=
 =?UTF-8?q?=D0=B2=D0=B0=D0=B8=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5=20+=20nits?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/array/functions/each.xml | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/reference/array/functions/each.xml b/reference/array/functions/each.xml
index e6783507e1..8c175831fc 100644
--- a/reference/array/functions/each.xml
+++ b/reference/array/functions/each.xml
@@ -18,13 +18,13 @@
    <methodparam><type class="union"><type>array</type><type>object</type></type><parameter role="reference">array</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Возвращает текущую пару ключа и значения массива и продвигает внутренний указатель массива на одну позицию.
+   Функция возвращает текущую пару ключа и значения массива и продвигает внутренний указатель массива на одну позицию.
   </para>
   <para>
    После выполнения функции <function>each</function> указатель массива
    останется на следующем элементе или за последним элементом,
    если указатель достигнет конца массива. Для повторного обхода
-   каждого элемента массива, нужно вызвать функцию <function>reset</function>.
+   каждого элемента массива потребуется вызвать функцию <function>reset</function>.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -45,7 +45,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает текущую пару ключа и значения массива
+   Функция возвращает текущую пару ключа и значения массива
    <parameter>array</parameter>. Пара возвращается
    в массиве из четырёх элементов с ключами <literal>0</literal>,
    <literal>1</literal>, <literal>key</literal> и <literal>value</literal>.
@@ -54,21 +54,22 @@
    содержат данные.
   </para>
   <para>
-   Если внутренний указатель массива указывает за пределы массива,
-   функция <function>each</function> вернёт &false;.
+   Функция <function>each</function> вернёт значение &false;,
+   если внутренний указатель массива указывает за пределы массива.
   </para>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
-    <title>Примеры использования функции <function>each</function></title>
+    <title>Примеры получения текущей пары ключа и значения массива функцией <function>each</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
 
 $foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
 $bar = each($foo);
+
 print_r($bar);
 
 ?>
@@ -98,6 +99,7 @@ Array
 
 $foo = array("Robert" => "Bob", "Seppo" => "Sepi");
 $bar = each($foo);
+
 print_r($bar);
 
 ?>
@@ -151,7 +153,7 @@ c => cranberry
   </para>
   <caution>
    <para>
-    Поскольку присвоение массива другой переменной
+    Поскольку присваивание массива другой переменной
     сбрасывает указатель исходного массива, пример выше
     вызвал бы бесконечный цикл, если бы внутри цикла
     переменную <varname>$fruit</varname>