函式名稱:key()
函式描述:key() 函式返回陣列中當前指標位置的鍵名。
適用版本:PHP 4, PHP 5, PHP 7
語法:key(array $array): mixed
引數:
- $array:必需,輸入的陣列。
返回值:返回當前指標位置的鍵名。如果指標超出陣列範圍,則返回 NULL。
示例:
$array = array('a' => 'apple', 'b' => 'banana', 'c' => 'cherry');
// 將指標指向陣列的第一個元素
reset($array);
// 返回當前指標位置的鍵名
echo key($array); // 輸出: a
// 將指標向後移動一個位置
next($array);
// 返回當前指標位置的鍵名
echo key($array); // 輸出: b
// 將指標向後移動一個位置
next($array);
// 返回當前指標位置的鍵名
echo key($array); // 輸出: c
// 將指標向後移動一個位置,此時指標超出陣列範圍,返回 NULL
next($array);
// 返回當前指標位置的鍵名,輸出 NULL
echo key($array);
以上示例中,我們建立了一個關聯陣列 $array
,然後使用 reset()
函式將指標指向陣列的第一個元素。接著,我們使用 key()
函式分別獲取了當前指標位置的鍵名。透過 next()
函式,我們將指標向後移動一個位置,並再次呼叫 key()
函式獲取當前指標位置的鍵名。當指標超出陣列範圍時,key()
函式返回 NULL。
請注意,key()
函式只返回當前指標位置的鍵名,並不會改變指標位置。如果需要改變指標位置,可以使用 next()
、prev()
、end()
、reset()
等函式。