array

    (PHP 4, PHP 5, PHP 7, PHP 8)

    array — Crée un tableau

    Description

    function array(mixed ...$values): array

    Crée un tableau. Consulter la section sur les types tableaux pour plus d'informations sur ce qu'est un tableau, y compris les détails sur la syntaxe alternative de crochets ([]).

    Liste de paramètres

    values

    La syntaxe "index => valeur", séparée par des virgules, définit les index et leur valeur. Un index peut être une chaîne ou un nombre. Si l'index est omis, un index numérique sera automatiquement généré (commençant à 0). Si l'index est un entier, le prochain index généré prendra la valeur d'index la plus grande + 1. Il est à noter que si deux indices identiques sont définis, le dernier remplacera le premier.

    Avoir une virgule après avoir défini la dernière entrée, bien qu'inutile, est une syntaxe valide.

    Valeurs de retour

    Retourne un tableau des paramètres. Les paramètres peuvent fournir un index en utilisant l'opérateur =>. Consulter la section sur les types-tableaux pour plus d'informations sur ce qu'est un tableau.

    Exemples

    L'exemple suivant montre comment créer un tableau à deux dimensions, comment spécifier les index d'un tableau associatif, et comment générer automatiquement des index numériques.

    Exemple #1 Exemple avec array()

    <?php
$fruits = array (
    "fruits"  => array("a" => "orange", "b" => "banana", "c" => "apple"),
    "numbers" => array(1, 2, 3, 4, 5, 6),
    "holes"   => array("first", 5 => "second", "third")
);
print_r($fruits);
?>

    Exemple #2 Index automatique avec array()

    <?php
$array = array(1, 1, 1, 1,  1, 8 => 1, 4 => 1, 19, 3 => 13);
print_r($array);
?>

    L'exemple ci-dessus va afficher :

    Array
(
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 13
    [4] => 1
    [8] => 1
    [9] => 19
)

    Il est à noter que l'index '3' est défini deux fois, et conserve finalement sa dernière valeur de 13. L'index '4' est défini après l'index '8', et l'index généré suivant (valeur 19) est 9, puisque le plus grand index est alors 8.

    Cet exemple crée un tableau dont les index commencent à 1.

    Exemple #3 Index commençant à 1 avec array()

    <?php
$firstQuarter = array(1 => 'January', 'February', 'March');
print_r($firstQuarter);
?>

    L'exemple ci-dessus va afficher :

    Array
(
    [1] => January
    [2] => February
    [3] => March
)

    Tout comme en Perl, il est possible d'accéder à une valeur d'un tableau dans des doubles guillemets. Cependant, avec PHP, il faut entourer le tableau avec des accolades.

    Exemple #4 Accéder à un tableau dans des doubles guillemets

    <?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>

    Notes

    Note:

    array() est un constructeur de langage utilisé pour représenter littéralement les tableaux, mais ce n'est en aucun cas une fonction régulière.

    Voir aussi

    • array_pad() - Complète un tableau avec une valeur jusqu'à la longueur spécifiée
    • list() - Assigne des variables comme si elles étaient un tableau
    • count() - Compte tous les éléments d'un tableau ou dans un objet Countable
    • range() - Crée un tableau contenant un intervalle d'éléments
    • foreach
    • Le type array

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    113
    ole dot aanensen at gmail dot com
    12 years ago
    As of PHP 5.4.x you can now use 'short syntax arrays' which eliminates the need of this function.

Example #1 'short syntax array'
<?php
    $a = [1, 2, 3, 4];
    print_r($a);
?>

The above example will output:
Array
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
)

Example #2 'short syntax associative array'
<?php
    $a = ['one' => 1, 'two' => 2, 'three' => 3, 'four' => 4];
    print_r($a);
?>

The above example will output:
Array
(
    [one] => 1
    [two] => 2
    [three] => 3
    [four] => 4
)
    ＋add a note
    To Top