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

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- splitted from ./fr/functions/array.xml, last change in rev 1.30 -->
<!-- last change to 'array' in en/ tree in rev 1.110 -->
 <refentry id="function.array">
  <refnamediv>
   <refname>array</refname>
   <refpurpose>
    Cr&eacute;e un tableau
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>array</methodname>
     <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>array</function> retourne un tableau cr&eacute;&eacute; avec les
    param&egrave;tres pass&eacute;s. On peut attribuer un index particulier
    &agrave; une valeur avec l'op&eacute;rateur <literal>=?&gt;</literal>.
   </para>
   <para>
    <note>
     <para>
      <function>array</function> est un &eacute;l&eacute;ment de langage
      utilis&eacute; pour repr&eacute;senter des tableaux lit&eacute;raux,
      et non pas une fonction au sens strict du terme.
     </para>
    </note>
   </para>
   <para>
    La syntaxe "index =&gt; valeur", s&eacute;par&eacute;e par des virgules,
    d&eacute;finit les index et leur valeur. Un index peut &ecirc;tre une
    cha&icirc;ne ou un nombre. Si l'index est omis, un index num&eacute;rique
    sera automatiquement g&eacute;n&eacute;r&eacute; (commen&ccedil;ant &agrave;
    0). Si l'index est un entier, le prochain index g&eacute;n&eacute;r&eacute;
    prendra la valeur d'index la plus grande + 1. Notez que si deux index
    identiques sont d&eacute;finis, le dernier remplacera le premier.
   </para>
   <para>
    L'exemple suivant montre comment cr&eacute;er un tableau &agrave; deux dimensions,
    comment sp&eacute;cifier les index d'un tableau associatif, et comment
    g&eacute;n&eacute;rer automatiquement des index num&eacute;riques.
    <example>
     <title>Exemple avec <function>array</function></title>
     <programlisting role="php">
<![CDATA[
<?php
$fruits = array (
    "fruits"  => array ("a"=>"orange", "b"=>"banane", "c"=>"pomme"),
    "nombres" => array (1, 2, 3, 4, 5, 6),
    "trous"   => array ("premier", 5 => "second", "troisi&egrave;me")
);
]]>
     </programlisting>
    </example>
   </para>
   <para>
    <example>
     <title>Index automatique d'un tableau avec <function>array</function></title>
     <programlisting role="php">
<![CDATA[
<?php
  $array = array( 1, 1, 1, 1,  1, 8=>1,  4=>1, 19, 3=>13);
  print_r($array);
?>
]]>
     </programlisting>
    </example>
    qui affichera :
    <informalexample>
     <programlisting>
<![CDATA[
Array
(
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 13
    [4] => 1
    [8] => 1
    [9] => 19
)
]]>
     </programlisting>
    </informalexample>
   </para>
   <para>
    Notez bien que l'index '3' est d&eacute;fini deux fois, et conserve finalement
    sa derni&egrave;re valeur de 13. L'index '4' est d&eacute;fini apr&egrave;s
    l'index '8', et l'index g&eacute;n&eacute;r&eacute; suivant (valeur 19) est
    9, puisque le plus grand index est alors 8.
   </para>
   <para>
    Cet exemple cr&eacute;e un tableau dont les index commencent &agrave; 1.
    <example>
     <title>Tableau d'index commen&ccedil;ant &agrave; 1</title>
     <programlisting role="php">
<![CDATA[
<?php
  $firstquarter  = array(1 => 'Janvier', 'F&eacute;vrier', 'Mars');
  print_r($firstquarter);
?>
]]>
     </programlisting>
    </example>
    qui affichera :
    <informalexample>
     <screen>
<![CDATA[
Array
(
    [1] => Janvier
    [2] => F&eacute;vrier
    [3] => Mars
)
]]>
     </screen>
    </informalexample>
   </para>
   <para>
    Voir aussi
    <function>array_pad</function>,
    <function>list</function> et 
    <function>range</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
-->