Exemplo
Obter coluna de sobrenomes de um conjunto de registros:
<?php
// An array that represents a possible record set returned from a
database
$a = array(
array(
'id' => 5698,
'first_name' => 'Peter',
'last_name' => 'Griffin',
),
array(
'id' => 4767,
'first_name' => 'Ben',
'last_name' => 'Smith',
),
array(
'id' => 3809,
'first_name' => 'Joe',
'last_name' => 'Doe',
)
);
$last_names =
array_column($a, 'last_name');
print_r($last_names);
?>
Saída:
Array
(
[0] => Griffin
[1] => Smith
[2] => Doe
)Definição e Uso
O array_column() retorna os valores a partir de uma única coluna na matriz de entrada.
Sintaxe
array_column( array , column_key , index_key );
| Parâmetro | Descrição |
|---|---|
| array | Requeridos. Especifica a matriz multi-dimensional (record-set) para utilizar |
| column_key | Requeridos. Uma chave de inteiro ou um nome de chave de string da coluna de valores para retornar. Este parâmetro também pode ser nulo para retornar matrizes completas (útil em conjunto com index_key para re-indexar o array) |
| index_key | Opcional. A coluna para usar como o índice de teclas / para a matriz retornada |
Detalhes técnicos
| Valor de retorno: | Devolve uma matriz de valores que representa uma única coluna da matriz de entrada |
|---|---|
| PHP Versão: | 5.5+ |
mais Exemplos
Exemplo 1
Obter coluna de sobrenomes a partir de um conjunto de registros, indexados pela "id" coluna:
<?php
// An array that represents a possible record set returned from a
database
$a = array(
array(
'id' => 5698,
'first_name' => 'Peter',
'last_name' => 'Griffin',
),
array(
'id' => 4767,
'first_name' => 'Ben',
'last_name' => 'Smith',
),
array(
'id' => 3809,
'first_name' => 'Joe',
'last_name' => 'Doe',
)
);
$last_names = array_column($a, 'last_name', 'id');
print_r($last_names);
?> Saída:
Array
(
[5698] => Griffin
[4767] => Smith
[3809] => Doe
)<PHP matriz de referência