Update array-unshift.xml Инфостиль

reference/array/functions/array-unshift.xml

@@ -14,11 +14,11 @@
    <methodparam rep="repeat"><type>mixed</type><parameter>values</parameter></methodparam>
   </methodsynopsis>
   <para>
-   <function>array_unshift</function> добавляет переданные в качестве аргументов
-   элементы в начало массива <parameter>array</parameter>. Обратите внимание, что
-   список элементов добавляется целиком, то есть порядок элементов сохраняется.
-   Все числовые ключи будут изменены таким образом, что нумерация массива будет
-   начинаться с нуля, в то время как строковые ключи останутся прежними.
+   Функция <function>array_unshift</function> добавляет новые элементы
+   в начало массива <parameter>array</parameter>. Обратите внимание,
+   функция добавляет список элементов целиком, поэтому новые элементы остаются в то же порядке.
+   Числовые ключи массива изменятся так, чтобы нумерация начиналась
+   с нуля, тогда как литеральные ключи не изменятся.
   </para>
   &note.reset-index;
  </refsect1>
@@ -48,7 +48,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает новое количество элементов в <parameter>array</parameter>.
+   Функция возвращает новое количество элементов в массиве <parameter>array</parameter>.
   </para>
  </refsect1>
 
@@ -67,8 +67,7 @@
        <row>
         <entry>7.3.0</entry>
         <entry>
-         Теперь эта функция может быть вызвана с одним параметром. Ранее
-         требовалось минимум два параметра.
+         Функцию разрешили вызывать с одним аргументом. Раньше требовалось как минимум два аргумента.
         </entry>
        </row>
       </tbody>
@@ -81,17 +80,20 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Пример использования <function>array_unshift</function></title>
+    <title>Пример добавления элементов в начало массива функцией <function>array_unshift</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $queue = [
     "orange",
     "banana"
 ];
 
 array_unshift($queue, "apple", "raspberry");
+
 var_dump($queue);
+
 ?>
 ]]>
     </programlisting>
@@ -115,14 +117,15 @@ array(4) {
 
   <para>
    <example>
-    <title>Пример использования с ассоциативными массивами</title>
+    <title>Пример работы с ассоциативными массивами</title>
     <para>
-     Если один ассоциативный массив добавляется к другому ассоциативному массиву,
-     то добавляемый массив продолжает числовой индекс первого массиве.
+     Ассоциативный массив, который добавляется в начало другого ассоциативного массива,
+     получает числовой индекс в прежнем массиве.
     </para>
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $foods = [
     'apples' => [
         'McIntosh' => 'red',
@@ -133,6 +136,7 @@ $foods = [
         'Valencia' => 'orange',
     ],
 ];
+
 $vegetables = [
     'lettuce' => [
         'Iceberg' => 'green',
@@ -150,48 +154,50 @@ $vegetables = [
 
 array_unshift($foods, $vegetables);
 var_dump($foods);
+
+?>
 ]]>
     </programlisting>
     &example.outputs;
     <screen role="php">
 <![CDATA[
 array(3) {
-  [0] =>
+  [0]=>
   array(3) {
-    'lettuce' =>
+    ["lettuce"]=>
     array(2) {
-      'Iceberg' =>
+      ["Iceberg"]=>
       string(5) "green"
-      'Butterhead' =>
+      ["Butterhead"]=>
       string(5) "green"
     }
-    'carrots' =>
+    ["carrots"]=>
     array(2) {
-      'Deep Purple Hybrid' =>
+      ["Deep Purple Hybrid"]=>
       string(6) "purple"
-      'Imperator' =>
+      ["Imperator"]=>
       string(6) "orange"
     }
-    'cucumber' =>
+    ["cucumber"]=>
     array(2) {
-      'Kirby' =>
+      ["Kirby"]=>
       string(5) "green"
-      'Gherkin' =>
+      ["Gherkin"]=>
       string(5) "green"
     }
   }
-  'apples' =>
+  ["apples"]=>
   array(2) {
-    'McIntosh' =>
+    ["McIntosh"]=>
     string(3) "red"
-    'Granny Smith' =>
+    ["Granny Smith"]=>
     string(5) "green"
   }
-  'oranges' =>
+  ["oranges"]=>
   array(2) {
-    'Navel' =>
+    ["Navel"]=>
     string(6) "orange"
-    'Valencia' =>
+    ["Valencia"]=>
     string(6) "orange"
   }
 }