[函数]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