svn: /phpdoc/ru/trunk/reference/array/functions/ array-reduce.xml

From: 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

« previous php.doc.ru (#1304) next »