Update to En array-walk.xml + infostyle

reference/array/functions/array-walk.xml

@@ -1,28 +1,28 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d45ff7a3e78243470d1b7e5141d7ded022286d7f Maintainer: shein Status: ready -->
+<!-- EN-Revision: cec5275f23d2db648df30a5702b378044431be97 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.array-walk" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_walk</refname>
-  <refpurpose>Применяет заданную пользователем функцию к каждому элементу массива</refpurpose>
+  <refpurpose>Применяет пользовательскую функцию к каждому элементу массива</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>array_walk</methodname>
+   <type>true</type><methodname>array_walk</methodname>
    <methodparam><type class="union"><type>array</type><type>object</type></type><parameter role="reference">array</parameter></methodparam>
    <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
    <methodparam choice="opt"><type>mixed</type><parameter>arg</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <simpara>
-   Применяет пользовательскую функцию <parameter>callback</parameter> к каждому
+   Функция применяет пользовательскую <parameter>callback</parameter>-функцию к каждому
    элементу массива <parameter>array</parameter>.
   </simpara>
   <para>
-   <function>array_walk</function> не подвержена влиянию внутреннего
+   Функция <function>array_walk</function> не зависит от внутреннего
    указателя массива <parameter>array</parameter>.
-   <function>array_walk</function> обойдёт все элементы массива
+   Функция <function>array_walk</function> обойдёт каждый элемент массива
    независимо от позиции указателя.
   </para>
  </refsect1>
@@ -43,34 +43,33 @@
      <term><parameter>callback</parameter></term>
      <listitem>
       <para>
-       Обычно функция <parameter>callback</parameter> принимает два параметра.
-       В качестве первого параметра идёт значение элемента массива
-       <parameter>array</parameter>, а ключ - в качестве второго.
+       Обычно <parameter>callback</parameter>-функция принимает два аргумента.
+       Первым — значение элемента массива <parameter>array</parameter>,
+       а вторым — ключ или индекс элемента.
       </para>
       <note>
        <para>
-        Если требуется, чтобы функция <parameter>callback</parameter> изменила
-        значения в массиве, определите первый параметр
-        <parameter>callback</parameter> как
-        <link linkend="language.references">ссылку</link>. Тогда
-        все изменения будут применены к элементам оригинального массива.
+        Первый параметр <parameter>callback</parameter>-функции
+        определяют как <link linkend="language.references">ссылку</link>,
+        если требуется, чтобы <parameter>callback</parameter>-функция изменяла
+        значения исходного массива. Тогда изменения
+        элементов внутри функции обратного вызова изменят сам исходный массив.
        </para>
       </note>
       <note>
        <para>
-        Множество встроенных функций (например, <function>strtolower</function>)
-        выводят предупреждение, если им передано больше параметров, чем
-        они ожидают, или которые не могут непосредственно использоваться в
-        <parameter>callback</parameter>.
+        Многие внутренние функции наподобие <function>strtolower</function>
+        выдают предупреждение, если количество аргументов, которые им передают,
+        превышает количество аргументов, которые они ожидают, поэтому такие внутренние
+        функции нельзя указывать как значение параметра <parameter>callback</parameter>.
        </para>
       </note>
       <para>
-       Потенциально изменены могут быть только значения массива
-       <parameter>array</parameter>; структура самого массива не может
-       быть изменена, то есть нельзя добавить, удалить или поменять
-       порядок элементов. Если callback-функция не соответствует этому
-       требованию, поведение данной функции станет неопределённым и
-       непредсказуемым.
+       Разрешается изменять только значения массива
+       <parameter>array</parameter>; структуру самого массива изменить
+       нельзя. Программисту нельзя добавлять, удалять или изменять порядок
+       элементов. Поведение функции будет неопределённым и непредсказуемым,
+       если callback-функция не соответствует этому требованию.
       </para>
      </listitem>
     </varlistentry>
@@ -78,9 +77,9 @@
      <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-       Если указан необязательный параметр <parameter>arg</parameter>,
-       он будет передан в качестве третьего параметра в
-       callback-функцию <parameter>callback</parameter>.
+       Необязательный параметр <parameter>arg</parameter>,
+       передаётся в <parameter>callback</parameter>-функцию как третий аргумент,
+       если указали.
       </para>
      </listitem>
     </varlistentry>
@@ -91,19 +90,19 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает &true;
+   &return.true.always;
   </para>
  </refsect1>
 
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-   Начиная с PHP 7.1.0, в случае если <parameter>callback</parameter>-функция
-   требует больше двух параметров (значение и ключ элемента массива)
-   или более 3 параметров, если также передаётся параметр <parameter>arg</parameter>, будет
-   выброшено исключение <classname>ArgumentCountError</classname>. Ранее в таком
-   случае при каждом вызове <parameter>callback</parameter>, генерировалась
-   ошибка уровня <link linkend="errorfunc.constants">E_WARNING</link>.
+   Начиная с PHP 7.1.0 функция выбрасывает исключение <classname>ArgumentCountError</classname>,
+   если <parameter>callback</parameter>-функция требует больше двух параметров, тогда как передаются
+   только значение и ключ элемента массива, или больше 3 параметров, если также передаётся
+   аргумент <parameter>arg</parameter>. Раньше при таких условиях каждый раз, когда функция
+   <function>array_walk</function> вызывала <parameter>callback</parameter>-функцию
+   генерировалась ошибка уровня <link linkend="errorfunc.constants">E_WARNING</link>.
   </para>
  </refsect1>
 
@@ -118,11 +117,13 @@
      </row>
     </thead>
     <tbody>
+     &return.type.true;
      <row>
       <entry>8.0.0</entry>
       <entry>
-       Если параметр <parameter>callback</parameter> ожидает, что значение второго или третьего параметра будет передано по ссылке,
-       функция теперь выдаст ошибку уровня <constant>E_WARNING</constant>.
+       Теперь функция выдаёт ошибку уровня <constant>E_WARNING</constant>,
+       если параметр <parameter>callback</parameter> ожидает,
+       что значение второго или третьего аргумента передадут по ссылке.
       </entry>
      </row>
     </tbody>
@@ -134,10 +135,11 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Пример использования <function>array_walk</function></title>
+    <title>Пример использования функции <function>array_walk</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $fruits = array("d" => "lemon", "a" => "orange", "b" => "banana", "c" => "apple");
 
 function test_alter(&$item1, $key, $prefix)
@@ -157,6 +159,7 @@ array_walk($fruits, 'test_alter', 'fruit');
 echo "... и после:\n";
 
 array_walk($fruits, 'test_print');
+
 ?>
 ]]>
     </programlisting>
@@ -179,10 +182,11 @@ c. fruit: apple
   </para>
   <para>
    <example>
-    <title>Пример использования <function>array_walk</function> с анонимной функцией</title>
+    <title>Пример использования функции <function>array_walk</function> с анонимной функцией</title>
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $elements = ['a', 'b', 'c'];
 
 array_walk($elements, function ($value, $key) {