.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

=====================================
Tableaux
=====================================

En PHP, les tableaux sont des éléments importants, car ils permettent d'obtenir une structure ordonnée en clé => valeur. Ils sont considérés comme des dictionnaires, listes de données, collection, etc. C'est une différence par rapport au C# qui contient toutes ces structures.

**Tableaux simples**
====================

Pour définir un tableau, le mot-clé array est utilisé. Les valeurs sont accessibles par leur indice.

.. code-block:: php

   // Définir un tableau vide
   $newArray = array();

   // Définir un tableau contenant des éléments
   $colors = array("vert", "blanc", "rouge");

   // Ajouter un élément dans un tableau existant
   $colors[] = "jaune"; 

   // Afficher un élément en particulier
   echo $colors[2]; // rouge

**Tableaux associatifs**
========================

Les tableaux associatifs ont la particularité d'être définis par une clé au lieu d'un indice. De plus, la syntaxe est clé => valeur.

.. code-block:: php

   // Définir un tableau vide
   $newArray = array();

   // Définir un tableau contenant des éléments
   $peopleAges = array("Paul" => 23, "Jacques" => 42);

   // Ajouter un élément dans un tableau existant
   $peopleAges["Jean"] = 35; 

   // Afficher un élément en particulier
   echo $peopleAges["Jacques"]; // 42


**Tableaux multidimensionnels**
===============================

Nous avons vu les deux types de tableaux existants (indice et associatif). Il est possible de faire des tableaux multidimensionnels soit avec des indices, soit associatifs, soit le deux en fonction du besoin.

.. code-block:: php

   // Tableaux permettant de définir un carnet d'adresses
   $addressBook = array(
      0 => array(
         "name" => "Eponge",
         "firstname" => "Bob",
         "tel" => 0987546378
      ),
      1 => array(
         "name" => "Neutron",
         "firstname" => "Jim",
         "tel" => 0384560924
      )
   );

   // Ajouter un élément par la suite
   $addressBook[] = array(
      "name" => "Dalton",
      "firstname" => "Jeo",
      "tel" => 4728293745
   );

    // Afficher un élément
   echo $addressBook[2]["name"]; // Dalton


**Parcourir un tableau**
========================

Il est possible de parcourir un tableau avec tout type de boucles comme en C#, cependant la boucle foreach est très utile et efficace. 

.. code-block:: php

   // Parcourir un tableau simple
   $colors = array("vert", "blanc", "rouge");

   foreach($colors as $color){
      echo $color;
   }

.. code-block:: php

   // Parcourir un tableau associatif
   $peopleAges = array("Paul" => 23, "Jacques" => 42);

   foreach($peopleAges as $name => $age){
       echo $name . " = " . $age . "<br>"; 
   }

**Quelques fonctions**
========================
Il existe plusieurs fonctions consacrées aux tableaux en PHP. `Liste du site de PHP.net  <https://www.php.net/manual/fr/ref.array.php>`_

Voici la liste des principales que nous allons utiliser : var_dump(), print_r(), count(), explode(), end(), sort(), asort(), ksort(), etc.