Files
doc-fr/reference/array/functions/array-diff-uassoc.xml
Yannick Torres 46728d9682 typo
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@189981 c90b9560-bf6c-de11-be94-00142212c4b1
2005-07-05 21:09:09 +00:00

123 lines
4.1 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.15 $ -->
<!-- EN-Revision: 1.7 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 clés sont utilisées dans les comparaisons, contrairement à
<function>array_diff</function>.
</para>
<para>
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 clé 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
-->