En esta página

QQueue Class

template <typename T> class QQueue

La clase QQueue es un contenedor genérico que proporciona una cola. Más...

Cabecera: #include <QQueue>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Hereda: QList

Nota: Todas las funciones de esta clase son reentrantes.

Funciones Públicas

T dequeue()
void enqueue(T &&t)
void enqueue(const T &t)
T &head()
const T &head() const
void swap(QQueue<T> &other)

Descripción Detallada

QQueue<T> es una de las clases contenedoras genéricas de Qt. Implementa una estructura de datos de cola para elementos de un mismo tipo.

Una cola es una estructura FIFO (primero en entrar, primero en salir). Los elementos se añaden a la cola de la cola mediante enqueue() y se recuperan de la cabeza mediante dequeue(). La función head() permite acceder al elemento de la cola sin eliminarlo.

Ejemplo:

QQueue<int> queue;
queue.enqueue(1);
queue.enqueue(2);
queue.enqueue(3);
while (!queue.isEmpty())
    cout << queue.dequeue() << endl;

El ejemplo mostrará 1, 2, 3 en ese orden.

QQueue hereda de QList. Toda la funcionalidad de QList se aplica también a QQueue. Por ejemplo, puedes utilizar isEmpty() para comprobar si la cola está vacía, y puedes recorrer una cola QQueue utilizando las clases iteradoras de QList(por ejemplo, QListIterator). Además, QQueue proporciona tres funciones que facilitan la implementación de la semántica FIFO: enqueue(), dequeue() y head().

El tipo de valor de QQueue debe ser un tipo de datos asignable. Esto cubre la mayoría de los tipos de datos que se utilizan habitualmente, pero el compilador no te permitirá, por ejemplo, almacenar un QWidget como valor. Utilice QWidget* en su lugar.

Véase también QList y QStack.

Documentación de funciones miembro

T QQueue::dequeue()

Elimina el elemento principal de la cola y lo devuelve. Esta función asume que la cola no está vacía.

Es lo mismo que QList::takeFirst().

Véase también head(), enqueue() y isEmpty().

void QQueue::enqueue(const T &t)

void QQueue::enqueue(T &&t)

Añade el valor t a la cola de la cola.

Es lo mismo que QList::append().

Véase también dequeue() y head().

Devuelve una referencia al elemento principal de la cola. Esta función asume que la cola no está vacía.

Es lo mismo que QList::first().

Véase también dequeue(), enqueue() y isEmpty().

const T &QQueue::head() const

Se trata de una función sobrecargada.

[noexcept] void QQueue::swap(QQueue<T> &other)

Intercambia esta cola con other. Esta operación es muy rápida y nunca falla.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.