bsl::priority_queue::top

Return a reference to the highest-priority element.

Synopsis

Declared in <bslstl_priorityqueue.h>

priority_queue<VALUE, CONTAINER, COMPARATOR>::const_reference
top() const;

Description

Return a reference providing non-modifiable access to the element having the highest priority in this priority_queue object. In effect, performs return c.front(). The behavior is undefined if the priority queue is empty.

Return Value

reference providing non-modifiable access to the top element