En esta página

QStack Class

template <typename T> class QStack

La clase QStack es una clase de plantilla que proporciona una pila. Más información...

Encabezado: #include <QStack>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredado de: QList

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

T pop()
(since 6.11) void push(T &&t)
void push(const T &t)
void swap(QStack<T> &other)
T &top()
const T &top() const

Descripción detallada

QStack<T> es una de las clases de contenedores genéricos de Qt, en la que T especifica el tipo de elemento. Implementa una estructura de datos de pila para elementos del mismo tipo.

Una pila es una estructura del tipo «último en entrar, primero en salir» (LIFO). Los elementos se añaden a la parte superior de la pila mediante ` push()` y se recuperan desde la parte superior mediante ` pop()`. La función ` top()` permite acceder al elemento situado en la parte superior sin eliminarlo.

Ejemplo:

    QStack<int> stack;
    stack.push(1);
    stack.push(2);
    stack.push(3);
    while (!stack.isEmpty())
        cout << stack.pop() << Qt::endl;

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

QStack hereda de ` QList`. Toda la funcionalidad de ` QList` también se aplica a QStack. Por ejemplo, puedes utilizar ` isEmpty()` para comprobar si la pila está vacía, y puedes recorrer una `QStack` utilizando las clases de iterador de ` QList` (por ejemplo, ` QListIterator`). Pero, además, `QStack` proporciona tres funciones de conveniencia que facilitan la implementación de la semántica LIFO: ` push()`, ` pop()` y ` top()`.

El tipo de valor de QStack debe ser un tipo de datos asignable. Esto abarca 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; en su lugar, debes almacenar un ` QWidget *`.

Véase también QList y QQueue.

Documentación de las funciones de miembro

T QStack::pop()

Elimina el elemento superior de la pila y lo devuelve. Esta función da por hecho que la pila no está vacía.

Véase también top(), push() y isEmpty().

[since 6.11] void QStack::push(T &&t)

Añade el elemento t a la parte superior de la pila.

Esto equivale a QList::append().

Esta función se introdujo en Qt 6.11.

Véase también pop() y top().

void QStack::push(const T &t)

Añade el elemento t a la parte superior de la pila.

Esto equivale a QList::append().

Véase también pop() y top().

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

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

T &QStack::top()

Devuelve una referencia al elemento situado en la parte superior de la pila. Esta función da por hecho que la pila no está vacía.

Es equivalente a QList::last().

Véanse también pop(), push() y isEmpty().

const T &QStack::top() const

Esta es una función sobrecargada.

Véase también pop() y push().

© 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.