Files
doc-fr/reference/array/functions/array-diff-uassoc.xml
Damien Seguy ea42f58b58 turning entites into chars
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@147452 c90b9560-bf6c-de11-be94-00142212c4b1
2003-12-29 17:04:50 +00:00

119 lines
4.0 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- 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>Calcule la différence entre deux tableaux associatifs,
à l'aide d'une fonction utilisateur</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>array</type><methodname>array_diff_assoc</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.
Notez que les clefs sont utilisées dans les comparaisons contrairement à
<function>array_diff</function>. Cette comparaison est effectuée par une
fonction callback de l'utilisateur.
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" => "green", "b" => "brown", "c" => "blue", "red");
$array2 = array("a" => "green", "yellow", "red");
$result = array_diff_uassoc($array1, $array2, "key_compare_func");
?>
]]>
</programlisting>
<para>
Le résultat est :
</para>
<screen>
<![CDATA[
Array
(
[b] => brown
[c] => blue
[0] => red
)
]]>
</screen>
</example>
</para>
<simpara>
Dans notre exemple, vous voyez que la paire <literal>"a" =&gt; "green"</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; "red"</literal>
est dans le résultat car dans le second argument, la clef de <literal>"red"</literal>
est <literal>1</literal>.
</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
-->