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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d5e635d12d50d89660a61a02dde143a7d6296d0b Maintainer: jpauli Status: ready -->
<!-- Reviewed: yes -->

<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. <function>array_unique</function>
   trie les valeurs traitées comme des chaînes dans un premier temps, puis
   garde la première clé rencontrée pour chaque valeur et ignore les clés
   suivantes. Cela ne signifie pas que la clé de la première valeur
   rencontrée du tableau <parameter>array</parameter> non trié sera
   conservée.
  </para>
  <note>
   <simpara>
    Deux éléments sont considérés comme égaux si et seulement si
    <literal>(string) $elem1 === (string) $elem2</literal>. En clair :
    lorsque la représentation en chaîne de caractères est identique.
   </simpara>
   <simpara>
    Le premier élément sera utilisé
   </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.
         <!--
         FIXME: PHP_6
         Avant PHP 6, la locale système est utilisée, et peut donc être modifiée
         en utilisant la fonction <function>setlocale</function>. Depuis PHP 6,
         vous devez utiliser la fonction <function>i18n_loc_set_default</function>.
         -->
         </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>5.2.10</entry>
       <entry>
        Changement de la valeur par défaut de <parameter>sort_flags</parameter> 
        à nouveau vers SORT_STRING.
       </entry>
      </row>
      <row>
       <entry>5.2.9</entry>
       <entry>
        Ajout du paramètre optionnel <parameter>sort_flags</parameter>,
        qui faut 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="notes">
  &reftitle.notes;
  <note>
   <simpara>
    Notez que <function>array_unique</function> n'est pas conçu
    pour fonctionner avec des tableaux multidimensionnels.
   </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
-->