Ds\Stack::peek()函式—用法及示例

函式名稱：Ds\Stack::peek()

適用版本：PHP 7.0+

函式描述：Ds\Stack::peek() 方法用於返回堆疊頂部的元素值，但不會刪除該元素。

用法示例：

<?php
$stack = new Ds\Stack(['a', 'b', 'c']);

echo $stack->peek(); // Output: c
echo $stack->peek(); // Output: c (peek() 不會改變堆疊的狀態)

print_r($stack); // Output: Ds\Stack Object ( [0] => a [1] => b [2] => c )
?>

注意事項：

• Ds\Stack::peek() 方法用於返回堆疊頂部的元素，但不移除該元素。
• 如果堆疊為空，則 Ds\UnderflowException 異常會被丟擲。
• 該方法不會更改堆疊的狀態。
• 返回的是堆疊中頂部的元素值。
• 該函式適用於 PHP 7.0 及更高版本。
• 若要使用 Ds\Stack 類，請確保已安裝了擴充套件包 ds，可透過 pecl install ds 命令進行安裝。

詳細說明及示例可以參考 PHP 官方文件：https://www.php.net/manual/en/class.ds-stack.php#ds-stack-method-peek