QVarLengthArray Class

Documentación de funciones miembro

[noexcept] QVarLengthArray::QVarLengthArray()

Construye una matriz con un tamaño inicial de cero.

[explicit] QVarLengthArray::QVarLengthArray(qsizetype size)

Construye 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 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)

Construye un array a partir de la lista std::initializer_list dada por args.

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

Construye un array con el contenido en el rango del iterador [first, last).

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

Restricciones

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

[explicit, since 6.4] QVarLengthArray::QVarLengthArray(qsizetype size, const T &v)

Construye un array con un tamaño inicial de size elementos lleno de copias de v.

Esta función se introdujo en Qt 6.4.

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

QVarLengthArray::QVarLengthArray(const QVarLengthArray<T, Prealloc> &other)

Construye una copia de other.

[noexcept(...), since 6.0] QVarLengthArray::QVarLengthArray(QVarLengthArray<T, Prealloc> &&other)

Mover-construye esta matriz de longitud variable a partir de other. Después del movimiento, other queda vacío.

Esta función se introdujo en Qt 6.0.

QVarLengthArray::~QVarLengthArray()

Destruye 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 size cantidad de elementos referenciados por buf a esta matriz.

void QVarLengthArray::append(T &&t)

vla.append(std::move(vla[0])); // BUG: passing an object that is already in the container

[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 sólo asigna memoria si el número de elementos en list excede 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 sólo asignará memoria si el número de elementos del rango excede la capacidad del contenedor.

El comportamiento es indefinido si cualquiera de los argumentos es un iterador dentro de *this.

Restricciones

Participa en la resolución de sobrecargas sólo 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)

Reemplaza el contenido de este contenedor con n copias de t.

El tamaño de este contenedor será igual a n. Esta función sólo asignará memoria si n excede 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 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()

Igual que last(). Se proporciona por compatibilidad con STL.

const T &QVarLengthArray::back() const

QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::begin()

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

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

QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::begin() const

qsizetype QVarLengthArray::capacity() const

Devuelve el número máximo de elementos que se pueden almacenar en la matriz sin forzar una reasignación.

El único propósito de esta función es proporcionar un medio para ajustar el uso de memoria de QVarLengthArray. En general, rara vez necesitará llamar a esta función. Si desea saber cuántos elementos hay en la matriz, llame a size().

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

QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::cbegin() const

Devuelve un iterador const de 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 const de estilo STL que apunta al elemento imaginario después del último elemento de la matriz.

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

void QVarLengthArray::clear()

Elimina todos los elementos del array.

Igual que resize(0).

QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::constBegin() const

Devuelve un iterador const de 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 constante a los datos almacenados en la matriz. El puntero puede utilizarse para acceder a los elementos de la matriz. El puntero seguirá siendo válido mientras no se reasigne la matriz.

Esta función es muy útil para pasar un array a una función que acepte un array C++ plano.

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

QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::constEnd() const

Devuelve un iterador const de estilo STL que apunta al elemento imaginario 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 una ocurrencia 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 de estilo const 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 de estilo STL que apunta 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 puede utilizarse 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 permanece válido mientras el array no sea reasignado.

Esta función es muy útil para pasar un array a una función que acepte un array C++ plano.

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

const T *QVarLengthArray::data() const

[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 apuntado por el iterador pos, pasando args a su constructor.

Devuelve un iterador apuntando al elemento colocado.

Esta función se introdujo en Qt 6.3.

[since 6.3] template <typename... Args> T &QVarLengthArray::emplace_back(Args &&... args)

Inserta un elemento en la parte posterior de este QVarLengthArray, pasando args a su constructor.

Devuelve una referencia al elemento colocado.

Esta función se introdujo en Qt 6.3.

bool QVarLengthArray::empty() const

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

Igual que isEmpty(). Proporcionado por 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

QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::erase(QVarLengthArray<T, Prealloc>::const_iterator pos)

Elimina del vector el elemento apuntado por el iterador pos, y devuelve un iterador al siguiente elemento del vector (que puede ser end()).

Véase 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 de begin hasta (pero sin incluir) end. Devuelve un iterador al mismo elemento al que end hacía referencia antes de la llamada.

T &QVarLengthArray::first()

Devuelve una referencia al primer elemento de la matriz. La matriz no debe estar vacía. Si el array puede estar vacío, compruebe isEmpty() antes de llamar a esta función.

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

const T &QVarLengthArray::first() const

T &QVarLengthArray::front()

Igual que first(). Se proporciona por compatibilidad con STL.

const T &QVarLengthArray::front() const

template <typename AT = T> qsizetype QVarLengthArray::indexOf(const AT &value, qsizetype from = 0) const

Devuelve la posición del índice de la primera aparición de value en la matriz, buscando hacia adelante desde la posición del índice from. Devuelve -1 si no aparece ningún elemento.

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

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

Inserta value en la posición de índice i de la matriz. Si i es 0, el valor se añade al vector. Si i es size(), el valor se añade al vector.

Para matrices grandes, esta operación puede ser lenta(tiempo lineal), porque requiere mover todos los elementos en los índices i y superiores una posición más en memoria. Si desea una clase contenedora que proporcione una función rápida insert(), utilice 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 apuntado por el iterador before. Devuelve un iterador que apunta al primero de los elementos insertados.

Inserta value delante del elemento apuntado por el iterador before. Devuelve un iterador apuntando 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 en el vector.

bool QVarLengthArray::isEmpty() const

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

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

T &QVarLengthArray::last()

Devuelve una referencia al último elemento de la matriz. La matriz no debe estar vacía. Si el array puede estar vacío, compruebe isEmpty() antes de llamar a esta función.

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

const T &QVarLengthArray::last() const

template <typename AT = T> qsizetype QVarLengthArray::lastIndexOf(const AT &value, qsizetype from = -1) const

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

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

Véase también indexOf() y contains().

qsizetype QVarLengthArray::length() const

Igual que size().

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

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

Estas funciones se introdujeron en Qt 6.8.

void QVarLengthArray::pop_back()

Igual que removeLast(). Se proporciona por 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 por compatibilidad con STL.

void QVarLengthArray::push_back(T &&t)

vla.push_back(std::move(vla[0])); // BUG: passing an object that is already in the container

QVarLengthArray<T, Prealloc>::reverse_iterator QVarLengthArray::rbegin()

Devuelve un iterador inverso de 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

void QVarLengthArray::remove(qsizetype i, qsizetype count = 1)

Elimina count elementos de la matriz, comenzando 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()). count debe ser <= size() - i. i == size() está permitido si count == 0.

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

[since 6.1] template <typename AT = T> qsizetype QVarLengthArray::removeAll(const AT &t)

Elimina de la matriz todos los elementos cuya comparación sea igual 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.1] template <typename Predicate> qsizetype QVarLengthArray::removeIf(Predicate pred)

Elimina del array todos los elementos para los que el predicado pred devuelve verdadero. 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()

Disminuye 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 de la matriz el primer elemento cuya comparación sea igual a t. Devuelve si un elemento fue, de hecho, eliminado.

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 de estilo STL que apunta al último elemento de la matriz de longitud variable, en orden inverso.

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

QVarLengthArray<T, Prealloc>::const_reverse_iterator QVarLengthArray::rend() const

void QVarLengthArray::replace(qsizetype i, const T &value)

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

i debe ser una posición de índice válida en el array (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 lo grande que puede llegar a ser el array, puedes llamar a esta función y si llamas a resize() a menudo, es probable que obtengas un mejor rendimiento. Si size es una subestimación, lo peor que ocurrirá es que QVarLengthArray será un poco más lento.

El único propósito de esta función es proporcionar un medio para afinar el uso de memoria de QVarLengthArray. En general, rara vez necesitará llamar a esta función. Si desea cambiar el tamaño de la matriz, llame 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 puntero (por ejemplo, QWidget *), los nuevos elementos no se inicializan. Para otros tipos, los elementos se inicializan con un valor construido por defecto.

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

[since 6.4] void QVarLengthArray::resize(qsizetype size, const T &v)

Establece el tamaño de la matriz en size. Si size es mayor que el tamaño actual, se añaden copias de v al final. Si size es menor que el tamaño actual, se eliminan elementos del final.

Esta función se introdujo en Qt 6.4.

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

void QVarLengthArray::shrink_to_fit()

Igual que squeeze(). Se proporciona por compatibilidad con STL.

qsizetype QVarLengthArray::size() const

Devuelve el número de elementos de la matriz.

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

void QVarLengthArray::squeeze()

Libera la memoria que no sea necesaria para almacenar los elementos. Si el contenedor puede encajar su almacenamiento en la asignación de la pila, liberará la asignación de la pila y copiará los elementos de nuevo a la pila.

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

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

T QVarLengthArray::value(qsizetype i) const

Devuelve el valor en la posición del índice i.

Si el índice i está fuera de los límites, la función devuelve un valor construido por defecto. Si está seguro de que i está dentro de los límites, puede 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 los límites, la función devuelve defaultValue.

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)

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)

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

[noexcept(...), since 6.0] QVarLengthArray<T, Prealloc> &QVarLengthArray::operator=(QVarLengthArray<T, Prealloc> &&other)

Mueve-asigna other a este array y devuelve una referencia a este array. Después del movimiento, other está vacío.

Esta función se introdujo en Qt 6.0.

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 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 data() y at().

const T &QVarLengthArray::operator[](qsizetype i) const