PHP array_change_key_case() 函式



定義和用法

array_change_key_case() 函式更改傳遞陣列的所有鍵的大小寫,並根據傳遞的選項返回一個所有鍵都小寫或大寫的陣列。

預設情況下,此函式返回小寫鍵。

語法

array array_change_key_case ( array $input [, int $case] )

引數

序號 引數和描述
1

input (必填)

這是您要更改所有鍵的大小寫的陣列。

2

case (可選)

這將採用常量值 CASE_UPPERCASE_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
)

示例

讓我們檢查一下如果我們不傳遞函式中的第二個選項,預設情況將如何工作 -

<?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
php_function_reference.htm
廣告