Files
doc-fr/reference/array/functions/array-diff-uassoc.xml
Yannick Torres 3c0f5fefbb use more entities
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@171861 c90b9560-bf6c-de11-be94-00142212c4b1
2004-11-01 17:48:59 +00:00

120 lines
4.1 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
<!-- EN-Revision: 1.6 Maintainer: dams Status: ready -->
<refentry id="function.array-diff-uassoc">
<refnamediv>
<refname>array_diff_uassoc</refname>
<refpurpose>
Calcule la différence entre deux tableaux associatifs,
à l'aide d'une fonction utilisateur
</refpurpose>
</refnamediv>
<refsect1>
&reftitle.description;
<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> retourne un <type>array</type>
contenant toutes les valeurs de <parameter>array1</parameter>
qui ne sont pas présentes dans l'un des autres arguments
<parameter>array2</parameter>, <parameter>...</parameter>, etc.
Notez que les clefs sont utilisées dans les comparaisons, contrairement à
<function>array_diff</function>. Cette comparaison est effectuée avec la
fonction callback <parameter>key_compare_func</parameter>.
Cette fonction doit retourner un entier plus petit que, égal à, ou plus
grand que zéro si le premier argument est respectivement plus petit que,
égal au, ou plus grand que le second. Ce comportement est différent de
celui de <function>array_diff_assoc</function> où une fonction interne de
comparaison des index est utilisée.
</para>
<para>
<example>
<title>Exemple avec <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" => "vert", "b" => "marron", "c" => "bleu", "rouge");
$array2 = array("a" => "vert", "jaune", "rouge");
$result = array_diff_uassoc($array1, $array2, "key_compare_func");
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Array
(
[b] => marron
[c] => bleu
[0] => rouge
)
]]>
</screen>
</example>
</para>
<simpara>
Dans notre exemple, vous voyez que la paire <literal>"a" =&gt; "vert"</literal>
est présente dans les deux tableaux et donc ne figure pas dans le
résultat de la fonction. Contrairement à cela, la paire <literal>0 =&gt; "rouge"</literal>
est dans le résultat car dans le second argument, la clef de <literal>"rouge"</literal>
est &one;.
</simpara>
<simpara>
L'égalité de deux indices est vérifiée par la fonction utilisateur.
</simpara>
<note>
<simpara>
Notez que cette fonction ne vérifie qu'une seule dimension d'un tableau
multi-dimensionnel. Vous pouvez, bien sûr, tester une dimension
particulière en utilisant par exemple,
<literal>array_diff_uassoc($array1[1], $array2[1], "key_compare_func");</literal>.
</simpara>
</note>
<para>
Voir aussi
<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> et
<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
-->