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