svn: /phpdoc/ru/trunk/reference/array/functions/ array-reduce.xml
| From: | Shein Alexey | Date: | Sun, 30 Jan 2011 09:12:25 +0000 |
| Subject: | svn: /phpdoc/ru/trunk/reference/array/functions/ array-reduce.xml | ||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-1304@lists.php.net to get a copy of this message | ||
shein Sun, 30 Jan 2011 09:12:25 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=307849
Log:
Updated translation.
Changed paths:
U phpdoc/ru/trunk/reference/array/functions/array-reduce.xml
Modified: phpdoc/ru/trunk/reference/array/functions/array-reduce.xml
===================================================================
--- phpdoc/ru/trunk/reference/array/functions/array-reduce.xml 2011-01-30 09:04:21 UTC (rev 307848)
+++ phpdoc/ru/trunk/reference/array/functions/array-reduce.xml 2011-01-30 09:12:25 UTC (rev 307849)
@@ -2,43 +2,109 @@
<!-- EN-Revision: n/a Maintainer: sveta Status: ready -->
<!-- $Revision$ -->
<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
- <refentry xml:id="function.array-reduce" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>array_reduce</refname>
- <refpurpose>
- Итеративно уменьшить массив к единственному
значению, используя
- функцию обратного вызова
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Описание</title>
- <methodsynopsis>
- <type>mixed</type><methodname>array_reduce</methodname>
-
<methodparam><type>array</type><parameter>input</parameter></methodparam>
-
<methodparam><type>callback</type><parameter>function</parameter></methodparam>
- <methodparam
choice="opt"><type>int</type><parameter>initial</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>array_reduce</function> итеративно применяет
функцию
- <parameter>function</parameter> к элементам массива
- <parameter>input</parameter> и, таким образом, сводит
массив
- к единственному значению. Если указан
дополнительный параметр
- <parameter>initial</parameter>, он будет использован в
начале процесса,
- или в качестве окончательного результата, если
массив пуст.
- </para>
- <para>
- <example>
- <title>Пример
использования<function>array_reduce</function></title>
- <programlisting role="php">
+<refentry xml:id="function.array-reduce" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>array_reduce</refname>
+ <refpurpose>Итеративно уменьшает массив к
единственному значению, используя
callback-функцию</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>array_reduce</methodname>
+
<methodparam><type>array</type><parameter>input</parameter></methodparam>
+
<methodparam><type>callback</type><parameter>function</parameter></methodparam>
+ <methodparam
choice="opt"><type>mixed</type><parameter>initial</parameter><initializer>&null;</initializer></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>array_reduce</function> итеративно применяет
callback-функцию
+ <parameter>function</parameter> к элементам массива
+ <parameter>input</parameter> и, таким образом, сводит
массив
+ к единственному значению.
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>input</parameter></term>
+ <listitem>
+ <para>
+ Входной массив.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>function</parameter></term>
+ <listitem>
+ <para>
+ Callback-функция.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>initial</parameter></term>
+ <listitem>
+ <para>
+ Если передан необязательный параметр
<parameter>initial</parameter>,
+ то он будет использован в начале процесса, или в
качестве
+ окончательного результата в случае пустого
массива.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Возвращает получившееся значение.
+ </para>
+ <para>
+ Если массив пуст и не передан параметр
<parameter>initial</parameter>,
+ <function>array_reduce</function> вернет &null;.
+ </para>
+ </refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.3.0</entry>
+ <entry>
+ Параметр <parameter>initial</parameter> теперь позволяет
+ передать <type>mixed</type>, ранее передавался
только
+ <type>integer</type>.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>Пример
использования<function>array_reduce</function></title>
+ <programlisting role="php">
<![CDATA[
<?php
-function rsum($v, $w)
+function rsum($v, $w)
{
$v += $w;
return $v;
}
-function rmul($v, $w)
+function rmul($v, $w)
{
$v *= $w;
return $v;
@@ -48,26 +114,31 @@
$x = array();
$b = array_reduce($a, "rsum");
$c = array_reduce($a, "rmul", 10);
-$d = array_reduce($x, "rsum", 1);
+$d = array_reduce($x, "rsum", "No data to reduce");
?>
]]>
- </programlisting>
- </example>
- </para>
+ </programlisting>
<para>
В результате переменная <varname>$b</varname>
содержит
<literal>15</literal>, <varname>$c</varname> содержит
- <literal>1200</literal> (= 1*2*3*4*5*10), и
- <varname>$d</varname> содержит <literal>1</literal>.
+ <literal>1200</literal> (= 10*1*2*3*4*5*10), и
+ <varname>$d</varname> содержит <literal>No data to
reduce</literal>.
</para>
- <para>
- См. также <function>array_filter</function>,
- <function>array_map</function>,
- <function>array_unique</function>, и
- <function>array_count_values</function>.
- </para>
- </refsect1>
- </refentry>
+ </example>
+ </para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>array_filter</function></member>
+ <member><function>array_map</function></member>
+ <member><function>array_unique</function></member>
+ <member><function>array_count_values</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
@@ -80,7 +151,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../~/.phpdoc/manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil