En esta página

QList Class

template <typename T> class QList

La clase QList es una clase de plantilla que proporciona una matriz dinámica. Más información...

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

QBluetoothServiceInfo::Alternative, QBluetoothServiceInfo::Sequence, QByteArrayList, QItemSelection, QMqttUserProperties, QNdefMessage, QPolygon, QPolygonF, QQueue, QSignalSpy, QStack, QStringList, QTestEventList, QVector, QVulkanInfoVector y QXmlStreamAttributes

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

Funciones públicas

QList()
QList(qsizetype tamaño)
QList(std::initializer_list<T> args)
QList(InputIterator first, InputIterator last)
QList(qsizetype tamaño, QList<T>::parameter_type valor)
(since 6.8) QList(qsizetype tamaño, Qt::Initialization)
QList(const QList<T>&other)
QList(QList<T>&&other)
~QList()
void append(QList<T>::parameter_type valor)
(since 6.0) void append(QList<T>&&valor)
void append(QList<T>::rvalue_ref valor)
void append(const QList<T>&valor)
(since 6.6) QList<T> &assign(std::initializer_list<T> l)
(since 6.6) QList<T> &assign(InputIterator first, InputIterator last)
(since 6.6) QList<T> &assign(qsizetype n, QList<T>::parameter_type t)
QList<T>::const_reference at(qsizetype i) const
QList<T>::reference back()
QList<T>::const_reference back() const
QList<T>::iterator begin()
QList<T>::const_iterator begin() const
qsizetype capacity() const
QList<T>::const_iterator cbegin() const
QList<T>::const_iterator cend() const
void clear()
QList<T>::const_iterator constBegin() const
QList<T>::const_pointer constData() const
QList<T>::const_iterator constEnd() const
const T &constFirst() const
const T &constLast() const
bool contains(const AT&valor) const
qsizetype count(const AT&valor) const
qsizetype count() const
QList<T>::const_reverse_iterator crbegin() const
QList<T>::const_reverse_iterator crend() const
QList<T>::puntero data()
QList<T>::const_pointer data() const
void detach()
QList<T>::iterator emplace(qsizetype i, Args &&... args)
QList<T>::iterator emplace(QList<T>::const_iterator before, Args &&... args)
QList<T>::reference emplaceBack(Args &&... args)
QList<T>::reference emplace_back(Args &&... args)
bool empty() const
QList<T>::iterator end()
QList<T>::const_iterator end() const
bool endsWith(QList<T>::parameter_type value) const
QList<T>::iterator erase(QList<T>::const_iterator pos)
QList<T>::iterator erase(QList<T>::const_iterator begin, QList<T>::const_iterator end)
QList<T> &fill(QList<T>::parameter_type value, qsizetype size = -1)
T &first()
(since 6.0) QList<T> first(qsizetype n) const
const T &first() const
QList<T>::reference front()
QList<T>::const_reference front() const
qsizetype indexOf(const AT&valor, qsizetype from = 0) const
QList<T>::iterator insert(qsizetype i, QList<T>::parameter_type value)
QList<T>::iterator insert(qsizetype i, QList<T>::rvalue_ref value)
QList<T>::iterator insert(QList<T>::const_iterator before, qsizetype count, QList<T>::parameter_type value)
QList<T>::iterator insert(QList<T>::const_iterator before, QList<T>::parameter_type value)
QList<T>::iterator insert(QList<T>::const_iterator before, QList<T>::rvalue_ref value)
QList<T>::iterator insert(qsizetype i, qsizetype count, QList<T>::parameter_type value)
bool isEmpty() const
T &last()
(since 6.0) QList<T> last(qsizetype n) const
const T &last() const
qsizetype lastIndexOf(const AT&valor, qsizetype de = -1) const
qsizetype length() const
(since 6.8) qsizetype max_size() const
QList<T> mid(qsizetype pos, qsizetype length = -1) const
void move(qsizetype from, qsizetype to)
void pop_back()
void pop_front()
void prepend(QList<T>::parameter_type value)
void prepend(QList<T>::rvalue_ref valor)
void push_back(QList<T>::parameter_type value)
void push_back(QList<T>::rvalue_ref valor)
void push_front(QList<T>::parameter_type valor)
void push_front(QList<T>::rvalue_ref valor)
QList<T>::reverse_iterator rbegin()
QList<T>::const_reverse_iterator rbegin() const
void remove(qsizetype i, qsizetype n = 1)
qsizetype removeAll(const AT&t)
void removeAt(qsizetype i)
void removeFirst()
(since 6.1) qsizetype removeIf(Predicado pred)
void removeLast()
bool removeOne(const AT&t)
QList<T>::reverse_iterator rend()
QList<T>::const_reverse_iterator rend() const
void replace(qsizetype i, QList<T>::parameter_type value)
void replace(qsizetype i, QList<T>::rvalue_ref value)
void reserve(qsizetype size)
(since 6.0) void resize(qsizetype tamaño)
(since 6.0) void resize(qsizetype tamaño, QList<T>::parameter_type c)
(since 6.8) void resizeForOverwrite(qsizetype tamaño)
void shrink_to_fit()
qsizetype size() const
(since 6.0) QList<T> sliced(qsizetype pos, qsizetype n) const
(since 6.0) QList<T> sliced(qsizetype pos) const
void squeeze()
bool startsWith(QList<T>::parameter_type value) const
void swap(QList<T>&other)
void swapItemsAt(qsizetype i, qsizetype j)
T takeAt(qsizetype i)
QList<T>::value_type takeFirst()
QList<T>::value_type takeLast()
T value(qsizetype i) const
T value(qsizetype i, QList<T>::parameter_type valor_por_defecto) const
bool operator!=(const QList<T>&other) const
QList<T> operator+(QList<T>&&other) &&
QList<T> operator+(const QList<T>&other) &&
QList<T> operator+(QList<T> &&otro) const &
QList<T> operator+(const QList<T>&other) const &
QList<T> &operator+=(const QList<T>&otro)
(since 6.0) QList<T> &operator+=(QList<T> &&otro)
QList<T> &operator+=(QList<T>::parameter_type value)
QList<T> &operator+=(QList<T>::rvalue_ref valor)
bool operator<(const QList<T>&other) const
QList<T> &operator<<(QList<T>::parameter_type value)
QList<T> &operator<<(const QList<T>&other)
(since 6.0) QList<T> &operator<<(QList<T> &&otro)
QList<T> &operator<<(QList<T>::rvalue_ref value)
bool operator<=(const QList<T>&other) const
QList<T> &operator=(QList<T>&&other)
QList<T> &operator=(const QList<T>&other)
QList<T> &operator=(std::initializer_list<T> args)
bool operator==(const QList<T>&other) const
bool operator>(const QList<T>&other) const
bool operator>=(const QList<T>&other) const
QList<T>::reference operator[](qsizetype i)
QList<T>::const_reference operator[](qsizetype i) const

Miembros públicos estáticos

(since 6.8) qsizetype maxSize()
(since 6.1) qsizetype erase(QList<T> &list, const AT &t)
(since 6.1) qsizetype erase_if(QList<T> &list, Predicate pred)
size_t qHash(const QList<T> &key, size_t seed = 0)
QDataStream &operator<<(QDataStream &out, const QList<T> &list)
(since 6.9) auto operator<=>(const QList<T> &lhs, const QList<T> &rhs)
QDataStream &operator>>(QDataStream &in, QList<T> &list)

Descripción detallada

QList<T> es una de las clases de contenedores genéricos de Qt, en la que T especifica el tipo de elementos almacenados en la lista. Almacena sus elementos en ubicaciones de memoria adyacentes y proporciona un acceso rápido basado en índices. QVector<T> solía ser una clase diferente en Qt 5, pero ahora es un simple alias de QList.

QList<T> y QVarLengthArray<T> ofrecen API y funcionalidades similares. A menudo son intercambiables, pero esto tiene consecuencias en el rendimiento. A continuación se ofrece una visión general de los casos de uso:

  • QList debería ser tu primera opción por defecto.
  • QVarLengthArray Proporciona un array que reserva espacio en la pila, pero que puede crecer dinámicamente en el montón si es necesario. Es adecuado para contenedores de corta duración que suelen ser pequeños.
  • Si necesitas una lista enlazada real, que garantice inserciones en tiempo constante en medio de la lista y utilice iteradores para acceder a los elementos en lugar de índices, utiliza std::list.

Nota: TantoQList como QVarLengthArray garantizan una estructura de matriz compatible con C.

Nota: QList en Qt 5 no siempre tenía una disposición de matriz compatible con C y, a menudo, recomendábamos utilizar QVector en su lugar para obtener un rendimiento más predecible. Este ya no es el caso en Qt 6, donde ambas clases comparten ahora una misma implementación y pueden utilizarse indistintamente.

A continuación se muestra un ejemplo de una QList que almacena enteros y otra que almacena valores de tipo « QString »:

QList<int> integerList;
QList<QString> stringList;

QList almacena sus elementos en una matriz de memoria continua. Normalmente, las listas se crean con un tamaño inicial. Por ejemplo, el siguiente código crea una QList con 200 elementos:

QList<QString> list(200);

Los elementos se inicializan automáticamente con un valor de construcción por defecto. Si quieres inicializar la lista con un valor diferente, pasa ese valor como segundo argumento al constructor:

QList<QString> list(200, "Pass");

También puedes llamar a ` fill()` en cualquier momento para rellenar la lista con un valor.

QList utiliza índices que comienzan en 0, al igual que las matrices de C++. Para acceder al elemento situado en una posición de índice concreta, puedes utilizar el operador [](). En listas no const, el operador []() devuelve una referencia al elemento que puede utilizarse en el lado izquierdo de una asignación:

if (list[0] == "Liz")
    list[0] = "Elizabeth";

Para el acceso de solo lectura, una sintaxis alternativa es utilizar ` at()`:

for (qsizetype i = 0; i < list.size(); ++i) {
    if (list.at(i) == "Alfonso")
        cout << "Found Alfonso at position " << i << endl;
}

at() puede ser más rápido que el operador [](), ya que nunca provoca una copia profunda.

Otra forma de acceder a los datos almacenados en una QList es llamar a ` data()` (). La función devuelve un puntero al primer elemento de la lista. Puedes utilizar el puntero para acceder directamente y modificar los elementos almacenados en la lista. El puntero también resulta útil si necesitas pasar una QList a una función que acepte una matriz simple de C++.

Si quieres encontrar todas las apariciones de un valor concreto en una lista, utiliza ` indexOf()` o ` lastIndexOf()`. La primera busca hacia adelante a partir de una posición de índice dada, mientras que la segunda busca hacia atrás. Ambas devuelven el índice del elemento coincidente si lo encuentran; de lo contrario, devuelven -1. Por ejemplo:

qsizetype i = list.indexOf("Harumi");
if (i != -1)
    cout << "First occurrence of Harumi is at position " << i << endl;

Si simplemente quieres comprobar si una lista contiene un valor concreto, utiliza contains(). Si quieres saber cuántas veces aparece un valor concreto en la lista, utiliza count().

QList proporciona estas funciones básicas para añadir, mover y eliminar elementos: insert(), replace(), remove(), prepend(), append(). A excepción de append(), prepend() y replace(), estas funciones pueden resultar lentas (tiempo lineal) con listas grandes, ya que requieren desplazar muchos elementos de la lista una posición en la memoria. Si deseas una clase contenedora que permita insertar y eliminar elementos rápidamente en medio de la lista, utiliza en su lugar std::list.

A diferencia de los arrays simples de C++, el tamaño de las QList se puede modificar en cualquier momento llamando a ` resize()`. Si el nuevo tamaño es mayor que el anterior, es posible que QList tenga que reasignar toda la lista. QList intenta reducir el número de reasignaciones preasignando hasta el doble de memoria de la que realmente necesitan los datos.

Si estás creando una QList de forma gradual y sabes de antemano aproximadamente cuántos elementos contendrá, puedes llamar a ` reserve()` para pedirle a QList que preasigne una determinada cantidad de memoria. También puedes llamar a ` capacity()` para averiguar cuánta memoria ha asignado realmente la QList.

Ten en cuenta que el uso de operadores y funciones no const puede provocar que QList realice una copia profunda de los datos, debido al uso compartido implícito.

El tipo de valor de QList 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 *`. Algunas funciones tienen requisitos adicionales; por ejemplo, ` indexOf()` y ` lastIndexOf()` esperan que el tipo de valor admita ` operator==()`. Estos requisitos se documentan para cada función.

Para iterar sobre los elementos, véase «Iteración sobre contenedores». Para utilizar QList con funciones del encabezado « <algorithm> », como « std::sort() », « std::reverse() » y « std::count_if() », véase «Contenedores de Qt y algoritmos std». Para utilizar QList con los propios algoritmos genéricos de Qt, como « qJoin()» y « qDeleteAll()», véase « <QtAlgorithms> ».

Además de QList, Qt también ofrece QVarLengthArray, una clase de muy bajo nivel con escasa funcionalidad, optimizada para la velocidad.

Más información sobre el uso de los contenedores de Qt

Para obtener una explicación detallada en la que se comparan los contenedores de Qt entre sí y con los contenedores de la STL, véase «Comprender los contenedores de Qt».

Tamaño máximo y condiciones de falta de memoria

El tamaño máximo de QList depende de la arquitectura. La mayoría de los sistemas de 64 bits pueden asignar más de 2 GB de memoria, con un límite típico de 2^63 bytes. El valor real también depende de la sobrecarga necesaria para gestionar el bloque de datos. Como resultado, puede esperarse un tamaño máximo de 2 GB menos la sobrecarga en plataformas de 32 bits, y de 2^63 bytes menos la sobrecarga en plataformas de 64 bits. El número de elementos que se pueden almacenar en una QList es este tamaño máximo dividido por el tamaño de un elemento almacenado.

Cuando falla la asignación de memoria, QList utiliza la macro ` Q_CHECK_PTR `, que lanza una excepción ` std::bad_alloc ` si la aplicación se compila con soporte para excepciones. Si las excepciones están desactivadas, el agotamiento de la memoria se considera un comportamiento indefinido.

Tenga en cuenta que el sistema operativo puede imponer límites adicionales a las aplicaciones que ocupan mucha memoria asignada, especialmente bloques grandes y contiguos. Dichas consideraciones, la configuración de dicho comportamiento o cualquier medida de mitigación quedan fuera del alcance de la API de Qt.

Documentación sobre los tipos de miembros

[alias] QList::ConstIterator

Sinónimo al estilo Qt de « QList::const_iterator ».

[alias] QList::Iterator

Sinónimo al estilo Qt de « QList::iterator ».

[alias] QList::const_pointer

Se ha previsto para garantizar la compatibilidad con STL.

[alias] QList::const_reference

Se ha previsto la compatibilidad con STL.

[alias] QList::const_reverse_iterator

La definición de tipo `QList::const_reverse_iterator` proporciona un iterador inverso constante al estilo STL para ` QList`.

Advertencia: Los iteradores de contenedores compartidos implícitamente no funcionan exactamente igual que los iteradores de la STL. Debes evitar copiar un contenedor mientras haya iteradores activos en él. Para obtener más información, consulta el problema de los iteradores de compartición implícita.

Advertencia: Los iteradores quedan invalidados cuando se modifica QList. Considera que todos los iteradores quedan invalidados por defecto. Las excepciones a esta regla se documentan explícitamente.

Véase también QList::rbegin(), QList::rend(), QList::reverse_iterator y QList::const_iterator.

[alias] QList::difference_type

Se ha previsto para garantizar la compatibilidad con STL.

[alias] QList::parameter_type

[alias] QList::pointer

Se ha previsto para garantizar la compatibilidad con STL.

[alias] QList::reference

Se ha previsto para garantizar la compatibilidad con STL.

[alias] QList::reverse_iterator

La definición de tipo `QList::reverse_iterator` proporciona un iterador inverso no constante, al estilo de la STL, para ` QList`.

Advertencia: Los iteradores de contenedores compartidos implícitamente no funcionan exactamente igual que los iteradores de la STL. Debes evitar copiar un contenedor mientras haya iteradores activos en él. Para obtener más información, consulta el problema de los iteradores con uso compartido implícito.

Advertencia: Los iteradores quedan invalidados cuando se modifica QList. Considera que todos los iteradores quedan invalidados por defecto. Las excepciones a esta regla se documentan explícitamente.

Véase también QList::rbegin(), QList::rend(), QList::const_reverse_iterator y QList::iterator.

[alias] QList::rvalue_ref

[alias] QList::size_type

Se ha previsto para garantizar la compatibilidad con STL.

[alias] QList::value_type

Se proporciona para garantizar la compatibilidad con STL.

Documentación de las funciones de miembro

[constexpr noexcept default] QList::QList()

Crea una lista vacía.

Véase también resize().

[explicit] QList::QList(qsizetype size)

Crea una lista con un tamaño inicial de size elementos.

Los elementos se inicializan con un valor construido por defecto.

Véase también ` resize()`.

QList::QList(std::initializer_list<T> args)

Crea una lista a partir de la lista de inicializadores `std::initializer_list` proporcionada por ` args`.

template <typename InputIterator, QList<T>::if_input_iterator<InputIterator> = true> QList::QList(InputIterator first, InputIterator last)

Crea una lista con el contenido del rango del iterador [first, last).

El tipo de valor de InputIterator debe ser convertible a T.

Restricciones

Participa en la resolución de sobrecargas únicamente si InputIterator cumple los requisitos de un LegacyInputIterator.

QList::QList(qsizetype size, QList<T>::parameter_type value)

Crea una lista con un tamaño inicial de size elementos. Cada elemento se inicializa con value.

Véase también resize() y fill().

[since 6.8] QList::QList(qsizetype size, Qt::Initialization)

Crea una lista con un tamaño inicial de size elementos.

QList intentará no inicializar los elementos.

Concretamente:

  • si T tiene un constructor que acepta Qt::Uninitialized, se utilizará ese constructor para inicializar los elementos;
  • de lo contrario, cada elemento se inicializará de forma predeterminada. Para los tipos de construcción trivial (como int, float, etc.), esto equivale a no inicializarlos.

Esta función se introdujo en Qt 6.8.

Véase también resizeForOverwrite().

[implicit] QList::QList(const QList<T> &other)

Crea una copia de ` other`.

Esta operación tarda un tiempo constante, ya que QList se comparte implícitamente. Esto hace que devolver una QList desde una función sea muy rápido. Si se modifica una instancia compartida, se copiará (copia al escribir), lo que lleva un tiempo lineal.

Véase también operator=().

[implicit] QList::QList(QList<T> &&other)

Crea una instancia de QList mediante «move», de modo que apunte al mismo objeto al que apuntaba « other ».

[implicit] QList::~QList()

Elimina la lista.

void QList::append(QList<T>::parameter_type value)

Inserta « value » al final de la lista.

Ejemplo:

QList<QString> list;
list.append("one");
list.append("two");
QString three = "three";
list.append(three);
// list: ["one", "two", "three"]
// three: "three"

Esto equivale a llamar a resize(size() + 1) y asignar value al nuevo último elemento de la lista.

Esta operación es relativamente rápida, ya que QList suele asignar más memoria de la necesaria, por lo que puede crecer sin tener que reasignar toda la lista cada vez.

Véanse también operator<<(), prepend() y insert().

[since 6.0] void QList::append(QList<T> &&value)

Mueve los elementos de la lista « value » al final de esta lista.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

Véase también « operator<<()» y « operator+=()».

void QList::append(QList<T>::rvalue_ref value)

Ejemplo:

QList<QString> list;
list.append("one");
list.append("two");
QString three = "three";
list.append(std::move(three));
// list: ["one", "two", "three"]
// three: ""

Esta es una función sobrecargada.

void QList::append(const QList<T> &value)

Añade los elementos de la lista « value » a esta lista.

Esta es una función sobrecargada.

Véanse también operator<<() y operator+=().

[since 6.6] QList<T> &QList::assign(std::initializer_list<T> l)

Sustituye el contenido de esta lista por una copia de los elementos de l.

El tamaño de esta lista será igual al número de elementos de l.

Esta función solo asigna memoria si el número de elementos de l supera la capacidad de esta lista o si esta lista es compartida.

Esta función se introdujo en Qt 6.6.

[since 6.6] template <typename InputIterator, QList<T>::if_input_iterator<InputIterator> = true> QList<T> &QList::assign(InputIterator first, InputIterator last)

Sustituye el contenido de esta lista por una copia de los elementos del rango del iterador [first, last).

El tamaño de esta lista será igual al número de elementos del rango [first, last).

Esta función solo asignará memoria si el número de elementos del rango supera la capacidad de esta lista o si esta lista es compartida.

Nota: El comportamiento es indefinido si cualquiera de los argumentos es un iterador sobre *this.

Restricciones

Participa en la resolución de sobrecargas únicamente si InputIterator cumple los requisitos de un LegacyInputIterator.

Esta función se introdujo en Qt 6.6.

[since 6.6] QList<T> &QList::assign(qsizetype n, QList<T>::parameter_type t)

Sustituye el contenido de esta lista por n copias de t.

El tamaño de esta lista será igual a n.

Esta función solo asignará memoria si n supera la capacidad de la lista o si esta lista es compartida.

Esta función se introdujo en Qt 6.6.

[noexcept] QList<T>::const_reference QList::at(qsizetype i) const

Devuelve el elemento situado en la posición de índice i de la lista.

i Debe ser una posición de índice válida en la lista (es decir, 0 <= i < size()).

Véanse también value() y operator[]().

QList<T>::reference QList::back()

Esta función se proporciona para garantizar la compatibilidad con la STL. Es equivalente a ` last()`.

[noexcept] QList<T>::const_reference QList::back() const

Esta es una función sobrecargada.

QList<T>::iterator QList::begin()

Devuelve un iterador de tipo STL que apunta al primer elemento de la lista.

Advertencia: El iterador devuelto deja de ser válido al desacoplarse o cuando se modifica la función QList.

Véanse también ` constBegin()` y ` end()`.

[noexcept] QList<T>::const_iterator QList::begin() const

Esta es una función sobrecargada.

qsizetype QList::capacity() const

Devuelve el número máximo de elementos que se pueden almacenar en la lista sin que sea necesario realizar una reasignación.

El único propósito de esta función es proporcionar un medio para ajustar con precisión el uso de memoria de QList. En general, rara vez necesitarás llamar a esta función. Si quieres saber cuántos elementos hay en la lista, llama a size().

Nota: una lista asignada estáticamente indicará una capacidad de 0, aunque no esté vacía.

Advertencia: La posicióndel espacio libre en el bloque de memoria asignado no está definida. En otras palabras, no debes dar por sentado que la memoria libre se encuentra siempre al final de la lista. Puedes llamar a reserve() para asegurarte de que hay suficiente espacio al final.

Véanse también reserve() y squeeze().

[noexcept] QList<T>::const_iterator QList::cbegin() const

Devuelve un iterador constante de estilo STL que apunta al primer elemento de la lista.

Advertencia: El iterador devuelto deja de ser válido al desacoplarse o cuando se modifica el ` QList `.

Véase también ` begin()` y ` cend()`.

[noexcept] QList<T>::const_iterator QList::cend() const

Devuelve un iterador const al estilo STL que apunta justo después del último elemento de la lista.

Advertencia: El iterador devuelto deja de ser válido al desasociarse o cuando se modifica el ` QList `.

Véase también ` cbegin()` y ` end()`.

void QList::clear()

Elimina todos los elementos de la lista.

Si esta lista no es compartida, se conserva el capacity(). Utiliza squeeze() para liberar capacidad sobrante.

Nota: En las versiones de Qt anteriores a la 5.7 (para ` QVector`) y a la 6.0 (para ` QList`), esta función liberaba la memoria utilizada por la lista en lugar de conservar la capacidad.

Véase también resize() y squeeze().

[noexcept] QList<T>::const_iterator QList::constBegin() const

Devuelve un iterador const al estilo STL que apunta al primer elemento de la lista.

Advertencia: El iterador devuelto queda invalidado al desvincularse o cuando se modifica el objeto ` QList `.

Véase también ` begin()` y ` constEnd()`.

[noexcept] QList<T>::const_pointer QList::constData() const

Devuelve un puntero const a los datos almacenados en la lista. El puntero se puede utilizar para acceder a los elementos de la lista.

Advertencia: El puntero deja de ser válido al desvincularlo o cuando se modifica el ` QList `.

Esta función resulta especialmente útil para pasar una lista a una función que acepte una matriz de C++ simple.

Véase también ` data()` y ` operator[]()`.

[noexcept] QList<T>::const_iterator QList::constEnd() const

Devuelve un iterador constante al estilo STL que apunta justo después del último elemento de la lista.

Advertencia: El iterador devuelto deja de ser válido al desvincularse o cuando se modifica el ` QList `.

Véase también « constBegin()» y « end()».

[noexcept] const T &QList::constFirst() const

Devuelve una referencia constante al primer elemento de la lista. Esta función da por hecho que la lista no está vacía.

Véase también constLast(), isEmpty() y first().

[noexcept] const T &QList::constLast() const

Devuelve una referencia constante al último elemento de la lista. Esta función da por hecho que la lista no está vacía.

Véase también constFirst(), isEmpty() y last().

[noexcept] template <typename AT> bool QList::contains(const AT &value) const

Devuelve ` true ` si la lista contiene alguna aparición de ` value`; en caso contrario, devuelve ` false`.

Esta función requiere que el tipo de valor tenga una implementación de operator==().

Véanse también indexOf() y count().

[noexcept] template <typename AT = T> qsizetype QList::count(const AT &value) const

Devuelve el número de veces que aparece « value » en la lista.

Esta función requiere que el tipo de valor tenga una implementación de ` operator==()`.

Véanse también « contains()» y « indexOf()».

[constexpr noexcept] qsizetype QList::count() const

Es lo mismo que size().

Esta es una función sobrecargada.

[noexcept] QList<T>::const_reverse_iterator QList::crbegin() const

Devuelve un iterador inverso de tipo const al estilo STL que apunta al primer elemento de la lista, en orden inverso.

Advertencia: El iterador devuelto deja de ser válido al desacoplarse o cuando se modifica el ` QList `.

Véase también begin(), rbegin() y rend().

[noexcept] QList<T>::const_reverse_iterator QList::crend() const

Devuelve un iterador inverso constante al estilo STL que apunta justo después del último elemento de la lista, en orden inverso.

Advertencia: El iterador devuelto deja de ser válido al separarse o cuando se modifica el ` QList `.

Véase también ` end()`, ` rend()` y ` rbegin()`.

QList<T>::pointer QList::data()

Devuelve un puntero a los datos almacenados en la lista. El puntero se puede utilizar para acceder a los elementos de la lista y modificarlos.

Ejemplo:

QList<int> list(10);
int *data = list.data();
for (qsizetype i = 0; i < 10; ++i)
    data[i] = 2 * i;

Advertencia: El puntero deja de ser válido al desasociarlo o cuando se modifica el objeto ` QList `.

Esta función resulta especialmente útil para pasar una lista a una función que acepte una matriz de C++ simple.

Véase también ` constData()` y ` operator[]()`.

[noexcept] QList<T>::const_pointer QList::data() const

Esta es una función sobrecargada.

void QList::detach()

Garantiza que los datos de este QList ya no se compartan con otras instancias.

template <typename... Args> QList<T>::iterator QList::emplace(qsizetype i, Args &&... args)

Amplía el contenedor insertando un nuevo elemento en la posición i. Este nuevo elemento se crea in situ utilizando args como argumentos para su creación.

Devuelve un iterador al nuevo elemento.

Ejemplo:

QList<QString> list{"a", "ccc"};
list.emplace(1, 2, 'b');
// list: ["a", "bb", "ccc"]

Nota: Se garantiza que el elemento se creará in situ al principio, pero después de eso podría copiarse o moverse a la posición correcta.

Véase también emplaceBack.

template <typename... Args> QList<T>::iterator QList::emplace(QList<T>::const_iterator before, Args &&... args)

Crea un nuevo elemento delante del elemento al que apunta el iterador before. Este nuevo elemento se construye in situ utilizando args como argumentos para su construcción.

Devuelve un iterador al nuevo elemento.

Se trata de una función sobrecargada.

template <typename... Args> QList<T>::reference QList::emplaceBack(Args &&... args)

template <typename... Args> QList<T>::reference QList::emplace_back(Args &&... args)

Añade un nuevo elemento al final del contenedor. Este nuevo elemento se crea in situ utilizando args como argumentos para su creación.

Devuelve una referencia al nuevo elemento.

Ejemplo:

QList<QString> list{"uno", "dos"};
list.emplaceBack(3, 'a');
qDebug() << list;
// lista: ["uno", "dos", "aaa"]

También es posible acceder a un objeto recién creado utilizando la referencia devuelta:

QList<QString> list;
auto &ref = list.emplaceBack();
ref = "one";
// list: ["one"]

Esto equivale a list.emplace(list.size(), args).

Véase también ` emplace`.

[noexcept] bool QList::empty() const

Esta función se proporciona para garantizar la compatibilidad con la STL. Es equivalente a ` isEmpty()`, y devuelve ` true ` si la lista está vacía; en caso contrario, devuelve ` false`.

QList<T>::iterator QList::end()

Devuelve un iterador de estilo STL que apunta justo después del último elemento de la lista.

Advertencia: El iterador devuelto deja de ser válido al separarse o cuando se modifica ` QList `.

Véase también ` begin()` y ` constEnd()`.

[noexcept] QList<T>::const_iterator QList::end() const

Esta es una función sobrecargada.

bool QList::endsWith(QList<T>::parameter_type value) const

Devuelve ` true ` si esta lista no está vacía y su último elemento es igual a ` value`; en caso contrario, devuelve ` false`.

Véase también isEmpty() y last().

QList<T>::iterator QList::erase(QList<T>::const_iterator pos)

Elimina de la lista el elemento al que apunta el iterador ` pos ` y devuelve un iterador al siguiente elemento de la lista (que puede ser ` end()`).

La eliminación del elemento conservará la capacidad de la lista y no reducirá la cantidad de memoria asignada. Para liberar capacidad sobrante y liberar tanta memoria como sea posible, llama a ` squeeze()`.

Nota: Cuando ` QList ` no se comparte implícitamente, esta función solo invalida los iteradores situados en la posición especificada o posteriores a ella.

Véase también ` insert()` y ` remove()`.

QList<T>::iterator QList::erase(QList<T>::const_iterator begin, QList<T>::const_iterator end)

Elimina todos los elementos de begin hasta (sin incluirlo) end. Devuelve un iterador que apunta al mismo elemento al que hacía referencia end antes de la llamada.

La eliminación de elementos conservará la capacidad de la lista y no reducirá la cantidad de memoria asignada. Para liberar capacidad sobrante y liberar tanta memoria como sea posible, llama a squeeze().

Nota: Cuando QList no se comparte implícitamente, esta función solo invalida los iteradores situados en la posición especificada o posteriores a ella.

Esta es una función sobrecargada.

QList<T> &QList::fill(QList<T>::parameter_type value, qsizetype size = -1)

Asigna « value » a todos los elementos de la lista. Si « size » es distinto de -1 (el valor por defecto), la lista se redimensiona previamente a « size ».

Ejemplo:

QList<QString> list(3);
list.fill("Yes");
// list: ["Yes", "Yes", "Yes"]

list.fill("oh", 5);
// list: ["oh", "oh", "oh", "oh", "oh"]

Véase también resize().

T &QList::first()

Devuelve una referencia al primer elemento de la lista. Esta función da por hecho que la lista no está vacía.

Véase también last(), isEmpty() y constFirst().

[since 6.0] QList<T> QList::first(qsizetype n) const

Devuelve una sublista que contiene los primeros n elementos de esta lista.

Nota: El comportamiento es indefinido cuando n < 0 o n > size().

Esta función se introdujo en Qt 6.0.

Véase también last() y sliced().

[noexcept] const T &QList::first() const

Esta es una función sobrecargada.

QList<T>::reference QList::front()

Esta función se ofrece para garantizar la compatibilidad con la STL. Es equivalente a ` first()`.

[noexcept] QList<T>::const_reference QList::front() const

Esta es una función sobrecargada.

[noexcept] template <typename AT> qsizetype QList::indexOf(const AT &value, qsizetype from = 0) const

Devuelve la posición en la lista de la primera aparición de « value », buscando hacia adelante a partir de la posición from. Devuelve -1 si no se encuentra ningún elemento que coincida.

Ejemplo:

QList<QString> list{"A", "B", "C", "B", "A"};
list.indexOf("B");            // returns 1
list.indexOf("B", 1);         // returns 1
list.indexOf("B", 2);         // returns 3
list.indexOf("X");            // returns -1

Esta función requiere que el tipo de valor cuente con una implementación de ` operator==()`.

Véase también ` lastIndexOf()` y ` contains()`.

QList<T>::iterator QList::insert(qsizetype i, QList<T>::parameter_type value)

QList<T>::iterator QList::insert(qsizetype i, QList<T>::rvalue_ref value)

Inserta « value » en la posición de índice « i » de la lista. Si « i » es 0, el valor se añade al principio de la lista. Si « i » es « size()», el valor se añade al final de la lista.

Ejemplo:

QList<QString> list = {"alpha", "beta", "delta"};
list.insert(2, "gamma");
// list: ["alpha", "beta", "gamma", "delta"]

En listas grandes, esta operación puede resultar lenta (tiempo lineal), ya que requiere desplazar una posición más allá en la memoria todos los elementos situados en los índices i y superiores. Si deseas una clase contenedora que ofrezca una función insert() rápida, utiliza en su lugar std::list.

Véase también append(), prepend() y remove().

QList<T>::iterator QList::insert(QList<T>::const_iterator before, qsizetype count, QList<T>::parameter_type value)

Inserta count copias de value delante del elemento al que apunta el iterador before. Devuelve un iterador que apunta al primero de los elementos insertados.

QList<T>::iterator QList::insert(QList<T>::const_iterator before, QList<T>::parameter_type value)

QList<T>::iterator QList::insert(QList<T>::const_iterator before, QList<T>::rvalue_ref value)

Inserta value delante del elemento al que apunta el iterador before. Devuelve un iterador que apunta al elemento insertado.

QList<T>::iterator QList::insert(qsizetype i, qsizetype count, QList<T>::parameter_type value)

Inserta count copias de value en la posición de índice i de la lista.

Ejemplo:

QList<double> list = {2.718, 1.442, 0.4342};
list.insert(1, 3, 9.9);
// list: [2.718, 9.9, 9.9, 9.9, 1.442, 0.4342]

Esta es una función sobrecargada.

[constexpr noexcept] bool QList::isEmpty() const

Devuelve ` true ` si la lista tiene tamaño 0; en caso contrario, devuelve ` false`.

Véase también size() y resize().

T &QList::last()

Devuelve una referencia al último elemento de la lista. Esta función da por hecho que la lista no está vacía.

Véase también first(), isEmpty() y constLast().

[since 6.0] QList<T> QList::last(qsizetype n) const

Devuelve una sublista que contiene los últimos n elementos de esta lista.

Nota: El comportamiento es indefinido cuando n < 0 o n > size().

Esta función se introdujo en Qt 6.0.

Véase también first() y sliced().

[noexcept] const T &QList::last() const

Esta es una función sobrecargada.

[noexcept] template <typename AT> qsizetype QList::lastIndexOf(const AT &value, qsizetype from = -1) const

Devuelve la posición en la lista de la última aparición del valor value, buscando hacia atrás a partir de la posición from. Si from es -1 (valor por defecto), la búsqueda comienza en el último elemento. Devuelve -1 si no se encuentra ningún elemento que coincida.

Ejemplo:

QList<QString> list = {"A", "B", "C", "B", "A"};
list.lastIndexOf("B");        // returns 3
list.lastIndexOf("B", 3);     // returns 3
list.lastIndexOf("B", 2);     // returns 1
list.lastIndexOf("X");        // returns -1

Esta función requiere que el tipo de valor tenga una implementación de operator==().

Véase también indexOf().

[constexpr noexcept] qsizetype QList::length() const

Igual que size() y count().

Véase también size() y count().

[static constexpr, since 6.8] qsizetype QList::maxSize()

[constexpr noexcept, since 6.8] qsizetype QList::max_size() const

Devuelve el número máximo de elementos que la lista puede contener teóricamente. En la práctica, este número puede ser mucho menor, ya que está limitado por la cantidad de memoria disponible en el sistema.

Estas funciones se introdujeron en Qt 6.8.

QList<T> QList::mid(qsizetype pos, qsizetype length = -1) const

Devuelve una sublista que contiene elementos de esta lista, a partir de la posición pos. Si length es -1 (valor por defecto), se incluyen todos los elementos posteriores a pos; en caso contrario, se incluyen length elementos (o todos los elementos restantes si hay menos de length elementos).

void QList::move(qsizetype from, qsizetype to)

Mueve el elemento de la posición de índice from a la posición de índice to.

from y to deben estar dentro de los límites.

Por ejemplo, para mover el primer elemento al final de la lista:

QList<int> lista = {1, 2, 3};
lista.move(0, lista.size() - 1);
qDebug() << list; // Prints "QList(2, 3, 1)"

[noexcept] void QList::pop_back()

Esta función se proporciona para garantizar la compatibilidad con STL. Es equivalente a « removeLast()».

[noexcept] void QList::pop_front()

Esta función se ofrece para garantizar la compatibilidad con STL. Es equivalente a ` removeFirst()`.

void QList::prepend(QList<T>::parameter_type value)

void QList::prepend(QList<T>::rvalue_ref value)

Inserta « value » al principio de la lista.

Ejemplo:

QList<QString> list;
list.prepend("one");
list.prepend("two");
list.prepend("three");
// list: ["three", "two", "one"]

Esto equivale a list.insert(0, value).

Normalmente, esta operación es relativamente rápida ( tiempo constante amortizado). ` QList ` es capaz de asignar memoria adicional al principio de los datos de la lista y crecer en esa dirección sin necesidad de reasignar ni mover los datos en cada operación. Sin embargo, si deseas una clase contenedora que garantice un tiempo constante para la inserción al principio, utiliza `std::list` en su lugar; de lo contrario, es preferible utilizar ` QList `.

Véase también append() y insert().

void QList::push_back(QList<T>::parameter_type value)

Esta función se ofrece para garantizar la compatibilidad con STL. Es equivalente a `append(value)`.

void QList::push_back(QList<T>::rvalue_ref value)

Esta es una función sobrecargada.

void QList::push_front(QList<T>::parameter_type value)

void QList::push_front(QList<T>::rvalue_ref value)

Esta función se proporciona para garantizar la compatibilidad con la STL. Es equivalente a prepend(value).

QList<T>::reverse_iterator QList::rbegin()

Devuelve un iterador inverso al estilo STL que apunta al primer elemento de la lista, en orden inverso.

Advertencia: El iterador devuelto deja de ser válido al desacoplarse o cuando se modifica el ` QList `.

Véase también « begin()», « crbegin()» y « rend()».

[noexcept] QList<T>::const_reverse_iterator QList::rbegin() const

Esta es una función sobrecargada.

void QList::remove(qsizetype i, qsizetype n = 1)

Elimina n elementos de la lista, empezando por el índice i.

La eliminación de elementos conservará la capacidad de la lista y no reducirá la cantidad de memoria asignada. Para liberar capacidad sobrante y liberar tanta memoria como sea posible, llama a ` squeeze()`.

Nota: Cuando QList no se comparte implícitamente, esta función solo invalida los iteradores situados en la posición especificada o posteriores a ella.

Véase también insert(), replace() y fill().

template <typename AT = T> qsizetype QList::removeAll(const AT &t)

Elimina de la lista todos los elementos que sean iguales a t. Devuelve el número de elementos eliminados, si los hay.

La eliminación de elementos mantendrá la capacidad de la lista y no reducirá la cantidad de memoria asignada. Para liberar capacidad sobrante y liberar tanta memoria como sea posible, llama a ` squeeze()`.

Véase también removeOne().

void QList::removeAt(qsizetype i)

Elimina el elemento situado en el índice i. Equivalente a

remove(i);

La eliminación del elemento conservará la capacidad de la lista y no reducirá la cantidad de memoria asignada. Para liberar capacidad sobrante y liberar tanta memoria como sea posible, llama a squeeze().

Nota: Cuando QList no se comparte implícitamente, esta función solo invalida los iteradores situados en la posición especificada o posteriores a ella.

Véase también ` remove()`.

[noexcept] void QList::removeFirst()

Elimina el primer elemento de la lista. Llamar a esta función equivale a llamar a `remove(0)`. La lista no debe estar vacía. Si la lista puede estar vacía, llama a ` isEmpty()` antes de llamar a esta función.

La eliminación de elementos conservará la capacidad de la lista y no reducirá la cantidad de memoria asignada. Para liberar capacidad sobrante y liberar tanta memoria como sea posible, llama a ` squeeze()`.

Véase también ` remove()`, ` takeFirst()` y ` isEmpty()`.

[since 6.1] template <typename Predicate> qsizetype QList::removeIf(Predicate pred)

Elimina de la lista todos los elementos para los que el predicado « pred » devuelve «true». Devuelve el número de elementos eliminados, si los hay.

Esta función se introdujo en Qt 6.1.

Véase también removeAll().

[noexcept] void QList::removeLast()

Elimina el último elemento de la lista. Llamar a esta función equivale a llamar a `remove(size() - 1)`. La lista no debe estar vacía. Si la lista puede estar vacía, llama a ` isEmpty()` antes de llamar a esta función.

La eliminación de elementos conservará la capacidad de la lista y no reducirá la cantidad de memoria asignada. Para liberar capacidad sobrante y liberar tanta memoria como sea posible, llama a ` squeeze()`.

Véanse también remove(), takeLast(), removeFirst() y isEmpty().

template <typename AT = T> bool QList::removeOne(const AT &t)

Elimina de la lista el primer elemento que coincida con ` t `. Devuelve si, efectivamente, se ha eliminado algún elemento.

La eliminación de elementos conservará la capacidad de la lista y no reducirá la cantidad de memoria asignada. Para liberar capacidad sobrante y liberar tanta memoria como sea posible, llama a squeeze().

Véase también removeAll().

QList<T>::reverse_iterator QList::rend()

Devuelve un iterador inverso al estilo STL que apunta justo después del último elemento de la lista, en orden inverso.

Advertencia: El iterador devuelto queda invalidado al desacoplarse o cuando se modifica el ` QList `.

Véase también ` end()`, ` crend()` y ` rbegin()`.

[noexcept] QList<T>::const_reverse_iterator QList::rend() const

Esta es una función sobrecargada.

void QList::replace(qsizetype i, QList<T>::parameter_type value)

void QList::replace(qsizetype i, QList<T>::rvalue_ref value)

Sustituye el elemento situado en la posición de índice i por value.

i Debe ser una posición de índice válida en la lista (es decir, 0 <= i < size()).

Véanse también operator[]() y remove().

void QList::reserve(qsizetype size)

Intenta asignar memoria para al menos size elementos.

Si sabes de antemano cuál será el tamaño de la lista, deberías llamar a esta función para evitar reasignaciones y la fragmentación de la memoria. Si cambias el tamaño de la lista con frecuencia, es probable que también obtengas un mejor rendimiento.

En caso de duda sobre cuánto espacio se necesitará, suele ser mejor utilizar un límite superior como ` size`, o una estimación alta del tamaño más probable, si un límite superior estricto fuera mucho mayor que este. Si size es una subestimación, la lista crecerá según sea necesario una vez que se supere el tamaño reservado, lo que puede dar lugar a una asignación mayor de la que habría supuesto tu mejor sobreestimación y ralentizará la operación que la desencadena.

Advertencia: reserve () reserva memoria, pero no modifica el tamaño de la lista. Acceder a datos más allá del final actual de la lista es un comportamiento indefinido. Si necesitas acceder a memoria más allá del final actual de la lista, utiliza resize().

Véase también squeeze(), capacity() y resize().

[since 6.0] void QList::resize(qsizetype size)

[since 6.0] void QList::resize(qsizetype size, QList<T>::parameter_type c)

Establece el tamaño de la lista en ` size`. Si ` size ` es mayor que el tamaño actual, los elementos se añaden al final; los nuevos elementos se inicializan con un valor construido por defecto o con ` c`. Si ` size ` es menor que el tamaño actual, los elementos se eliminan del final.

Si esta lista no es compartida, se conserva la función capacity(). Utiliza squeeze() para liberar el exceso de capacidad.

Nota: En las versiones de Qt anteriores a la 5.7 (para QVector; QList carecía de resize() hasta la versión 6.0), esta función liberaba la memoria utilizada por la lista en lugar de conservar la capacidad.

Estas funciones se introdujeron en Qt 6.0.

Véase también size().

[since 6.8] void QList::resizeForOverwrite(qsizetype size)

Establece el tamaño de la lista en ` size`. Si ` size ` es menor que el tamaño actual, se eliminan elementos del final. Si ` size ` es mayor que el tamaño actual, se añaden elementos al final; ` QList ` intentará no inicializar estos nuevos elementos.

Concretamente:

  • si T tiene un constructor que acepta Qt::Uninitialized, se utilizará ese constructor para inicializar los elementos;
  • en caso contrario, cada elemento se construirá de forma predeterminada. Para los tipos que se pueden construir de forma trivial (como int, float, etc.), esto equivale a no inicializarlos.

Esta función se introdujo en Qt 6.8.

void QList::shrink_to_fit()

Esta función se ofrece para garantizar la compatibilidad con la STL. Es equivalente a ` squeeze()`.

[constexpr noexcept] qsizetype QList::size() const

Devuelve el número de elementos de la lista.

Véase también isEmpty() y resize().

[since 6.0] QList<T> QList::sliced(qsizetype pos, qsizetype n) const

Devuelve una sublista que contiene n elementos de esta lista, a partir de la posición pos.

Nota: El comportamiento es indefinido cuando pos < 0, n < 0 o pos + n > size().

Esta función se introdujo en Qt 6.0.

Véase también first() y last().

[since 6.0] QList<T> QList::sliced(qsizetype pos) const

Devuelve una sublista que contiene los elementos de esta lista, empezando en la posición pos y hasta el final de la misma.

Nota: El comportamiento es indefinido cuando pos < 0 o pos > size().

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

Véase también first() y last().

void QList::squeeze()

Libera toda la memoria que no sea necesaria para almacenar los elementos.

El único propósito de esta función es proporcionar un medio para ajustar con precisión el uso de memoria de QList. En general, rara vez necesitarás llamar a esta función.

Véase también reserve() y capacity().

bool QList::startsWith(QList<T>::parameter_type value) const

Devuelve « true » si esta lista no está vacía y su primer elemento es igual a « value »; en caso contrario, devuelve « false ».

Véase también isEmpty() y first().

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

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

void QList::swapItemsAt(qsizetype i, qsizetype j)

Intercambia el elemento de la posición de índice i por el elemento de la posición de índice j. Esta función da por hecho que tanto i como j son al menos 0, pero menores que size(). Para evitar errores, comprueba que tanto i como j sean al menos 0 y menores que size().

T QList::takeAt(qsizetype i)

Elimina el elemento situado en el índice i y lo devuelve.

Equivalente a

T t = at(i);
remove(i);
return t;

Nota: Cuando QList no se comparte implícitamente, esta función solo invalida los iteradores situados en la posición especificada o posteriores a ella.

Véase también takeFirst() y takeLast().

QList<T>::value_type QList::takeFirst()

Elimina el primer elemento de la lista y lo devuelve. Esta función da por hecho que la lista no está vacía. Para evitar errores, llama a isEmpty() antes de llamar a esta función.

Véanse también takeLast() y removeFirst().

QList<T>::value_type QList::takeLast()

Elimina el último elemento de la lista y lo devuelve. Esta función da por hecho que la lista no está vacía. Para evitar errores, llama a ` isEmpty()` antes de llamar a esta función.

Si no utilizas el valor devuelto, es más eficiente utilizar ` removeLast()`.

Véase también takeFirst() y removeLast().

T QList::value(qsizetype i) const

Devuelve el valor situado en la posición de índice i de la lista.

Si el índice i está fuera de los límites, la función devuelve un valor construido por defecto. Si estás seguro de que i está dentro de los límites, puedes utilizar at() en su lugar, que es ligeramente más rápido.

Véanse también at() y operator[]().

T QList::value(qsizetype i, QList<T>::parameter_type defaultValue) const

Si el índice i está fuera de límites, la función devuelve defaultValue.

Esta es una función sobrecargada.

bool QList::operator!=(const QList<T> &other) const

Devuelve ` true ` si ` other ` no es igual a esta lista; en caso contrario, devuelve ` false`.

Se considera que dos listas son iguales si contienen los mismos valores en el mismo orden.

Esta función requiere que el tipo de valor tenga una implementación de ` operator==()`.

Véase también operator==().

QList<T> QList::operator+(QList<T> &&other) &&

QList<T> QList::operator+(const QList<T> &other) &&

QList<T> QList::operator+(QList<T> &&other) const &

QList<T> QList::operator+(const QList<T> &other) const &

Devuelve una lista que contiene todos los elementos de esta lista, seguidos de todos los elementos de la lista « other ».

Véase también operator+=().

QList<T> &QList::operator+=(const QList<T> &other)

Añade los elementos de la lista other a esta lista y devuelve una referencia a esta lista.

Véase también ` operator+()` y ` append()`.

[since 6.0] QList<T> &QList::operator+=(QList<T> &&other)

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

Véase también operator+() y append().

QList<T> &QList::operator+=(QList<T>::parameter_type value)

Añade « value » a la lista.

Esta es una función sobrecargada.

Véanse también append() y operator<<().

QList<T> &QList::operator+=(QList<T>::rvalue_ref value)

Esta es una función sobrecargada.

Véanse también append() y operator<<().

bool QList::operator<(const QList<T> &other) const

Devuelve ` true ` si esta lista es léxicamente menor que ` other`; en caso contrario, devuelve ` false`.

Esta función requiere que el tipo de valor cuente con una implementación de operator<().

QList<T> &QList::operator<<(QList<T>::parameter_type value)

Añade « value » a la lista y devuelve una referencia a dicha lista.

Véase también append() y operator+=().

QList<T> &QList::operator<<(const QList<T> &other)

Añade « other » a la lista y devuelve una referencia a la misma.

[since 6.0] QList<T> &QList::operator<<(QList<T> &&other)

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

QList<T> &QList::operator<<(QList<T>::rvalue_ref value)

Esta es una función sobrecargada.

Véanse también append() y operator+=().

bool QList::operator<=(const QList<T> &other) const

Devuelve ` true ` si esta lista es léxicamente menor o igual que ` other`; en caso contrario, devuelve ` false`.

Esta función requiere que el tipo de valor cuente con una implementación de ` operator<()`.

[implicit] QList<T> &QList::operator=(QList<T> &&other)

Asigna « other » a esta instancia de « QList ». » a esta instancia de « ».

[implicit] QList<T> &QList::operator=(const QList<T> &other)

Asigna ` other ` a esta lista y devuelve una referencia a dicha lista.

QList<T> &QList::operator=(std::initializer_list<T> args)

Asigna el conjunto de valores de args a esta instancia de QList.

bool QList::operator==(const QList<T> &other) const

Devuelve « true » si « other » es igual a esta lista; en caso contrario, devuelve « false ».

Se considera que dos listas son iguales si contienen los mismos valores en el mismo orden.

Esta función requiere que el tipo de valor cuente con una implementación de ` operator==()`.

Véase también operator!=().

bool QList::operator>(const QList<T> &other) const

Devuelve ` true ` si esta lista es léxicamente mayor que ` other`; en caso contrario, devuelve ` false`.

Esta función requiere que el tipo de valor cuente con una implementación de ` operator<()`.

bool QList::operator>=(const QList<T> &other) const

Devuelve ` true ` si esta lista es léxicamente mayor o igual que ` other`; en caso contrario, devuelve ` false`.

Esta función requiere que el tipo de valor cuente con una implementación de ` operator<()`.

QList<T>::reference QList::operator[](qsizetype i)

Devuelve el elemento situado en la posición de índice i como una referencia modificable.

i Debe ser una posición de índice válida en la lista (es decir, 0 <= i < size()).

Ten en cuenta que el uso de operadores no const puede hacer que ` QList ` realice una copia profunda.

Véase también at() y value().

[noexcept] QList<T>::const_reference QList::operator[](qsizetype i) const

Igual que en (i).

Esta es una función sobrecargada.

Elementos no miembros relacionados

[since 6.1] template <typename T, typename AT> qsizetype erase(QList<T> &list, const AT &t)

Elimina de la lista list todos los elementos que sean iguales a t. Devuelve el número de elementos eliminados, si los hay.

Nota: A diferencia de QList::removeAll, t no puede ser una referencia a un elemento dentro de list. Si no estás seguro de que este no sea el caso, haz una copia de t y llama a esta función con la copia.

Esta función se introdujo en Qt 6.1.

Véase también QList::removeAll() y erase_if.

[since 6.1] template <typename T, typename Predicate> qsizetype erase_if(QList<T> &list, Predicate pred)

Elimina de la lista list todos los elementos para los que el predicado pred devuelve «true». Devuelve el número de elementos eliminados, si los hay.

Esta función se introdujo en Qt 6.1.

Véase también erase.

[noexcept(...)] template <typename T> size_t qHash(const QList<T> &key, size_t seed = 0)

Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.

El tipo ` T ` debe ser compatible con `qHash()`.

Nota: Esta función es «noexcept» cuando noexcept(qHashRange(key.cbegin(), key.cend(), seed)) es true.

template <typename T> QDataStream &operator<<(QDataStream &out, const QList<T> &list)

Escribe la lista « list » en el flujo « out ».

Esta función requiere que el tipo de valor implemente operator<<().

Véase también el formato de los operadores de QDataStream.

[since 6.9] auto operator<=>(const QList<T> &lhs, const QList<T> &rhs)

Compara el contenido de lhs y rhs de forma lexicográfica. Devuelve el resultado del tipo de categoría más fuerte aplicable, es decir, decltype(lhs[0] <=> rhs[0]) si operator<=>() está disponible para el tipo T; en caso contrario, std::weak_ordering.

Nota: Este operador solo está disponible en modo C++20, y cuando el tipo subyacente T cumple el concepto std::three_way_comparable o proporciona operator<().

Esta función se introdujo en Qt 6.9.

template <typename T> QDataStream &operator>>(QDataStream &in, QList<T> &list)

Lee una lista del flujo « in » y la guarda en « list ».

Esta función requiere que el tipo de valor implemente operator>>().

Véase también el formato de los operadores de QDataStream.

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