cvs: phpdoc-ru /reference/array/functions array-diff-key.xml array-diff-uassoc.xml array-diff-ukey.xml

sveta Sun Apr 24 11:31:56 2005 EDT Added files: /phpdoc-ru/reference/array/functions array-diff-key.xml array-diff-ukey.xml array-diff-uassoc.xml Log: new translation

http://cvs.php.net/co.php/phpdoc-ru/reference/array/functions/array-diff-key.xml?r=1.1&p=1 Index: phpdoc-ru/reference/array/functions/array-diff-key.xml +++ phpdoc-ru/reference/array/functions/array-diff-key.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.2 Maintainer: sveta Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.array-diff-key"> <refnamediv> <refname>array_diff_key</refname> <refpurpose>Вычислить расхождение в массивах, сравнивая ключи</refpurpose> </refnamediv> <refsect1> <title>Описание</title> <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> <function>array_diff_key</function> возвращает массив, содержащий все значения <parameter>array1</parameter>, имеющие ключи, не содержащиеся в последующих параметрах. Обратите внимание, что ассоциации сохраняются. Эта функция схожа с <function>array_diff</function> за исключением того, что сравниваются ключи, а не значения. </para> <para> <example> <title>Пример использования <function>array_diff_key</function></title> <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> <simpara> Два ключа пар <literal>key =&gt; value</literal> считаются равными только, если <literal>(string) $key1 === (string) $key2 </literal>. Другими словами, строгая проверка считает, что строковое представление должно быть идентичным. </simpara> <note> <simpara> Обратите внимание, что эта функция обрабатывает только одно измерение n-размерного массива. Естественно, вы можете обрабатывать и более глубокие уровни вложенности, например, используя <literal>array_diff_key($array1[0], $array2[0]);</literal>. </simpara> </note> <para> См. также <function>array_diff</function>, <function>array_udiff</function> <function>array_diff_assoc</function>, <function>array_diff_uassoc</function>, <function>array_udiff_assoc</function>, <function>array_udiff_uassoc</function>, <function>array_diff_ukey</function>, <function>array_intersect</function>, <function>array_intersect_assoc</function>, <function>array_intersect_uassoc</function>, <function>array_intersect_key</function> и <function>array_intersect_ukey</function>. </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/co.php/phpdoc-ru/reference/array/functions/array-diff-ukey.xml?r=1.1&p=1 Index: phpdoc-ru/reference/array/functions/array-diff-ukey.xml +++ phpdoc-ru/reference/array/functions/array-diff-ukey.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.3 Maintainer: sveta Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.array-diff-ukey"> <refnamediv> <refname>array_diff_ukey</refname> <refpurpose>Вычислить расхождение в массивах, используя функцию обратного вызова для сравнения ключей</refpurpose> </refnamediv> <refsect1> <title>Описание</title> <methodsynopsis> <type>array</type><methodname>array_diff_ukey</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> <methodparam><type>callback</type><parameter>key_compare_func</parameter></methodparam> </methodsynopsis> <para> <function>array_diff_ukey</function> возвращает массив, содержащий все значения <parameter>array1</parameter>, имеющие ключи, не содержащиеся в последующих параметрах. Обратите внимание, что ассоциации сохраняются. Эта функция схожа с <function>array_diff</function> за исключением того, что сравниваются ключи, а не значения. </para> <para> Для сравнения используется функция, определённая пользователем. Она должна возвращать целое число меньшее, равное или большее нуля, если первый ключ, соответственно, меньше, равен или больше второго. </para> <para> <example> <title>Пример использования <function>array_diff_ukey</function></title> <programlisting role="php"> <![CDATA[ <?php function key_compare_func($key1, $key2) { if ($key1 == $key2) return 0; else if ($key1 > $key2) return 1; else return -1; } $array1 = array('blue' => 1, 'red' => 2, 'green' => 3, 'purple' => 4); $array2 = array('green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan' => 8); var_dump(array_diff_ukey($array1, $array2, 'key_compare_func')); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array(2) { ["red"]=> int(2) ["purple"]=> int(4) } ]]> </screen> </example> </para> <note> <simpara> Обратите внимание, что эта функция обрабатывает только одно измерение n-размерного массива. Естественно, вы можете обрабатывать и более глубокие уровни вложенности, например, используя <literal>array_diff_ukey($array1[0], $array2[0], 'callback_func');</literal>. </simpara> </note> <para> См. также <function>array_diff</function>, <function>array_udiff</function> <function>array_diff_assoc</function>, <function>array_diff_uassoc</function>, <function>array_udiff_assoc</function>, <function>array_udiff_uassoc</function>, <function>array_diff_key</function>, <function>array_intersect</function>, <function>array_intersect_assoc</function>, <function>array_intersect_uassoc</function>, <function>array_intersect_key</function> и <function>array_intersect_ukey</function>. </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/co.php/phpdoc-ru/reference/array/functions/array-diff-uassoc.xml?r=1.1&p=1 Index: phpdoc-ru/reference/array/functions/array-diff-uassoc.xml +++ phpdoc-ru/reference/array/functions/array-diff-uassoc.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.7 Maintainer: sveta Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.14 --> <refentry id="function.array-diff-uassoc"> <refnamediv> <refname>array_diff_uassoc</refname> <refpurpose> Вычислить расхождение в массивах с дополнительной проверкой индекса, осуществляемой при помощи функции, определённой пользователем </refpurpose> </refnamediv> <refsect1> <title>Описание</title> <methodsynopsis> <type>array</type><methodname>array_diff_uassoc</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> <methodparam><type>callback</type><parameter>key_compare_func</parameter></methodparam> </methodsynopsis> <para> <function>array_diff_uassoc</function> возвращает <type>array</type>, содержащий все значения <parameter>array1</parameter>, не содержащиеся в последующих параметрах. Обратите внимание, что в отличие от <function>array_diff</function>, для сравнения используются ключи. </para> <para> Для сравнения используется функция, определённая пользователем. Она должна возвращать целое число меньшее, равное или большее нуля, если первый параметр, соответственно, меньше, равен или больше второго. В отличие от <function>array_diff_assoc</function>, использующей для сравнения встроенную функцию. </para> <para> <example> <title>Пример использования <function>array_diff_uassoc</function></title> <programlisting role="php"> <![CDATA[ <?php function key_compare_func($a, $b) { if ($a === $b) { return 0; } return ($a > $b)? 1:-1; } $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red"); $array2 = array("a" => "green", "yellow", "red"); $result = array_diff_uassoc($array1, $array2, "key_compare_func"); print_r($result); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Array ( [b] => brown [c] => blue [0] => red ) ]]> </screen> </example> </para> <simpara> В нашем примере пара <literal>"a" =&gt; "green"</literal> существует в обоих массивах и поэтому не присутствует в выводе функции. Наоборот, пара <literal>0 =&gt; "red"</literal> присутствует в выводе, потому что во втором аргументе значению <literal>"red"</literal> соответствует ключ <literal>1</literal>. </simpara> <simpara> Равенство двух индексов проверяется при помощи функции, определённой пользователем. </simpara> <note> <simpara> Обратите внимание, что эта функция обрабатывает только одно измерение n-размерного массива. Естественно, вы можете обрабатывать и более глубокие уровни вложенности, например, используя <literal>array_diff_uassoc($array1[0], $array2[0], "key_compare_func");</literal>. </simpara> </note> <para> См. также <function>array_diff</function>, <function>array_diff_assoc</function>, <function>array_udiff</function>, <function>array_udiff_assoc</function>, <function>array_udiff_uassoc</function>, <function>array_intersect</function>, <function>array_intersect_assoc</function>, <function>array_uintersect</function>, <function>array_uintersect_assoc</function> и <function>array_uintersect_uassoc</function>. </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 -->