Função PHP array_search()
Exemplo
Pesquise um array pelo valor "red" e retorne sua chave:
<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>
Definição e uso
A função array_search() procura um valor em um array e retorna a chave.
Sintaxe
array_search(value, array, strict)
Valores de parâmetro
Parameter | Description |
---|---|
value | Required. Specifies the value to search for |
array | Required. Specifies the array to search in |
strict | Optional. If this parameter is set to TRUE, then this function will search for identical elements in the array. Possible values:
|
Detalhes técnicos
Valor de retorno: | Retorna a chave de um valor se for encontrado na matriz e FALSE caso contrário. Se o valor for encontrado na matriz mais de uma vez, a primeira chave correspondente será retornada. |
---|---|
Versão do PHP: | 4.0.5+ |
Registro de alterações do PHP: | Esta função retorna NULL se parâmetros inválidos são passados para ela (isso se aplica a todas as funções PHP a partir de 5.3.0). A partir do PHP 4.2.0, esta função retorna FALSE em caso de falha ao invés de NULL. |
Mais exemplos
Exemplo
Pesquise um array pelo valor 5 e retorne sua chave (observe o ""):
<?php
$a=array("a"=>"5","b"=>5,"c"=>"5");
echo array_search(5,$a,true);
?>
❮ Referência de array PHP