PHP | Ds\Stack peek()函数

简介

Ds\Stack peek()函数用于返回栈顶元素，而不对栈做任何更改。

语法

public function peek(): mixed

参数

该函数没有任何参数。

返回值

该方法返回栈顶元素，栈不变。

示例

$stack = new \Ds\Stack();

$stack->push('a');
$stack->push('b');
$stack->push('c');

echo $stack->peek(); // 输出 c

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

在上面的示例中，我们首先创建了一个新的栈。然后我们将三个元素添加到该栈中。接下来，我们使用peek()函数获取栈顶元素，栈不变，我们将其输出。最后，我们使用print_r()函数输出整个栈，以证明peek()函数确实没有更改栈的内容。

异常

如果栈为空，则该函数可能会抛出UnderflowException。