array_column
(PHP 5 >= 5.5.0)
array_column — Retourne les valeurs d'une colonne d'un tableau d'entrée
Description
array_column() retourne les valeurs d'une colonne du
tableau d'entrée input, identifiée par la clé
column_key. Optionnellement, vous pouvez fournir
un paramètre index_key pour indexer les valeurs dans le
tableau retourné par les valeurs de la colonne index_key
du tableau d'entrée.
Liste de paramètres
-
input -
Un tableau multi-dimensionnel depuis lequel la colonne de valeurs sera prélevée.
-
column_key -
La colonne de valeurs à retourner. Cette valeur peut être la clé entière de la colonne que vous souhaitez récupérer, ou bien le nom de la clé pour un tableau associatif. Il peut aussi valoir
NULLpour retourner le tableau complet (utile en conjonction du paramètreindex_keypour ré-indexer le tableau). -
index_key -
La colonne à utiliser comme index/clé pour le tableau retourné. Cette valeur peut être la clé entière de la colonne, ou le nom de la clé.
Valeurs de retour
Retourne un tableau de valeurs représentant une seule colonne depuis le tableau d'entrée.
Exemples
Exemple #1 Récupère la colonne des prénoms
<?php
// Tableau représentant un jeu d'enregistrements issu d'une base de données
$records = array(
array(
'id' => 2135,
'first_name' => 'John',
'last_name' => 'Doe',
),
array(
'id' => 3245,
'first_name' => 'Sally',
'last_name' => 'Smith',
),
array(
'id' => 5342,
'first_name' => 'Jane',
'last_name' => 'Jones',
),
array(
'id' => 5623,
'first_name' => 'Peter',
'last_name' => 'Doe',
)
);
$first_names = array_column($records, 'first_name');
print_r($first_names);
?><?php
// En utilisant le tableau de l'exemple #1
$last_names = array_column($records, 'last_name', 'id');
print_r($last_names);
?>L'exemple ci-dessus va afficher :
Array
(
[2135] => Doe
[3245] => Smith
[5342] => Jones
[5623] => Doe
)
