NoRewindIterator::key()函式—用法及示例

函式名：NoRewindIterator::key() 

適用版本：PHP 5 >= 5.1.0, PHP 7

函式描述： NoRewindIterator::key() 函式用於返回當前元素的鍵名。

語法： public NoRewindIterator::key ( void ) : mixed

引數： 該函式沒有引數。

返回值： 返回當前元素的鍵名。如果沒有更多元素可用，則返回 NULL。

示例：

$array = array('a' => 'apple', 'b' => 'banana', 'c' => 'cherry');
$iterator = new NoRewindIterator(new ArrayIterator($array));

echo $iterator->key(); // 輸出: a

$iterator->next();
echo $iterator->key(); // 輸出: b

$iterator->next();
echo $iterator->key(); // 輸出: c

$iterator->next();
echo $iterator->key(); // 輸出: NULL

在上面的示例中，我們首先建立了一個包含三個元素的關聯陣列。然後我們將該陣列傳遞給 ArrayIterator 類來建立一個迭代器物件。接下來，我們將該迭代器物件傳遞給 NoRewindIterator 類來建立一個不可倒回的迭代器物件。

我們透過呼叫 $iterator->key() 來獲取當前元素的鍵名。在每次呼叫 $iterator->next() 後，當前元素都會向下移動一個位置，並且 $iterator->key() 會返回相應的鍵名。當沒有更多元素可用時，$iterator->key() 將返回 NULL。

請注意，NoRewindIterator 類是一個裝飾器類，它將包裝在其內部的迭代器物件，並提供了一些額外的功能。在這個示例中，我們使用 NoRewindIterator 類來確保迭代器不能倒回，即使我們呼叫了 $iterator->rewind() 方法也不會改變當前元素的位置。