Ds\Stack::peek

(PECL ds >= 1.0.0)

Ds\Stack::peek — Returns the value at the top of the stack

説明

public Ds\Stack::peek ( void ) : mixed

Returns the value at the top of the stack, but does not remove it.

パラメータ

この関数にはパラメータはありません。

返り値

The value at the top of the stack.

エラー / 例外

UnderflowException if empty.

例

例1 Ds\Stack::peek() example

<?php
$stack = new \Ds\Stack();

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

var_dump($stack->peek());
?>

上の例の出力は、 たとえば以下のようになります。

string(1) "c"