Ds\PriorityQueue::peek

Returns the value at the front of the queue

&reftitle.description; public `mixed` `Ds\PriorityQueue::peek`

Returns the value at the front of the queue, but does not remove it.

&reftitle.parameters; &no.function.parameters;
&reftitle.returnvalues;

The value at the front of the queue.

&reftitle.errors;

`UnderflowException` if empty.

&reftitle.examples;

### `Ds\PriorityQueue::peek` example

    <?php
    $queue = new \Ds\PriorityQueue();

    $queue->push("a",  5);
    $queue->push("b", 15);
    $queue->push("c", 10);

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

&example.outputs.similar;

    string(1) "b"