cvs: phpdoc-fr /reference/array/functions array-diff-assoc.xml array-intersect-assoc.xml
| From: | Damien Seguy | Date: | Thu, 06 Feb 2003 04:02:43 +0000 |
| Subject: | cvs: phpdoc-fr /reference/array/functions array-diff-assoc.xml array-intersect-assoc.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-216@lists.php.net to get a copy of this message | ||
dams Wed Feb 5 23:02:43 2003 EDT
Added files:
/phpdoc-fr/reference/array/functions array-diff-assoc.xml
array-intersect-assoc.xml
Log:
commiting last files
Index: phpdoc-fr/reference/array/functions/array-diff-assoc.xml
+++ phpdoc-fr/reference/array/functions/array-diff-assoc.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/array.xml, last change in rev 1.14 -->
<refentry id="function.array-diff-assoc">
<refnamediv>
<refname>array_diff_assoc</refname>
<refpurpose>Calcule la différence de deux tableaux, en prenant en compte les
clés</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>
</methodsynopsis>
<para>
<function>array_diff_assoc</function> retourne un tableau contenant
les valeurs du tableau <parameter>array1</parameter>
qui ne sont présente dans aucun autre argument. Notez que les
clés sont utilisées durant la comparaison, contrairement
à <function>array_diff</function>.
</para>
<para>
<example>
<title>Exemple avec <function>array_diff_assoc</function></title>
<programlisting role="php">
<![CDATA[
<?php
$array1 = array ("a" => "vert", "b" => "brun",
"c" => "bleu", "rouge");
$array2 = array ("a" => "vert", "jaune", "rouge");
$result = array_diff_assoc ($array1, $array2);
/* Le résultat est :
Array
(
[b] => brun
[c] => bleu
[0] => rouge
)
*/
?>
]]>
</programlisting>
</example>
</para>
<simpara>
Dans notre exemple ci-dessu, vous pouvez voir que la paire <literal>"a"
=> "vert"</literal>
est présente dans les deux tableaux, et donc, n'est pas présente
dans le
résultat de la fonction. Au contraire, la paire <literal>0 =>
"rouge"</literal>
est présente dans le résultat, car le second argument
<literal>"rouge"</literal>
possède une clé qui est <literal>1</literal>.
</simpara>
<simpara>
Les deux valeurs de la paire <literal>clé => valeur</literal>
sont
considérées égales uniquement si <literal>(string)
$elem1 === (string) $elem2</literal>.
En d'autre termes, une comparaison stricte est faite sur les représentation
des index, avec le type chaîne.
<!-- TODO: example of it... -->
</simpara>
<note>
<simpara>
Notez bien que cette fonction ne travaille que sur une dimension
de tableau. Bien sur, vous pouvez utiliser des sous dimensions de tableau
comme ceci : <literal>array_diff_assoc($array1[0], $array2[0]);</literal>.
</simpara>
</note>
<para>
Voir aussi
<function>array_diff</function>,
<function>array_intersect</function> et
<function>array_intersect_assoc</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
-->
Index: phpdoc-fr/reference/array/functions/array-intersect-assoc.xml
+++ phpdoc-fr/reference/array/functions/array-intersect-assoc.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.array-intersect-assoc">
<refnamediv>
<refname>array_intersect_assoc</refname>
<refpurpose>Calcule l'intersection de deux tableaux avec des tests sur les
index</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>array</type><methodname>array_intersect_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>
</methodsynopsis>
<simpara>
<function>array_intersect_assoc</function> retourne un tableau contenant
toutes les valeurs de <parameter>array1</parameter> qui sont aussi
présentes dans tous les autres arguments. Notez que les clés sont
utilisées
durant la comparaison, contrairement à
<function>array_intersect</function>.
</simpara>
<para>
<example>
<title>Exemple avec <function>array_intersect_assoc</function></title>
<programlisting role="php">
<![CDATA[
<?php
$array1 = array ("a" => "vert", "b" => "brun",
"c" => "bleu", "rouge");
$array2 = array ("a" => "vert", "jaune", "rouge");
$result_array = array_intersect_assoc ($array1, $array2);
/* $result_array ressemble à ceci :
Array
(
[a] => vert
)
*/
?>
]]>
</programlisting>
</example>
</para>
<simpara>
Dans notre exemple, vous pouvez voir que la paire
<literal>"a" => "vert"</literal> est présente
dans les deux tableaux,
et donc placée dans le dernier tableau. La valeur
<literal>rouge</literal> n'est pas retournée car dans
<varname>$array1</varname> son index est <literal>2</literal> tandis
que
dans le tableau <varname>$array2</varname>, son index est
<literal>1</literal>.
</simpara>
<simpara>
Les deux valeurs de la paire <literal>clé => valeur</literal>
sont
considérées égales uniquement si <literal>(string)
$elem1 === (string) $elem2</literal>.
En d'autre termes, une comparaison stricte est faite sur les représentation
des index, avec le type chaîne.
<!-- TODO: example of it... -->
</simpara>
<simpara>
Voir aussi
<function>array_diff</function> et
<function>array_intersect</function>.
</simpara>
</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
-->