cvs: phpdoc-fa /reference/array/functions uasort.xml uksort.xml

psalehpoor Fri May 29 08:56:06 2009 UTC Added files: /phpdoc-fa/reference/array/functions uasort.xml uksort.xml Log: translation to persian http://cvs.php.net/viewvc.cgi/phpdoc-fa/reference/array/functions/uasort.xml?view=markup&rev=1.1 Index: phpdoc-fa/reference/array/functions/uasort.xml +++ phpdoc-fa/reference/array/functions/uasort.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.13 Maintainer: pedram Status: ready --> <!-- $Revision: 1.1 $ --> <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> این تابع اندیس‌های آرایه را مرتب می‌کند اما ارتباط آنها را با موارد حفظ می‌کند. مقایسه توسط یک تابع مقایسه تعریف شده توسط کاربر انجام می‌شود. </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> را برای مثال‌های تابع مقایسه تعریف شده توسط کاربر ببینید. </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 // Comparison function function cmp($a, $b) { if ($a == $b) { return 0; } return ($a < $b) ? -1 : 1; } // Array to be sorted $array = array('a' => 4, 'b' => 8, 'c' => -1, 'd' => -9, 'e' => 2, 'f' => 5, 'g' => 3, 'h' => -4); print_r($array); // Sort and print the resulting 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 sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fa/reference/array/functions/uksort.xml?view=markup&rev=1.1 Index: phpdoc-fa/reference/array/functions/uksort.xml +++ phpdoc-fa/reference/array/functions/uksort.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.24 Maintainer: pedram Status: ready --> <!-- $Revision: 1.1 $ --> <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> تابع مقایسه. </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) { $a = preg_replace('@^(a|an|the) @', '', $a); $b = preg_replace('@^(a|an|the) @', '', $b); return strcasecmp($a, $b); } $a = array("John" => 1, "the Earth" => 2, "an apple" => 3, "a banana" => 4); uksort($a, "cmp"); foreach ($a as $key => $value) { echo "$key: $value\n"; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ an apple: 3 a banana: 4 the Earth: 2 John: 1 ]]> </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 sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->