priority_queue::top
Returns a const reference to the largest element at the top of the priority_queue.
const_reference top( ) const;
reference top( );
Return Value
A reference to the largest element, as determined by the Traits function, object of the priority_queue.
Remarks
The priority_queue must be nonempty to apply the member function.
Example
// pqueue_top.cpp
// compile with: /EHsc
#include <queue>
#include <iostream>
int main( )
{
using namespace std;
priority_queue<int> q1;
q1.push( 10 );
q1.push( 30 );
q1.push( 20 );
priority_queue<int>::size_type i;
i = q1.size( );
cout << "The priority_queue length is " << i << "." << endl;
const int& ii = q1.top( );
cout << "The element at the top of the priority_queue is "
<< ii << "." << endl;
}
The priority_queue length is 3.
The element at the top of the priority_queue is 30.
Requirements
Header: <queue>
Namespace: std