cvs: phpdoc-fa /reference/array/functions array-diff-key.xml

psalehpoor Thu Jun 25 13:46:30 2009 UTC Added files: /phpdoc-fa/reference/array/functions array-diff-key.xml Log: translated to persian http://cvs.php.net/viewvc.cgi/phpdoc-fa/reference/array/functions/array-diff-key.xml?view=markup&rev=1.1 Index: phpdoc-fa/reference/array/functions/array-diff-key.xml +++ phpdoc-fa/reference/array/functions/array-diff-key.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.5 Maintainer: pedram Status: ready --> <!-- $Revision: 1.1 $ --> <refentry xml:id="function.array-diff-key" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>array_diff_key</refname> <refpurpose>تفاوت آرایه‌ها را با استفاده از مقایسه کلیدها محاسبه می‌کند</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>array_diff_key</methodname> <methodparam><type>array</type><parameter>array1</parameter></methodparam> <methodparam><type>array</type><parameter>array2</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>...</parameter></methodparam> </methodsynopsis> <para> کلید‌ها را از <parameter>array1</parameter> نسبت به کلیدهای <parameter>array2</parameter> مقایسه می‌کند و تفاوت را باز می‌گرداند. این تابع همانند <function>array_diff</function> است به جر این که کلیدها برای مقایسه استفاده می‌شوند. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>array1</parameter></term> <listitem> <para> آرایه اول برای مقایسه </para> </listitem> </varlistentry> <varlistentry> <term><parameter>array2</parameter></term> <listitem> <para> آرایه دوم برای مقایسه نسبت به </para> </listitem> </varlistentry> <varlistentry> <term><parameter>...</parameter></term> <listitem> <para> آرایه‌های بیشتر برای مقایسه </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <type>array</type> شامل تمام ورودی‌های <parameter>array1</parameter> که در دیگر آرایه‌ها نیستند باز می‌گرداند. </para> </refsect1> <!-- <refsect1 role="errors"> &reftitle.errors; &errors.no.unusual.errors; </refsect1> --> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>مثال <function>array_diff_key</function></title> <para> دو کلید از جفت‌های <literal>key =&gt; value</literal> برابر با یکدیگر در نظر گرفته می‌شوند اگر <literal>(string) $key1 === (string) $key2 </literal> باشد. به عبارت دیگر یک بررسی نوع دقیق برای یکی بودن نمایش رشته‌ها انجام می‌شود. </para> <programlisting role="php"> <![CDATA[ <?php $array1 = array('blue' => 1, 'red' => 2, 'green' => 3, 'purple' => 4); $array2 = array('green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan' => 8); var_dump(array_diff_key($array1, $array2)); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array(2) { ["red"]=> int(2) ["purple"]=> int(4) } ]]> </screen> </example> </para> </refsect1> <refsect1 role="notes"> &reftitle.notes; <note> <para> این تابع تنها یک بعد از یک آرایه n-بعدی را بررسی می‌کند. البته برای بررسی عمیق‌تر می‌توانید از <literal>array_diff_key($array1[0], $array2[0]);</literal> استفاده کنید. </para> </note> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>array_diff</function></member> <member><function>array_udiff</function></member> <member><function>array_diff_assoc</function></member> <member><function>array_diff_uassoc</function></member> <member><function>array_udiff_assoc</function></member> <member><function>array_udiff_uassoc</function></member> <member><function>array_diff_ukey</function></member> <member><function>array_intersect</function></member> <member><function>array_intersect_assoc</function></member> <member><function>array_intersect_uassoc</function></member> <member><function>array_intersect_key</function></member> <member><function>array_intersect_ukey</function></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 -->