doc-fr/reference/array/functions/array-unique.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d8d97da74f7e3495d66b09c7a8805aede75c4cfb Maintainer: yannick Status: ready -->
<!-- CREDITS: DavidA. -->

<refentry xml:id="function.array-unique" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>array_unique</refname>
  <refpurpose>Dédoublonne un tableau</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>array</type><methodname>array_unique</methodname>
   <methodparam><type>array</type><parameter>array</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter><initializer>SORT_STRING</initializer></methodparam>
  </methodsynopsis>
  <para>
   <function>array_unique</function> extrait du tableau 
   <parameter>array</parameter> les valeurs distinctes,
   et supprime tous les doublons.
  </para>
  <para>
   Notez que les clés sont préservées. Si plusieurs éléments comparés
   sont égaux sous le <parameter>sort_flags</parameter> donné, alors la clé
   et la valeur du premier élément égal sera conservé.
  </para>
  <note>
   <simpara>
    Deux éléments sont considérés comme égaux si et seulement si
    <literal>(string) $elem1 === (string) $elem2</literal>, i.e.
    lorsque la représentation en chaîne de caractères est identique.
   </simpara>
  </note>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>array</parameter></term>
     <listitem>
      <para>
       Le tableau d'entrée.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>sort_flags</parameter></term>
     <listitem>
      <para>
       Le second paramètre optionnel <parameter>sort_flags</parameter>
       peut être utilisé pour modifier la façon dont s'effectue le tri
       en utilisant les valeurs suivantes :
      </para>
      <para>
       Drapeau de type de tri :
       <itemizedlist>
        <listitem>
         <simpara><constant>SORT_REGULAR</constant> - compare les éléments normalement
         (ne modifie pas les types)</simpara>
        </listitem>
        <listitem>
         <simpara><constant>SORT_NUMERIC</constant> - compare les éléments 
         numériquement</simpara>
        </listitem>
        <listitem>
         <simpara><constant>SORT_STRING</constant> - compare les éléments comme des 
         chaînes</simpara>
        </listitem>
        <listitem>
         <simpara><constant>SORT_LOCALE_STRING</constant> - compare les éléments comme
         des chaînes, suivant la locale courante.
         </simpara>
        </listitem>
       </itemizedlist>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retourne le tableau filtré.
  </para>
 </refsect1>


 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>7.2.0</entry>
       <entry>
        Si <parameter>sort_flags</parameter> est <constant>SORT_STRING</constant>,
        précedement <parameter>array</parameter> était copié et les éléments
        non-unique était supprimé (sans compréser le tableau après), mais
        maintenant un nouveau tableau est construit en ajoutant les éléments unique.
        Par conséquence le résultat final peut avoir des index numérique différent.
       </entry>
      </row>
      <row>
       <entry>5.2.10</entry>
       <entry>
        Changement de la valeur par défaut de <parameter>sort_flags</parameter> 
        à nouveau vers <constant>SORT_STRING</constant>.
       </entry>
      </row>
      <row>
       <entry>5.2.9</entry>
       <entry>
        Ajout du paramètre optionnel <parameter>sort_flags</parameter>,
        qui vaut par défaut <constant>SORT_REGULAR</constant>. Avant 5.2.9,
        cette fonction utilisait par défaut <constant>SORT_STRING</constant>,
        en interne.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Exemple avec <function>array_unique</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$input = array("a" => "green", "red", "b" => "green", "blue", "red");
$result = array_unique($input);
print_r($result);
?>
]]>
    </programlisting>
    &example.outputs;
    <screen role="php">
<![CDATA[
Array
(
    [a] => green
    [0] => red
    [1] => blue
)
]]>
    </screen>
   </example>
  </para>
  <para>
   <example>
    <title>Exemple avec <function>array_unique</function> et les types</title>
    <programlisting role="php">
<![CDATA[
<?php
$input = array(4, "4", "3", 4, 3, "3");
$result = array_unique($input);
var_dump($result);
?>
]]>
    </programlisting>
    &example.outputs;
    <screen role="php">
<![CDATA[
array(2) {
  [0] => int(4)
  [2] => string(1) "3"
}
]]>
    </screen>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>array_count_values</function></member>
   </simplelist>
  </para>
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <simpara>
    Notez que <function>array_unique</function> ne fonctionne pas
    avec des tableaux multi-dimensionnels.
   </simpara>
  </note>
 </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:"~/.phpdoc/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
-->