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

From: Date: Fri, 04 Feb 2011 10:42:43 +0000
Subject: svn: /phpdoc/ru/trunk/reference/array/functions/ uksort.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1351@lists.php.net to get a copy of this message
shein Fri, 04 Feb 2011 10:42:43 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=308010 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/array/functions/uksort.xml Modified: phpdoc/ru/trunk/reference/array/functions/uksort.xml =================================================================== --- phpdoc/ru/trunk/reference/array/functions/uksort.xml 2011-02-04 10:38:35 UTC (rev 308009) +++ phpdoc/ru/trunk/reference/array/functions/uksort.xml 2011-02-04 10:42:43 UTC (rev 308010) @@ -1,78 +1,110 @@ <?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.uksort" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>uksort</refname> - <refpurpose> - Отсортировать массив по ключам, используя пользовательскую функцию для сравнения ключей - </refpurpose> - </refnamediv> - <refsect1> - <title>Описание</title> - <methodsynopsis> - <type>bool</type><methodname>uksort</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> - <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> - <para> - <function>uksort</function> отсортирует массив, используя для сравнения - его ключей функцию, определённую пользователем. Если массив должен быть отсортирован - по какому-либо необычному признаку, вы должны использовать эту функцию. - </para> - <para> - Функция <parameter>cmp_function</parameter> должна принимать два параметра, - которым будут присвоены значения двух ключей <parameter>array</parameter>. - Функция, используемая для сравнения, должна возвращать целое число, меньшее, равное - или большее нуля, если первый параметр считается меньше, равен или больше второго. - </para> - <para> - &return.success; - </para> - <para> - <example> - <title>Пример использования <function>uksort</function></title> - <programlisting role="php"> +<refentry xml:id="function.uksort" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>uksort</refname> + <refpurpose>Сортирует массив по ключам, используя пользовательскую функцию для сравнения ключей</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>uksort</methodname> + <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> + <para> + <function>uksort</function> отсортирует массив, используя для сравнения + его ключей функцию, предоставленную пользователем. Используйте эту + функцию, если массив должен быть отсортирован по какому-нибудь + необычному признаку. + </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> + Callback-функция, используемая для сравнения. + </para> + <para> + Функция <parameter>cmp_function</parameter> должна принимать + два параметра, которым будут присвоены значения двух ключей + <parameter>array</parameter>. + Функция, используемая для сравнения, должна возвращать целое + число, меньшее, равное или большее нуля, если первый параметр + должен быть меньше, равен или больше второго. + </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>uksort</function></title> + <programlisting role="php"> <![CDATA[ <?php -function cmp($a, $b) +function cmp($a, $b) { - if ($a == $b) { - return 0; - } - return ($a > $b) ? -1 : 1; + $a = preg_replace('@^(a|an|the) @', '', $a); + $b = preg_replace('@^(a|an|the) @', '', $b); + return strcasecmp($a, $b); } -$a = array(4 => "four", 3 => "three", 20 => "twenty", 10 => "ten"); +$a = array("John" => 1, "the Earth" => 2, "an apple" => 3, "a banana" => 4); uksort($a, "cmp"); -while (list($key, $value) = each($a)) { +foreach ($a as $key => $value) { echo "$key: $value\n"; } ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ -20: twenty -10: ten -4: four -3: three +an apple: 3 +a banana: 4 +the Earth: 2 +John: 1 ]]> - </screen> - </example> - </para> - <para> - См. также <function>usort</function>, <function>uasort</function>, - <function>sort</function>, <function>asort</function>, - <function>arsort</function>, <function>ksort</function>, - <function>natsort</function> и <function>rsort</function>. - </para> - </refsect1> - </refentry> + </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: @@ -85,7 +117,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 (#1351) next »