Exemplo
Busca de uma matriz para o valor "red" e retornar sua chave:
<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>
Exemplo executar » Definição e Uso
O array_search() função de pesquisa uma matriz para um valor e retorna a chave.
Sintaxe
array_search( value,array,strict )
Parâmetro | Descrição |
---|---|
value | Requeridos. Especifica o valor a ser pesquisado |
array | Requeridos. Especifica a matriz de pesquisa em |
strict | Opcional. Se este parâmetro é definido como TRUE, então esta função irá procurar elementos idênticos na matriz. Valores possíveis:
|
Detalhes técnicos
Valor de retorno: | Retorna a chave de um valor se ele for encontrado no array, e FALSE caso contrário. Se o valor for encontrado na matriz mais de uma vez, a primeira chave correspondente é retornado. |
---|---|
PHP Versão: | 4.0.5+ |
changelog: | Esta função retorna NULL se os parâmetros inválidos são passados para ele (isso se aplica a todas as funções PHP a partir do 5.3.0). A partir do PHP 4.2.0, esta função retorna FALSE em caso de falha em vez de NULL. |
mais Exemplos
Exemplo 1
Busca de uma matriz para o valor 5 e retornar sua chave (notice the "") :
<?php
$a=array("a"=>"5","b"=>5,"c"=>"5");
echo array_search(5,$a,true);
?>
Exemplo executar » <PHP matriz de referência