array_column

(PHP 5 >= 5.5.0, PHP 7)

array_column — 傳回數組中指定的一列

說明

array array_column ( array

$input

, mixed

$column_key

[, mixed

$index_key

] )

array_column() 傳回

input

數組中鍵值為

column_key

的列， 如果指定了可選參數

index_key

，那麼

input

數組中的這一列的值将作為傳回數組中對應值的鍵。

參數

input

需要取出數組列的多元數組（或結果集）

column_key

需要傳回值的列，它可以是索引數組的列索引，或者是關聯數組的列的鍵。 也可以是

NULL

，此時将傳回整個數組（配合

index_key

參數來重置數組鍵的時候，非常管用）

index_key

作為傳回數組的索引/鍵的列，它可以是該列的整數索引，或者字元串鍵值。

傳回值

從多元數組中傳回單列數組

範例

Example #1 從結果集中取出first names列

<?php
// Array representing a possible record set returned from a database
$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);
?>
           

以上例程會輸出：

Array
(
    [0] => John
    [1] => Sally
    [2] => Jane
    [3] => Peter
)
      

Example #2 從結果集中總取出last names列，用相應的id作為鍵值

<?php
// Using the $records array from Example #1
$last_names = array_column($records, 'last_name', 'id');
print_r($last_names);
?>
           

以上例程會輸出：

Array
(
    [2135] => Doe
    [3245] => Smith
    [5342] => Jones
    [5623] => Doe
)