array_keys

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

array_keysRetorna todas as chaves ou uma parte das chaves de um array

Descrição

array_keys(array $array): array
array_keys(array $array, mixed $filter_value, bool $strict = false): array

array_keys() retorna as chaves, numéricas e string, do array array.

Se um parâmetro filter_value for especificado, então apenas as chaves para esse valor serão retornadas. Do contrário, todas as chaves de array serão retornadas.

Parâmetros

array

Um array contendo chaves a serem retornadas.

filter_value

Se especificado, somente chaves contendo este valor são retornadas.

strict

Determina se a comparação é rígida (===) deve ser utilizada durante a busca.

Valor Retornado

Retorna um array de todas as chaves em array.

Exemplos

Example #1 Exemplo de array_keys()

<?php
$array = array(0 => 100, "cor" => "vermelho");
print_r(array_keys($array));

$array = array("azul", "vermelho", "verde", "azul", "azul");
print_r(array_keys($array, "azul"));

$array = array("cor"     => array("azul", "vermelho", "verde"),
               "tamanho" => array("pequeno", "medio", "grande"));
print_r(array_keys($array));
?>

O exemplo acima produzirá:

Array
(
    [0] => 0
    [1] => cor
)
Array
(
    [0] => 0
    [1] => 3
    [2] => 4
)
Array
(
    [0] => cor
    [1] => tamanho
)

Veja Também

  • array_values() - Retorna todos os valores de um array
  • array_combine() - Cria um array usando um array para chaves e outro para valores
  • array_key_exists() - Verifica se uma chave ou índice existe em um array
  • array_search() - Procura por um valor em um array e retorna sua chave correspondente caso seja encontrado