Función PHP array_change_key_case ()
Definición y uso
los array_change_key_case() La función cambia el caso de todas las claves de la matriz pasada y devuelve una matriz con todas las claves en minúsculas o mayúsculas según la opción pasada.
Por defecto, esta función devuelve teclas en minúsculas.
Sintaxis
array array_change_key_case ( array $input [, int $case] )
Parámetros
No Señor | Descripción de parámetros |
---|---|
1 |
input (Mandatory) Esta es la matriz para la que desea cambiar el caso de todas las claves. |
2 |
case (Optional) Esto tomará un valor constante ya sea CASE_UPPER o CASE_LOWER. Si no pasa este valor, la función cambiará las teclas a minúsculas. |
Valores devueltos
La función PHP array_change_key_case () devuelve una matriz con sus claves en minúsculas o mayúsculas, o FALSE si la entrada pasada no es una matriz PHP válida.
Versión PHP
Esta función se introdujo por primera vez en la versión 4.2.0 de PHP.
Ejemplo
Pruebe el siguiente ejemplo en el que estamos convirtiendo todas las claves en mayúsculas:
<?php
$input = array("FirSt"=> 10, "SecOnd" => 400, "Third" => 800, );
print_r(array_change_key_case($input, CASE_UPPER));
?>
Esto producirá el siguiente resultado:
Array
(
[FIRST] => 10
[SECOND] => 400
[THIRD] => 800
)
Ejemplo
El siguiente ejemplo convierte todas las claves en minúsculas:
<?php
$input = array("FirSt"=> 10, "SecOnd" => 400, "Third" => 800, );
print_r(array_change_key_case($input, CASE_LOWER));
?>
Esto producirá el siguiente resultado:
Array
(
[first] => 10
[second] => 400
[third] => 800
)
Ejemplo
Veamos cómo funcionará el caso predeterminado si no pasamos la segunda opción en la función -
<?php
$input = array("FirSt"=> 10, "SecOnd" => 400, "Third" => 800, );
print_r(array_change_key_case($input));
?>
Esto producirá el siguiente resultado:
Array
(
[first] => 10
[second] => 400
[third] => 800
)
Ejemplo
El siguiente ejemplo devuelve FALSE y genera una advertencia porque estamos intentando pasar una cadena PHP simple en lugar de una matriz PHP -
<?php
$input = "This is a string";
print_r(array_change_key_case($input, CASE_LOWER));
?>
Esto no produce ninguna salida, más bien mostrará la siguiente advertencia, y si verifica el valor de retorno de la función, será FALSO -
PHP Warning: array_change_key_case() expects parameter 1 to be array, string given in main.php on line 3