std::priority_queue
| Definido en el archivo de encabezado <queue>
|
||
template<
class T,
class Container = std::vector<T>,
class Compare = std::less<typename Container::value_type>
> class priority_queue;
|
||
La clase std::priority_queue o cola de prioridad, es un adaptador de contenedor que proporciona una bsqueda en tiempo constante del elemento mayor (por defecto), a expensas de la insercin y extraccin logartmicas.
Se puede suplementar un comparador Compare proporcionado por el usuario para cambiar el orden. Por ejemplo, el uso de std::greater<T> ocasionara que el elemento ms pequeo apareciera en la parte superior, top().
Trabajar con un contenedor priority_queue es similar a gestionar un montculo (heap) en algn contenedor de acceso aleatorio con el beneficio de no ser capaz de invalidar el montculo accidentalmente.
Parmetros de plantilla
| T | - | El tipo de los elementos almacenados. El comportamiento no est definido si T no es el mismo tipo que Container::value_type.
|
| Container | - | El tipo del contenedor subyacente a usar para almacenar los elementos. El contenedor debe satisfacer los requisitos de ContenedorDeSecuencia, y sus iteradores deben cumplir con los requisitos de IteradorDeAccesoAleatorioLegado. Adems, debe proporcionar las siguientes funciones con la semntica habitual:
Los contenedores estndar std::vector y std::deque cumplen con estos requisitos. |
| Compare | - | Un tipo Comparar de comparacin que proporciona un orden estricto dbil.
Observa que el parmetro Comparar se define de manera tal que devuelve |
Tipos miembro
| Tipo miembro | Definicin |
container_type
|
Container
|
value_compare
|
Compare
|
value_type
|
Container::value_type
|
size_type
|
Container::size_type
|
reference
|
Container::reference
|
const_reference
|
Container::const_reference
|
Objetos miembro
| Nombre de miembro | Definicin |
Container c |
El contenedor subyacente. (objeto miembro protegido) |
Compare comp |
El objeto funcin de comparacin. (objeto miembro protegido) |
Funciones miembro
Construye el contenedor priority_queue. (funcin miembro pblica) | |
Destruye el contenedor priority_queue. (funcin miembro pblica) | |
| Asigna valores al adaptador de contenedor. (funcin miembro pblica) | |
Acceso a elementos | |
| Accede al elemento en la parte superior. (funcin miembro pblica) | |
Capacidad | |
| Comprueba si el contenedor subyacente est vaco. (funcin miembro pblica) | |
| Devuelve el nmero de elementos. (funcin miembro pblica) | |
Modificadores | |
| Encola un elemento y ordena el contenedor subyacente. (funcin miembro pblica) | |
(C++23) |
Inserta un rango de elementos y ordena el contenedor subyacente. (funcin miembro pblica) |
(C++11) |
Encola el elemento en el sitio y ordena el contenedor subyacente. (funcin miembro pblica) |
| Desencola el elemento en la parte superior de la cola de prioridad. (funcin miembro pblica) | |
(C++11) |
Intercambia el contenido. (funcin miembro pblica) |
Funciones no miembro
| Especializa el algoritmo std::swap. (plantilla de funcin) |
Clases auxiliares
| Especializa el rasgo de tipo std::uses_allocator. (plantilla de funcin) | |
Apoyo de formato para std::priority_queue. (especializacin de plantilla de clase) |
Guas de deduccin |
(desde C++17) |
Notas
| Macro de prueba de caracterstica | Valor | Estndar | Comentario |
|---|---|---|---|
__cpp_lib_containers_ranges |
202202L |
(C++23) | Construccin e insercin de rangos para contenedores. |
Ejemplo
#include <functional>
#include <iostream>
#include <queue>
#include <string_view>
#include <vector>
template<typename T>
void pop_println(std::string_view rem, T& pq)
{
std::cout << rem << ": ";
for (; !pq.empty(); pq.pop())
std::cout << pq.top() << ' ';
std::cout << '\n';
}
template<typename T>
void println(std::string_view rem, const T& v)
{
std::cout << rem << ": ";
for (const auto& e : v)
std::cout << e << ' ';
std::cout << '\n';
}
int main()
{
const auto data = {1, 8, 5, 6, 3, 4, 0, 9, 7, 2};
println("datos", data);
std::priority_queue<int> max_priority_queue;
// Poblar la cola de prioridad.
for (int n : data)
max_priority_queue.push(n);
pop_println("max_priority_queue", max_priority_queue);
// std::greater<int> hace que la cola de prioridad con
// montculo de mximos acte como una cola de prioridad
// con montculo de mnimos.
std::priority_queue<int, std::vector<int>, std::greater<int>>
min_priority_queue1(data.begin(), data.end());
pop_println("min_priority_queue1", min_priority_queue1);
// Segunda manera de definir una cola de prioridad
// con montculo de mnimos.
std::priority_queue min_priority_queue2(data.begin(), data.end(), std::greater<int>());
pop_println("min_priority_queue2", min_priority_queue2);
// Usando un objeto funcin personalizado para comparar elementos.
struct
{
bool operator()(const int l, const int r) const { return l > r; }
} customLess;
std::priority_queue custom_priority_queue(data.begin(), data.end(), customLess);
pop_println("custom_priority_queue", custom_priority_queue);
// Usando una lambda para comparar elementos.
auto cmp = [](int left, int right) { return (left ^ 1) < (right ^ 1); };
std::priority_queue<int, std::vector<int>, decltype(cmp)> lambda_priority_queue(cmp);
for (int n : data)
lambda_priority_queue.push(n);
pop_println("lambda_priority_queue", lambda_priority_queue);
}
Salida:
datos: 1 8 5 6 3 4 0 9 7 2
max_priority_queue: 9 8 7 6 5 4 3 2 1 0
min_priority_queue1: 0 1 2 3 4 5 6 7 8 9
min_priority_queue2: 0 1 2 3 4 5 6 7 8 9
custom_priority_queue: 0 1 2 3 4 5 6 7 8 9
lambda_priority_queue: 8 9 6 7 4 5 2 3 0 1
Informes de defectos
Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estndares de C++ publicados anteriormente.
| ID | Aplicado a | Comportamiento segn lo publicado | Comportamiento correcto |
|---|---|---|---|
| LWG 307 | C++98 | Container no poda ser std::vector<bool>.
|
Se admite. |
| LWG 2566 | C++98 | Faltaba el requisito de Container::value_type.
|
Mal formado si T no es el mismo tipo queContainer::value_type.
|
| LWG 2684 | C++98 | priority_queue toma un comparador pero le faltaba unadefinicin de tipo miembro ( typedef).
|
Se le agreg. |
Vase tambin
| Array dinmico contiguo. (plantilla de clase) | |
| Conjunto de bits eficiente en el uso de espacio. (plantilla de clase) | |
Cola doblemente terminada (deque). (plantilla de clase) |