Função PHP array_change_key_case ()
Definição e Uso
o array_change_key_case() A função altera o caso de todas as chaves do array passado e retorna um array com todas as chaves em minúsculas ou maiúsculas com base na opção passada.
Por padrão, esta função retorna chaves com caixa baixa.
Sintaxe
array array_change_key_case ( array $input [, int $case] )
Parâmetros
Sr. Não | Parâmetro e Descrição |
---|---|
1 | input (Mandatory) Esta é a matriz para a qual você deseja alterar a capitalização de todas as chaves. |
2 | case (Optional) Isso terá um valor constante CASE_UPPER ou CASE_LOWER. Se você não passar este valor, a função mudará as teclas para minúsculas. |
Valores Retornados
A função PHP array_change_key_case () retorna um array com suas chaves em minúsculas ou maiúsculas, ou FALSE se a entrada passada não for um array PHP válido.
Versão PHP
Esta função foi introduzida pela primeira vez no PHP versão 4.2.0.
Exemplo
Experimente o seguinte exemplo em que estamos convertendo todas as chaves em maiúsculas -
<?php
$input = array("FirSt"=> 10, "SecOnd" => 400, "Third" => 800, );
print_r(array_change_key_case($input, CASE_UPPER));
?>
Isso produzirá o seguinte resultado -
Array
(
[FIRST] => 10
[SECOND] => 400
[THIRD] => 800
)
Exemplo
O exemplo a seguir converte todas as chaves em minúsculas -
<?php
$input = array("FirSt"=> 10, "SecOnd" => 400, "Third" => 800, );
print_r(array_change_key_case($input, CASE_LOWER));
?>
Isso produzirá o seguinte resultado -
Array
(
[first] => 10
[second] => 400
[third] => 800
)
Exemplo
Vamos verificar como o caso padrão funcionará se não passarmos a segunda opção na função -
<?php
$input = array("FirSt"=> 10, "SecOnd" => 400, "Third" => 800, );
print_r(array_change_key_case($input));
?>
Isso produzirá o seguinte resultado -
Array
(
[first] => 10
[second] => 400
[third] => 800
)
Exemplo
O exemplo a seguir retorna FALSE e gera um aviso porque estamos tentando passar uma string PHP simples em vez de um array PHP -
<?php
$input = "This is a string";
print_r(array_change_key_case($input, CASE_LOWER));
?>
Isso não produz nenhuma saída, em vez disso, exibirá o seguinte aviso e, se você verificar o valor de retorno da função, será FALSE -
PHP Warning: array_change_key_case() expects parameter 1 to be array, string given in main.php on line 3