PHP array_change_key_case() 函数

定义和用法

array_change_key_case() 函数会改变传入数组的所有键的大小写，并根据传入的选项返回一个键要么全为小写要么全为大写的数组。

默认情况下，该函数返回小写键。

语法

array array_change_key_case ( array input [, intcase] )

参数

序号	参数与说明
1	input (必需) 这是您想要更改所有键的大小写的数组。
2	case (可选) 这将采用常量值，要么 CASE_UPPER ，要么 CASE_LOWER 。如果您不传递该值，函数将将键更改为小写。

返回值

PHP array_change_key_case() 函数返回一个数组，其中的键名要么为小写字母，要么为大写字母，如果传入的输入不是一个有效的PHP数组，则返回 FALSE 。

PHP版本

此函数首次引入于PHP版本4.2.0。

示例

尝试以下示例，将所有的键名转换为大写字母：

<?php
   input = array("FirSt"=> 10, "SecOnd" => 400, "Third" => 800, );
   print_r(array_change_key_case(input, CASE_UPPER));
?>

这将产生以下结果−

Array
(
    [FIRST] => 10
    [SECOND] => 400
    [THIRD] => 800
)

示例

以下示例将所有键转换为小写-

<?php
   input = array("FirSt"=> 10, "SecOnd" => 400, "Third" => 800, );
   print_r(array_change_key_case(input, CASE_LOWER));
?>

这将产生以下结果−

Array
(
    [first] => 10
    [second] => 400
    [third] => 800
)

示例

让我们来看看如果在函数中不传递第二个选项，default case 将如何工作 −

<?php
   input = array("FirSt"=> 10, "SecOnd" => 400, "Third" => 800, );
   print_r(array_change_key_case(input));
?>

这将产生以下结果−

Array
(
    [first] => 10
    [second] => 400
    [third] => 800
)

示例

以下示例返回FALSE并引发警告，因为我们尝试传递一个简单的PHP字符串而不是一个PHP数组：

<?php
   input = "This is a string";
   print_r(array_change_key_case(input, CASE_LOWER));
?>

这不会产生任何输出，而是会显示以下警告，如果检查函数返回值，它将是 FALSE –

PHP Warning: array_change_key_case() expects parameter 1 to be array, string given in main.php on line 3