QVarLengthArray Class
template <typename T, qsizetype Prealloc> class QVarLengthArrayLa clase QVarLengthArray proporciona una matriz de longitud variable de bajo nivel. Más información...
| Encabezado: | #include <QVarLengthArray> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QVLABase y QVLAStorage |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QVarLengthArray forma parte de las clases de contenedores.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos públicos
| const_iterator | |
| const_pointer | |
| const_reference | |
| const_reverse_iterator | |
| difference_type | |
| iterator | |
| pointer | |
| reference | |
| reverse_iterator | |
| size_type | |
| value_type |
Funciones públicas
| QVarLengthArray() | |
| QVarLengthArray(qsizetype size) | |
| QVarLengthArray(std::initializer_list<T> args) | |
| QVarLengthArray(InputIterator first, InputIterator last) | |
(since 6.4) | QVarLengthArray(qsizetype size, const T &v) |
| QVarLengthArray(const QVarLengthArray<T, Prealloc> &other) | |
(since 6.0) | QVarLengthArray(QVarLengthArray<T, Prealloc> &&other) |
| ~QVarLengthArray() | |
| void | append(const T &t) |
| void | append(const T *buf, qsizetype size) |
| void | append(T &&t) |
(since 6.6) QVarLengthArray<T, Prealloc> & | assign(std::initializer_list<T> list) |
(since 6.6) QVarLengthArray<T, Prealloc> & | assign(InputIterator first, InputIterator last) |
(since 6.6) QVarLengthArray<T, Prealloc> & | assign(qsizetype n, const T &t) |
| const T & | at(qsizetype i) const |
| T & | back() |
| const T & | back() const |
| QVarLengthArray<T, Prealloc>::iterator | begin() |
| QVarLengthArray<T, Prealloc>::const_iterator | begin() const |
| qsizetype | capacity() const |
| QVarLengthArray<T, Prealloc>::const_iterator | cbegin() const |
| QVarLengthArray<T, Prealloc>::const_iterator | cend() const |
| void | clear() |
| QVarLengthArray<T, Prealloc>::const_iterator | constBegin() const |
| const T * | constData() const |
| QVarLengthArray<T, Prealloc>::const_iterator | constEnd() const |
| bool | contains(const AT &value) const |
| qsizetype | count() const |
| QVarLengthArray<T, Prealloc>::const_reverse_iterator | crbegin() const |
| QVarLengthArray<T, Prealloc>::const_reverse_iterator | crend() const |
| T * | data() |
| const T * | data() const |
(since 6.3) QVarLengthArray<T, Prealloc>::iterator | emplace(QVarLengthArray<T, Prealloc>::const_iterator pos, Args &&... args) |
(since 6.3) T & | emplace_back(Args &&... args) |
| bool | empty() const |
| QVarLengthArray<T, Prealloc>::iterator | end() |
| QVarLengthArray<T, Prealloc>::const_iterator | end() const |
| QVarLengthArray<T, Prealloc>::iterator | erase(QVarLengthArray<T, Prealloc>::const_iterator pos) |
| QVarLengthArray<T, Prealloc>::iterator | erase(QVarLengthArray<T, Prealloc>::const_iterator begin, QVarLengthArray<T, Prealloc>::const_iterator end) |
| T & | first() |
| const T & | first() const |
| T & | front() |
| const T & | front() const |
| qsizetype | indexOf(const AT &value, qsizetype from = 0) const |
| void | insert(qsizetype i, T &&value) |
| void | insert(qsizetype i, const T &value) |
| QVarLengthArray<T, Prealloc>::iterator | insert(QVarLengthArray<T, Prealloc>::const_iterator before, qsizetype count, const T &value) |
| QVarLengthArray<T, Prealloc>::iterator | insert(QVarLengthArray<T, Prealloc>::const_iterator before, T &&value) |
| QVarLengthArray<T, Prealloc>::iterator | insert(QVarLengthArray<T, Prealloc>::const_iterator before, const T &value) |
| void | insert(qsizetype i, qsizetype count, const T &value) |
| bool | isEmpty() const |
| T & | last() |
| const T & | last() const |
| qsizetype | lastIndexOf(const AT &value, qsizetype from = -1) const |
| qsizetype | length() const |
(since 6.8) qsizetype | max_size() const |
| void | pop_back() |
| void | push_back(const T &t) |
| void | push_back(T &&t) |
| QVarLengthArray<T, Prealloc>::reverse_iterator | rbegin() |
| QVarLengthArray<T, Prealloc>::const_reverse_iterator | rbegin() const |
| void | remove(qsizetype i, qsizetype count = 1) |
(since 6.1) qsizetype | removeAll(const AT &t) |
(since 6.12) void | removeAt(qsizetype i) |
(since 6.1) qsizetype | removeIf(Predicate pred) |
| void | removeLast() |
(since 6.1) bool | removeOne(const AT &t) |
| QVarLengthArray<T, Prealloc>::reverse_iterator | rend() |
| QVarLengthArray<T, Prealloc>::const_reverse_iterator | rend() const |
| void | replace(qsizetype i, const T &value) |
| void | reserve(qsizetype size) |
| void | resize(qsizetype size) |
(since 6.4) void | resize(qsizetype size, const T &v) |
| void | shrink_to_fit() |
| qsizetype | size() const |
| void | squeeze() |
| T | value(qsizetype i) const |
| T | value(qsizetype i, const T &defaultValue) const |
| QVarLengthArray<T, Prealloc> & | operator+=(const T &value) |
| QVarLengthArray<T, Prealloc> & | operator+=(T &&value) |
| QVarLengthArray<T, Prealloc> & | operator<<(const T &value) |
| QVarLengthArray<T, Prealloc> & | operator<<(T &&value) |
(since 6.0) QVarLengthArray<T, Prealloc> & | operator=(QVarLengthArray<T, Prealloc> &&other) |
| QVarLengthArray<T, Prealloc> & | operator=(const QVarLengthArray<T, Prealloc> &other) |
| QVarLengthArray<T, Prealloc> & | operator=(std::initializer_list<T> list) |
| T & | operator[](qsizetype i) |
| const T & | operator[](qsizetype i) const |
Miembros públicos estáticos
(since 6.8) qsizetype | maxSize() |
Elementos no miembros relacionados
(since 6.1) qsizetype | erase(QVarLengthArray<T, Prealloc> &array, const AT &t) |
(since 6.1) qsizetype | erase_if(QVarLengthArray<T, Prealloc> &array, Predicate pred) |
| size_t | qHash(const QVarLengthArray<T, Prealloc> &key, size_t seed = 0) |
| bool | operator!=(const QVarLengthArray<T, Prealloc1> &left, const QVarLengthArray<T, Prealloc2> &right) |
| bool | operator<(const QVarLengthArray<T, Prealloc1> &lhs, const QVarLengthArray<T, Prealloc2> &rhs) |
| bool | operator<=(const QVarLengthArray<T, Prealloc1> &lhs, const QVarLengthArray<T, Prealloc2> &rhs) |
| bool | operator==(const QVarLengthArray<T, Prealloc1> &left, const QVarLengthArray<T, Prealloc2> &right) |
| bool | operator>(const QVarLengthArray<T, Prealloc1> &lhs, const QVarLengthArray<T, Prealloc2> &rhs) |
| bool | operator>=(const QVarLengthArray<T, Prealloc1> &lhs, const QVarLengthArray<T, Prealloc2> &rhs) |
Descripción detallada
El lenguaje C++ no admite matrices de longitud variable en la pila. Por ejemplo, el siguiente código no se compilará:
int myfunc_wrong(int n)
{
int table[n + 1]; // WRONG
//...
return table[n];
}La alternativa es asignar la matriz en el montón (con ` new`):
int myfunc_correct(int n)
{
int *table = new int[n + 1];
//...
int ret = table[n];
delete[] table;
return ret;
}Sin embargo, si se llama a `myfunc()` con mucha frecuencia desde el bucle interno de la aplicación, la asignación en el montón puede suponer una importante fuente de ralentización.
QVarLengthArray es un intento de solucionar esta carencia del lenguaje C++. Asigna un número determinado de elementos en la pila y, si se amplía el tamaño de la matriz, utiliza automáticamente el montón. La asignación en la pila tiene la ventaja de que es mucho más rápida que la asignación en el montón.
Ejemplo:
int myfunc_q(int n)
{
QVarLengthArray<int, 1024> array(n + 1);
//...
return array[n];
}En el ejemplo anterior, QVarLengthArray preasignará 1024 elementos en la pila y los utilizará a menos que n + 1 sea mayor que 1024. El parámetro de plantilla T especifica el tipo de elemento y Prealloc especifica cuántos elementos se deben preasignar en la pila; si se omite, Prealloc toma por defecto el valor 256.
El tipo de valor de `QVarLengthArray` 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 *`.
QVarLengthArray, al igual que ` QList`, proporciona una estructura de datos de matriz redimensionable. Las principales diferencias entre ambas clases son:
- La API de `QVarLengthArray` es mucho más de bajo nivel y carece de algunas de las funcionalidades de ` QList`.
- QVarLengthArray no inicializa la memoria si el valor es de un tipo básico. (QList siempre lo hace.)
- QList xml-ph-0000@deepl.internal utiliza el uso compartido implícito como optimización de memoria. QVarLengthArray no ofrece esa característica; sin embargo, suele ofrecer un rendimiento ligeramente mejor debido a la reducción de la sobrecarga, especialmente en bucles muy ajustados.
En resumen, QVarLengthArray es una clase de optimización de bajo nivel que solo tiene sentido en casos muy específicos. Se utiliza en algunos puntos dentro de Qt y se añadió a la API pública de Qt para comodidad de los usuarios avanzados.
Véase también QList.
Documentación sobre tipos de miembros
[alias] QVarLengthArray::const_iterator
Definición de tipo para const T*. Se proporciona para garantizar la compatibilidad con la STL.
[alias] QVarLengthArray::const_pointer
Definición de tipo para const T *. Se proporciona para garantizar la compatibilidad con la STL.
[alias] QVarLengthArray::const_reference
Definición de tipo para `const T &`. Se proporciona para garantizar la compatibilidad con la STL.
[alias] QVarLengthArray::const_reverse_iterator
Definición de tipo para ` std::reverse_iterator<const T*>`. Se proporciona para garantizar la compatibilidad con la STL.
[alias] QVarLengthArray::difference_type
Definición de tipo para ptrdiff_t. Se proporciona para garantizar la compatibilidad con la STL.
[alias] QVarLengthArray::iterator
Definición de tipo para T*. Se proporciona para garantizar la compatibilidad con la STL.
[alias] QVarLengthArray::pointer
Definición de tipo para T*. Se proporciona para garantizar la compatibilidad con la STL.
[alias] QVarLengthArray::reference
Definición de tipo para T &. Se proporciona para garantizar la compatibilidad con la STL.
[alias] QVarLengthArray::reverse_iterator
Definición de tipo para ` std::reverse_iterator<T*>`. Se proporciona para garantizar la compatibilidad con la STL.
[alias] QVarLengthArray::size_type
Definición de tipo para «int». Se proporciona para garantizar la compatibilidad con la STL.
[alias] QVarLengthArray::value_type
Definición de tipo para T. Se proporciona para garantizar la compatibilidad con la STL.
Documentación de las funciones miembro
[noexcept] QVarLengthArray::QVarLengthArray()
Crea un array con un tamaño inicial de cero.
[explicit] QVarLengthArray::QVarLengthArray(qsizetype size)
Crea un array con un tamaño inicial de size elementos.
Si el tipo de valor es un tipo primitivo (por ejemplo, char, int, float) o un tipo de puntero (por ejemplo, QWidget *), los elementos no se inicializan. Para otros tipos, los elementos se inicializan con un valor construido por defecto.
QVarLengthArray::QVarLengthArray(std::initializer_list<T> args)
Crea un array a partir de la lista de inicializadores std::initializer_list proporcionada por args.
template <typename InputIterator, QVarLengthArray<T, Prealloc>::if_input_iterator<InputIterator> = true> QVarLengthArray::QVarLengthArray(InputIterator first, InputIterator last)
Crea una matriz 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 solo si InputIterator cumple los requisitos de un LegacyInputIterator.
[explicit, since 6.4] QVarLengthArray::QVarLengthArray(qsizetype size, const T &v)
Crea un array con un tamaño inicial de size elementos, rellenado con copias de v.
Nota: Este constructor solo está disponible cuando T se puede construir mediante copia.
Esta función se introdujo en Qt 6.4.
Véase también size() y squeeze().
QVarLengthArray::QVarLengthArray(const QVarLengthArray<T, Prealloc> &other)
Crea una copia de other.
[noexcept(...), since 6.0] QVarLengthArray::QVarLengthArray(QVarLengthArray<T, Prealloc> &&other)
Crea mediante una operación de traslado este array de longitud variable a partir de other. Tras el traslado, other queda vacío.
Esta función se introdujo en Qt 6.0.
Nota: Esta función es «noexcept» cuando std::is_nothrow_move_constructible_v<T> es true.
QVarLengthArray::~QVarLengthArray()
Elimina el array.
void QVarLengthArray::append(const T &t)
Añade el elemento t a la matriz, ampliándola si es necesario.
Véase también removeLast().
void QVarLengthArray::append(const T *buf, qsizetype size)
Añade a este array la cantidad de elementos indicada en size a los que hace referencia buf.
void QVarLengthArray::append(T &&t)
Nota: A diferencia de la sobrecarga de lvalue de `append()`, pasar una referencia a un objeto que ya forma parte de ` *this ` da lugar a un comportamiento indefinido:
vla.append(std::move(vla[0])); // BUG: passing an object that is already in the containerEsta función sobrecarga ` QVarLengthArray::append`.
[since 6.6] QVarLengthArray<T, Prealloc> &QVarLengthArray::assign(std::initializer_list<T> list)
Sustituye el contenido de este contenedor por una copia de los elementos de list.
El tamaño de este contenedor será igual al número de elementos de list.
Esta función solo asigna memoria si el número de elementos de list supera la capacidad del contenedor.
Esta función se introdujo en Qt 6.6.
[since 6.6] template <typename InputIterator, QVarLengthArray<T, Prealloc>::if_input_iterator<InputIterator> = true> QVarLengthArray<T, Prealloc> &QVarLengthArray::assign(InputIterator first, InputIterator last)
Sustituye el contenido de este contenedor por una copia de los elementos del rango del iterador [first, last).
El tamaño de este contenedor 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 del contenedor.
El comportamiento es indefinido si cualquiera de los argumentos es un iterador sobre *this.
Restricciones
Participa en la resolución de sobrecargas solo si InputIterator cumple los requisitos de un LegacyInputIterator.
Esta función se introdujo en Qt 6.6.
[since 6.6] QVarLengthArray<T, Prealloc> &QVarLengthArray::assign(qsizetype n, const T &t)
Sustituye el contenido de este contenedor por n copias de t.
El tamaño de este contenedor será igual a n. Esta función solo asignará memoria si n supera la capacidad del contenedor.
Esta función se introdujo en Qt 6.6.
const T &QVarLengthArray::at(qsizetype i) const
Devuelve una referencia al elemento situado en la posición de índice i.
i Debe ser una posición de índice válida en la matriz (es decir, 0 <= i < size()).
Véase también value() y operator[]().
T &QVarLengthArray::back()
Es igual que ` last()`. Se proporciona para garantizar la compatibilidad con STL.
const T &QVarLengthArray::back() const
Esta es una función sobrecargada.
QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::begin()
Devuelve un iterador de tipo STL que apunta al primer elemento de la matriz.
Véase también constBegin() y end().
QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::begin() const
Esta es una función sobrecargada.
qsizetype QVarLengthArray::capacity() const
Devuelve el número máximo de elementos que se pueden almacenar en el array 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 QVarLengthArray. En general, rara vez necesitarás llamar a esta función. Si quieres saber cuántos elementos hay en el array, llama a size().
Véase también reserve() y squeeze().
QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::cbegin() const
Devuelve un iterador constante al estilo STL que apunta al primer elemento de la matriz.
Véase también begin() y cend().
QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::cend() const
Devuelve un iterador constante al estilo STL que apunta al elemento imaginario situado después del último elemento del array.
Véase también cbegin() y end().
void QVarLengthArray::clear()
Elimina todos los elementos del array.
Es lo mismo que resize(0).
QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::constBegin() const
Devuelve un iterador constante al estilo STL que apunta al primer elemento de la matriz.
Véase también begin() y constEnd().
const T *QVarLengthArray::constData() const
Devuelve un puntero const a los datos almacenados en el array. El puntero se puede utilizar para acceder a los elementos del array. El puntero sigue siendo válido siempre y cuando no se reasigne el array.
Esta función resulta especialmente útil para pasar un array a una función que acepte un array de C++ sin formato.
Véase también data() y operator[]().
QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::constEnd() const
Devuelve un iterador constante al estilo STL que apunta al elemento imaginario situado después del último elemento de la matriz.
Véase también ` constBegin()` y ` end()`.
template <typename AT = T> bool QVarLengthArray::contains(const AT &value) const
Devuelve ` true ` si el array 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éase también indexOf() y lastIndexOf().
qsizetype QVarLengthArray::count() const
Igual que size().
Véase también isEmpty() y resize().
QVarLengthArray<T, Prealloc>::const_reverse_iterator QVarLengthArray::crbegin() const
Devuelve un iterador inverso constante al estilo STL que apunta al primer elemento de la matriz de longitud variable, en orden inverso.
Véase también begin(), rbegin() y rend().
QVarLengthArray<T, Prealloc>::const_reverse_iterator QVarLengthArray::crend() const
Devuelve un iterador inverso constante al estilo STL que apunta a la posición inmediatamente posterior al último elemento de la matriz de longitud variable, en orden inverso.
Véase también end(), rend() y rbegin().
T *QVarLengthArray::data()
Devuelve un puntero a los datos almacenados en la matriz. El puntero se puede utilizar para acceder a los elementos de la matriz y modificarlos.
Ejemplo:
QVarLengthArray<int> array(10);
int *data = array.data();
for (int i = 0; i < 10; ++i)
data[i] = 2 * i;El puntero sigue siendo válido siempre y cuando no se reasigne la memoria del array.
Esta función resulta especialmente útil para pasar un array a una función que acepte un array simple de C++.
Véase también constData() y operator[]().
const T *QVarLengthArray::data() const
Esta es una función sobrecargada.
[since 6.3] template <typename... Args> QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::emplace(QVarLengthArray<T, Prealloc>::const_iterator pos, Args &&... args)
Inserta un elemento delante del elemento al que apunta el iterador pos, pasando args a su constructor.
Devuelve un iterador que apunta al elemento insertado.
Esta función se introdujo en Qt 6.3.
[since 6.3] template <typename... Args> T &QVarLengthArray::emplace_back(Args &&... args)
Inserta un elemento al final de este ` QVarLengthArray`, pasando ` args ` a su constructor.
Devuelve una referencia al elemento insertado.
Esta función se introdujo en Qt 6.3.
bool QVarLengthArray::empty() const
Devuelve ` true ` si el tamaño del array es 0; en caso contrario, devuelve ` false`.
Equivalente a ` isEmpty()`. Se proporciona para garantizar la compatibilidad con STL.
QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::end()
Devuelve un iterador de estilo STL que apunta al elemento imaginario situado después del último elemento de la matriz.
Véase también begin() y constEnd().
QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::end() const
Esta es una función sobrecargada.
QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::erase(QVarLengthArray<T, Prealloc>::const_iterator pos)
Elimina del vector el elemento al que apunta el iterador pos y devuelve un iterador al siguiente elemento del vector (que puede ser end()).
Véanse también insert() y remove().
QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::erase(QVarLengthArray<T, Prealloc>::const_iterator begin, QVarLengthArray<T, Prealloc>::const_iterator end)
Elimina todos los elementos desde begin hasta (sin incluir) end. Devuelve un iterador que apunta al mismo elemento al que hacía referencia end antes de la llamada.
Se trata de una función sobrecargada.
T &QVarLengthArray::first()
Devuelve una referencia al primer elemento del array. El array no debe estar vacío. Si el array puede estar vacío, comprueba isEmpty() antes de llamar a esta función.
Véase también last() y isEmpty().
const T &QVarLengthArray::first() const
Esta es una función sobrecargada.
T &QVarLengthArray::front()
Es igual que ` first()`. Se proporciona para garantizar la compatibilidad con STL.
const T &QVarLengthArray::front() const
Esta es una función sobrecargada.
template <typename AT = T> qsizetype QVarLengthArray::indexOf(const AT &value, qsizetype from = 0) const
Devuelve la posición en el índice de la primera aparición de « value » en la matriz, buscando hacia delante a partir de la posición del índice « from ». Devuelve -1 si no se encuentra ningún elemento que coincida.
Esta función requiere que el tipo de valor tenga una implementación de ` operator==()`.
Véanse también ` lastIndexOf()` y ` contains()`.
void QVarLengthArray::insert(qsizetype i, T &&value)
void QVarLengthArray::insert(qsizetype i, const T &value)
Inserta value en la posición de índice i del vector. Si i es 0, el valor se añade al principio del vector. Si i es size(), el valor se añade al final del vector.
En el caso de matrices 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 necesitas una clase contenedora que ofrezca una función insert() rápida, utiliza std::list en su lugar.
Véase también remove().
QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::insert(QVarLengthArray<T, Prealloc>::const_iterator before, qsizetype count, const T &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.
QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::insert(QVarLengthArray<T, Prealloc>::const_iterator before, T &&value)
QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::insert(QVarLengthArray<T, Prealloc>::const_iterator before, const T &value)
Inserta value delante del elemento al que apunta el iterador before. Devuelve un iterador que apunta al elemento insertado.
void QVarLengthArray::insert(qsizetype i, qsizetype count, const T &value)
Inserta count copias de value en la posición de índice i del vector.
Esta es una función sobrecargada.
bool QVarLengthArray::isEmpty() const
Devuelve ` true ` si el tamaño del array es 0; en caso contrario, devuelve ` false`.
Véase también size() y resize().
T &QVarLengthArray::last()
Devuelve una referencia al último elemento del array. El array no debe estar vacío. Si el array puede estar vacío, comprueba isEmpty() antes de llamar a esta función.
Véanse también first() y isEmpty().
const T &QVarLengthArray::last() const
Esta es una función sobrecargada.
template <typename AT = T> qsizetype QVarLengthArray::lastIndexOf(const AT &value, qsizetype from = -1) const
Devuelve la posición en el índice de la última aparición del valor « value » en la matriz, buscando hacia atrás a partir de la posición del índice « 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.
Esta función requiere que el tipo de valor cuente con una implementación de operator==().
Véanse también indexOf() y contains().
qsizetype QVarLengthArray::length() const
Igual que size().
Véase también isEmpty() y resize().
[static constexpr noexcept, since 6.8] qsizetype QVarLengthArray::maxSize()
[constexpr noexcept, since 6.8] qsizetype QVarLengthArray::max_size() const
Devuelve el número máximo de elementos que la matriz 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.
void QVarLengthArray::pop_back()
Es igual que ` removeLast()`. Se proporciona para garantizar la compatibilidad con STL.
void QVarLengthArray::push_back(const T &t)
Añade el elemento ` t ` a la matriz, ampliándola si es necesario. Se proporciona para garantizar la compatibilidad con STL.
void QVarLengthArray::push_back(T &&t)
Nota: A diferencia de la sobrecarga de `push_back()` para lvalue, pasar una referencia a un objeto que ya forma parte de ` *this ` da lugar a un comportamiento indefinido:
vla.push_back(std::move(vla[0])); // BUG: passing an object that is already in the containerEsta función sobrecarga ` QVarLengthArray::push_back`.
QVarLengthArray<T, Prealloc>::reverse_iterator QVarLengthArray::rbegin()
Devuelve un iterador inverso al estilo STL que apunta al primer elemento de la matriz de longitud variable, en orden inverso.
Véase también begin(), crbegin() y rend().
QVarLengthArray<T, Prealloc>::const_reverse_iterator QVarLengthArray::rbegin() const
Esta es una función sobrecargada.
void QVarLengthArray::remove(qsizetype i, qsizetype count = 1)
Elimina los elementos count del array, empezando por el índice i.
i Debe ser una posición de índice válida en el array (es decir, 0 <= i < size()). count debe ser <= size() - i. Se permite que i == size() si count == 0.
Véase también insert() y replace().
[since 6.1] template <typename AT = T> qsizetype QVarLengthArray::removeAll(const AT &t)
Elimina del array todos los elementos que sean iguales a t. Devuelve el número de elementos eliminados, si los hay.
Esta función se introdujo en Qt 6.1.
Véase también removeOne().
[since 6.12] void QVarLengthArray::removeAt(qsizetype i)
Elimina del array el elemento situado en la posición i.
i Debe ser una posición de índice válida en la matriz (es decir, 0 <= i < size()).
Esta función se proporciona por motivos de compatibilidad con QList.
Esta función se introdujo en Qt 6.12.
Véanse también insert() y replace().
[since 6.1] template <typename Predicate> qsizetype QVarLengthArray::removeIf(Predicate pred)
Elimina del array 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().
void QVarLengthArray::removeLast()
Reduce el tamaño del array en uno. El tamaño asignado no se modifica.
Véase también append().
[since 6.1] template <typename AT = T> bool QVarLengthArray::removeOne(const AT &t)
Elimina del array el primer elemento que sea igual a t. Devuelve si, efectivamente, se ha eliminado algún elemento.
Esta función se introdujo en Qt 6.1.
Véase también removeAll().
QVarLengthArray<T, Prealloc>::reverse_iterator QVarLengthArray::rend()
Devuelve un iterador inverso al estilo STL que apunta a la posición inmediatamente posterior al último elemento de la matriz de longitud variable, en orden inverso.
Véanse también end(), crend() y rbegin().
QVarLengthArray<T, Prealloc>::const_reverse_iterator QVarLengthArray::rend() const
Esta es una función sobrecargada.
void QVarLengthArray::replace(qsizetype i, const T &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 matriz (es decir, 0 <= i < size()).
Véase también operator[]() y remove().
void QVarLengthArray::reserve(qsizetype size)
Intenta asignar memoria para al menos size elementos. Si sabes de antemano cuál puede ser el tamaño máximo de la matriz, puedes llamar a esta función; si utilizas con frecuencia resize(), es probable que consigas un mejor rendimiento. Si size es una estimación a la baja, lo peor que puede pasar es que QVarLengthArray sea un poco más lento.
El único propósito de esta función es proporcionar un medio para ajustar con precisión el uso de memoria de QVarLengthArray. En general, rara vez necesitarás llamar a esta función. Si deseas cambiar el tamaño del array, llama a resize().
Véase también capacity() y squeeze().
void QVarLengthArray::resize(qsizetype size)
Establece el tamaño de la matriz en ` size`. Si ` size ` es mayor que el tamaño actual, se añaden elementos al final. Si ` size ` es menor que el tamaño actual, se eliminan elementos del final.
Si el tipo de valor es un tipo primitivo (por ejemplo, char, int, float) o un tipo de puntero (por ejemplo, QWidget *), los nuevos elementos no se inicializan. Para otros tipos, los elementos se inicializan con un valor construido por defecto.
Véanse también size() y squeeze().
[since 6.4] void QVarLengthArray::resize(qsizetype size, const T &v)
Establece el tamaño del array en ` size`. Si ` size ` es mayor que el tamaño actual, se añaden al final copias de ` v `. Si ` size ` es menor que el tamaño actual, se eliminan elementos del final.
Nota: Esta función solo está disponible cuando T es constructible por copia.
Esta función se introdujo en Qt 6.4.
Véanse también size() y squeeze().
void QVarLengthArray::shrink_to_fit()
Es lo mismo que ` squeeze()`. Se proporciona para garantizar la compatibilidad con STL.
qsizetype QVarLengthArray::size() const
Devuelve el número de elementos del array.
Véase también isEmpty() y resize().
void QVarLengthArray::squeeze()
Libera toda la memoria que no sea necesaria para almacenar los elementos. Si el contenedor puede caber en la asignación de la pila, liberará la asignación del montón y copiará los elementos de nuevo a la pila.
El único propósito de esta función es proporcionar un medio para ajustar con precisión el uso de memoria de QVarLengthArray. En general, rara vez será necesario llamar a esta función.
Véase también reserve(), capacity() y resize().
T QVarLengthArray::value(qsizetype i) const
Devuelve el valor situado en la posición de índice i.
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éase también at() y operator[]().
T QVarLengthArray::value(qsizetype i, const T &defaultValue) const
Si el índice i está fuera de límites, la función devuelve defaultValue.
Esta es una función sobrecargada.
QVarLengthArray<T, Prealloc> &QVarLengthArray::operator+=(const T &value)
Añade value a la matriz y devuelve una referencia a este vector.
Véase también append() y operator<<().
QVarLengthArray<T, Prealloc> &QVarLengthArray::operator+=(T &&value)
Esta es una función sobrecargada.
Véase también append() y operator<<().
QVarLengthArray<T, Prealloc> &QVarLengthArray::operator<<(const T &value)
Añade ` value ` a la matriz y devuelve una referencia a este vector.
Véase también append() y operator+=().
QVarLengthArray<T, Prealloc> &QVarLengthArray::operator<<(T &&value)
Esta es una función sobrecargada.
Véase también append() y operator+=().
[noexcept(...), since 6.0] QVarLengthArray<T, Prealloc> &QVarLengthArray::operator=(QVarLengthArray<T, Prealloc> &&other)
La función «move-assigns» asigna « other » a este array y devuelve una referencia a este array. Tras la asignación, « other » queda vacío.
Esta función se introdujo en Qt 6.0.
Nota: Esta función es «noexcept» cuando std::is_nothrow_move_constructible_v<T> es true.
QVarLengthArray<T, Prealloc> &QVarLengthArray::operator=(const QVarLengthArray<T, Prealloc> &other)
Asigna ` other ` a este array y devuelve una referencia a este array.
QVarLengthArray<T, Prealloc> &QVarLengthArray::operator=(std::initializer_list<T> list)
Asigna los valores de list a este array y devuelve una referencia a este array.
T &QVarLengthArray::operator[](qsizetype i)
Devuelve una referencia al elemento situado en la posición de índice i.
i Debe ser una posición de índice válida en el array (es decir, 0 <= i < size()).
const T &QVarLengthArray::operator[](qsizetype i) const
Esta es una función sobrecargada.
Elementos no miembros relacionados
[since 6.1] template <
typename T,
qsizetype Prealloc,
typename AT
>
qsizetype erase(QVarLengthArray<T, Prealloc> &array, const AT &t)
Elimina del array array todos los elementos que coincidan con t. Devuelve el número de elementos eliminados, si los hay.
Nota: No se permite quet sea una referencia a un elemento dentro de array. 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 erase_if().
[since 6.1] template <
typename T,
qsizetype Prealloc,
typename Predicate
>
qsizetype erase_if(QVarLengthArray<T, Prealloc> &array, Predicate pred)
Elimina de la lista array todos los elementos para los que el predicado pred devuelve «true». Devuelve el número de elementos eliminados, si los hay. El tamaño de preasignación Prealloc no afecta a la operación.
Esta función se introdujo en Qt 6.1.
Véase también erase().
[noexcept(...)] template <typename T, qsizetype Prealloc> size_t qHash(const QVarLengthArray<T, Prealloc> &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().
Devuelve el valor hash para key, utilizando seed como semilla para el cálculo. El tamaño de preasignación Prealloc no afecta al hash.
Nota: Esta función es «noexcept» cuando ` QtPrivate::QNothrowHashable_v<T> ` es ` true`.
template < typename T, qsizetype Prealloc1, qsizetype Prealloc2 > bool operator!=(const QVarLengthArray<T, Prealloc1> &left, const QVarLengthArray<T, Prealloc2> &right)
Devuelve ` true ` si los dos matrices, especificados por ` left ` y ` right`, no son iguales. Los tamaños de preasignación ` Prealloc1 ` y ` Prealloc2 ` pueden diferir.
Se considera que dos matrices 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==().
template < typename T, qsizetype Prealloc1, qsizetype Prealloc2 > bool operator<(const QVarLengthArray<T, Prealloc1> &lhs, const QVarLengthArray<T, Prealloc2> &rhs)
Devuelve ` true ` si la matriz de longitud variable ` lhs ` es lexicográficamente menor que ` rhs`; en caso contrario, devuelve ` false`. Los tamaños de preasignación ` Prealloc1 ` y ` Prealloc2 ` pueden diferir.
Esta función requiere que el tipo de valor cuente con una implementación de operator<().
template < typename T, qsizetype Prealloc1, qsizetype Prealloc2 > bool operator<=(const QVarLengthArray<T, Prealloc1> &lhs, const QVarLengthArray<T, Prealloc2> &rhs)
Devuelve « true » si la matriz de longitud variable « lhs » es lexicográficamente menor o igual que « rhs »; en caso contrario, devuelve « false ». Los tamaños de preasignación « Prealloc1 » y « Prealloc2 » pueden diferir.
Esta función requiere que el tipo de valor cuente con una implementación de operator<().
template < typename T, qsizetype Prealloc1, qsizetype Prealloc2 > bool operator==(const QVarLengthArray<T, Prealloc1> &left, const QVarLengthArray<T, Prealloc2> &right)
Devuelve ` true ` si los dos matrices, especificados por ` left ` y ` right`, son iguales. Los tamaños de preasignación ` Prealloc1 ` y ` Prealloc2 ` pueden diferir.
Se considera que dos matrices 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!=().
template < typename T, qsizetype Prealloc1, qsizetype Prealloc2 > bool operator>(const QVarLengthArray<T, Prealloc1> &lhs, const QVarLengthArray<T, Prealloc2> &rhs)
Devuelve ` true ` si la matriz de longitud variable ` lhs ` es lexicográficamente mayor que ` rhs`; en caso contrario, devuelve ` false`. Los tamaños preasignados ` Prealloc1 ` y ` Prealloc2 ` pueden diferir.
Esta función requiere que el tipo de valor cuente con una implementación de ` operator<()`.
template < typename T, qsizetype Prealloc1, qsizetype Prealloc2 > bool operator>=(const QVarLengthArray<T, Prealloc1> &lhs, const QVarLengthArray<T, Prealloc2> &rhs)
Devuelve ` true ` si la matriz de longitud variable ` lhs ` es lexicográficamente mayor o igual que ` rhs`; en caso contrario, devuelve ` false`. Los tamaños de preasignación ` Prealloc1 ` y ` Prealloc2 ` pueden diferir.
Esta función requiere que el tipo de valor cuente con una implementación de ` operator<()`.
© 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.