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