svn: /phpdoc/ru/trunk/reference/array/functions/ uasort.xml

From: Date: Fri, 04 Feb 2011 10:38:35 +0000
Subject: svn: /phpdoc/ru/trunk/reference/array/functions/ uasort.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1350@lists.php.net to get a copy of this message
shein Fri, 04 Feb 2011 10:38:35 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=308009 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/array/functions/uasort.xml Modified: phpdoc/ru/trunk/reference/array/functions/uasort.xml =================================================================== --- phpdoc/ru/trunk/reference/array/functions/uasort.xml 2011-02-04 10:36:35 UTC (rev 308008) +++ phpdoc/ru/trunk/reference/array/functions/uasort.xml 2011-02-04 10:38:35 UTC (rev 308009) @@ -1,46 +1,131 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: n/a Maintainer: sveta Status: ready --> +<!-- EN-Revision: 297028 Maintainer: shein Status: ready --> +<!-- Reviewed: no --> <!-- $Revision$ --> -<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> - <refentry xml:id="function.uasort" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>uasort</refname> - <refpurpose> - Отсортировать массив, используя пользовательскую функцию для сравнения элементов - с сохранением ключей - </refpurpose> - </refnamediv> - <refsect1> - <title>Описание</title> - <methodsynopsis> - <type>bool</type><methodname>uasort</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> - <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> - <para> - Функция сортирует массив таким образом, что его индексы - сохраняют отношения с элементами, с которыми ранее были ассоциированы. - Это особенно полезно при сортировке ассоциативных массивов, актуальный порядок - элементов которых значим. Для сравнения используется функция, определённая пользователем. - </para> - <para> - &return.success; - </para> - <note> - <para> - Пожалуйста, смотрите примеры пользовательских функций в описании - <function>usort</function> и <function>uksort</function>. - </para> - </note> - <para> - См. также <function>usort</function>, <function>uksort</function>, - <function>sort</function>, <function>asort</function>, - <function>arsort</function>, <function>ksort</function> - и <function>rsort</function>. - </para> - </refsect1> - </refentry> +<refentry xml:id="function.uasort" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>uasort</refname> + <refpurpose>Сортирует массив, используя пользовательскую функцию для сравнения элементов с сохранением ключей</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>uasort</methodname> + <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> + <para> + Эта функция сортирует массив таким образом, что его индексы + сохраняют отношения с элементами, с которыми ранее были ассоциированы, + с помощью callback-функции, предоставленной пользователем. + </para> + <para> + Это обычно используется при сортировке ассоциативных массивов, в которых + важен актуальный порядок элементов. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array</parameter></term> + <listitem> + <para> + Входной массив. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cmp_function</parameter></term> + <listitem> + <para> + Смотрите функции <function>usort</function> и <function>uksort</function> для + примеров callback-функций сортировки, предоставленных пользователем. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Простой пример использования <function>uasort</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Функция сравнения +function cmp($a, $b) { + if ($a == $b) { + return 0; + } + return ($a < $b) ? -1 : 1; +} + +// Сортируемый массив +$array = array('a' => 4, 'b' => 8, 'c' => -1, 'd' => -9, 'e' => 2, 'f' => 5, 'g' => 3, 'h' => -4); +print_r($array); + +// Сортируем и выводим получившийся массив +uasort($array, 'cmp'); +print_r($array); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Array +( + [a] => 4 + [b] => 8 + [c] => -1 + [d] => -9 + [e] => 2 + [f] => 5 + [g] => 3 + [h] => -4 +) +Array +( + [d] => -9 + [h] => -4 + [c] => -1 + [e] => 2 + [g] => 3 + [a] => 4 + [f] => 5 + [b] => 8 +) +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>usort</function></member> + <member>&seealso.array.sorting;</member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -52,7 +137,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 (#1350) next »