PHP array_column() 函式

定義和用法

array_column() 函式返回輸入陣列中由column_key標識的單個列的值。

可選地，您可以傳遞index_key，以使用輸入陣列的index_key列中的值對返回陣列中的值進行索引。

語法

array array_column( array $input , mixed $column_key [, mixed $index_key = NULL ] )

引數

序號	引數及說明
1	input (必填) 一個多維陣列或一個物件陣列，從中提取一列值。
2	column_key (必填) 要返回的值的列。此值可以是您希望檢索的列的整數鍵，也可以是關聯陣列或屬性名稱的字串鍵名。此值可以為NULL以返回完整的陣列或物件
3	index_key (可選) 用作返回陣列的索引/鍵的列。此值可以是列的整數鍵，也可以是字串鍵名。

序號

引數及說明

input (必填)

一個多維陣列或一個物件陣列，從中提取一列值。

column_key (必填)

要返回的值的列。此值可以是您希望檢索的列的整數鍵，也可以是關聯陣列或屬性名稱的字串鍵名。此值可以為NULL以返回完整的陣列或物件

index_key (可選)

用作返回陣列的索引/鍵的列。此值可以是列的整數鍵，也可以是字串鍵名。

返回值

array_column 函式返回一個值陣列，表示輸入陣列中的一列。

PHP 版本

此函式首次引入於 PHP 5.5.0 版本。輸入引數可以是物件陣列的功能在 7.0.0 版本中引入。

示例

嘗試以下示例以獲取記錄集中姓名的列：

<?php

 $records = array(
    array(
        'id' => 2135,
        'first_name' => 'Zara',
        'last_name' => 'Ali',
    ),
    array(
        'id' => 3245,
        'first_name' => 'Nuha',
        'last_name' => 'Mac',
    ),
    array(
        'id' => 5342,
        'first_name' => 'Shifa',
        'last_name' => 'Alam',
    ),
    array(
        'id' => 5623,
        'first_name' => 'Riya',
        'last_name' => 'Sweet',
    )
  );

 $first_names = array_column($records, 'first_name');
 print_r($first_names);
?>

這將產生以下結果：

Array
(
    [0] => Zara
    [1] => Nuha
    [2] => Shifa
    [3] => Riya
)

示例

現在讓我們再嘗試一個示例以獲取記錄集中姓名的列，但這次我們將使用id對記錄集進行索引：

<?php

 $records = array(
    array(
        'id' => 2135,
        'first_name' => 'Zara',
        'last_name' => 'Ali',
    ),
    array(
        'id' => 3245,
        'first_name' => 'Nuha',
        'last_name' => 'Mac',
    ),
    array(
        'id' => 5342,
        'first_name' => 'Shifa',
        'last_name' => 'Alam',
    ),
    array(
        'id' => 5623,
        'first_name' => 'Riya',
        'last_name' => 'Sweet',
    )
 );
 $first_names = array_column($records, 'first_name', 'id');
 print_r($first_names);
?>

這將產生以下結果：

Array
(
    [2135] => Zara
    [3245] => Nuha
    [5342] => Shifa
    [5623] => Riya
)

php_function_reference.htm

列印頁面