Ds\Stack::peek

Returns the value at the top of the stack.

Description

public mixed Ds\Stack::peek ( void )

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

Parameters

This function has no parameters.

Return Values

The value at the top of the stack.

Errors/Exceptions

UnderflowException if empty.

Examples

Example #1 Ds\Stack::peek example

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

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

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

The above example will output something similar to:

string(1) "c"