QVarLengthArray Class

成员函数文档

它返回数组理论上可容纳的最大元素数。在实际应用中，受系统可用内存量的限制，这个数字可能会小得多。

此函数在 Qt 6.8 中引入。

将value 插入数组中的索引位置i 。如果i 为 0，则将该值预输入到向量中。如果i 是size() ，则将该值添加到向量中。

对于大型数组，这一操作可能会很慢（线性时间），因为它需要将i 及以上索引位置的所有项在内存中移动一个位置。如果你想要一个提供快速insert() 函数的容器类，请使用 std::list 代替。

另请参见 remove()。

这是一个重载函数。

在迭代器before 指向的项目前插入value 。返回指向插入项的迭代器。

[noexcept] QVarLengthArray::QVarLengthArray()

构造一个初始大小为 0 的数组。

[explicit] QVarLengthArray::QVarLengthArray(qsizetype size)

构造一个数组，其初始大小为size 。

如果值类型是基元类型（如 char、int、float）或指针类型（如QWidget *），则不初始化元素。对于其他类型，则使用默认构造值对元素进行初始化。

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

用args 给出的 std::initializer_list 构造数组。

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

构造一个数组，其内容在迭代器范围 [first,last) 内。

InputIterator 的值类型必须可转换为T 。

限制条件

只有当InputIterator 满足LegacyInputIterator 的要求时，才会参与重载解析。

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

构造一个数组，其初始大小为size ，数组中充满v 的副本。

此函数在 Qt 6.4 中引入。

另请参阅 size() 和squeeze()。

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

构造other 的副本。

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

Move- 从other 开始构建这个变长数组。移动后，other 为空。

此函数在 Qt 6.0 中引入。

QVarLengthArray::~QVarLengthArray()

销毁数组。

void QVarLengthArray::append(const T &t)

将项目t 添加到数组，必要时扩展数组。

另请参阅 removeLast().

void QVarLengthArray::append(const T *buf, qsizetype size)

将buf 引用的size 数量追加到此数组。

void QVarLengthArray::append(T &&t)

此函数重载 append。

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)

用list 中元素的副本替换此容器的内容。

该容器的大小等于list 中的元素数量。

只有当list 中的元素数量超过容器的容量时，该函数才会分配内存。

此函数在 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)

用迭代器范围 [first,last) 中元素的副本替换此容器的内容。

此容器的大小等于范围 [first,last) 中元素的数量。只有当范围中的元素数超过容器的容量时，该函数才会分配内存。

如果任一参数是进入 *this 的迭代器，则行为未定义。

限制条件

只有当InputIterator 满足LegacyInputIterator 的要求时，才会参与重载解析。

此函数在 Qt 6.6 中引入。

[since 6.6] QVarLengthArray<T, Prealloc> &QVarLengthArray::assign(qsizetype n, const T &t)

用n 和t 的副本替换此容器的内容。

此容器的大小将等于n 。只有当n 超过容器的容量时，此函数才会分配内存。

此函数在 Qt 6.6 中引入。

const T &QVarLengthArray::at(qsizetype i) const

返回位于i 索引位置的项目的引用。

i 必须是数组中有效的索引位置（即 0 <= < () ）。i size

另请参阅 value() 和operator[]()。

T &QVarLengthArray::back()

与last() 相同。提供 STL 兼容性。

const T &QVarLengthArray::back() const

这是一个重载函数。

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

返回一个STL 样式的迭代器，指向数组中的第一个项目。

另请参阅 constBegin() 和end()。

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

这是一个重载函数。

qsizetype QVarLengthArray::capacity() const

返回数组在不强制重新分配的情况下可存储的最大元素数。

该函数的唯一目的是提供一种微调QVarLengthArray 内存使用情况的方法。一般情况下，您很少需要调用此函数。如果想知道数组中有多少项，请调用size() 。

另请参阅 reserve() 和squeeze()。

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

返回指向数组中第一个项目的 ConstSTL 样式迭代器。

另请参阅 begin() 和cend()。

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

返回一个常STL 样式的迭代器，指向数组中最后一个项目之后的虚数项目。

另请参阅 cbegin() 和end() 。

void QVarLengthArray::clear()

删除数组中的所有元素。

与 resize(0) 相同。

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

返回指向数组中第一个项目的 ConstSTL 样式迭代器。

另请参阅 begin() 和constEnd()。

const T *QVarLengthArray::constData() const

返回存储在数组中的数据的常量指针。该指针可用于访问数组中的项目。只要数组没有被重新分配，指针就一直有效。

该函数主要用于将数组传递给接受纯 C++ 数组的函数。

另请参阅 data() 和operator[]()。

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

返回一个常STL 样式的迭代器，指向数组中最后一个项目之后的虚数项目。

另请参阅 constBegin() 和end() 。

template <typename AT = T> bool QVarLengthArray::contains(const AT &value) const

如果数组中包含value ，则返回true ；否则返回false 。

该函数要求值类型具有operator==() 的实现。

另请参见 indexOf() 和lastIndexOf()。

qsizetype QVarLengthArray::count() const

与size() 相同。

另请参阅 isEmpty() 和resize() 。

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

返回一个 ConstSTL 样式的反向迭代器，按相反顺序指向变长数组中的第一个项目。

另请参见 begin()、rbegin() 和rend()。

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

返回一个 ConstSTL 样式的反向迭代器，以相反的顺序指向变长数组中最后一个项目的后面一个项目。

另请参见 end()、rend() 和rbegin()。

T *QVarLengthArray::data()

返回存储在数组中数据的指针。该指针可用于访问和修改数组中的项目。

举例说明

QVarLengthArray<int> array(10);
int *data = array.data();
for (int i = 0; i < 10; ++i)
    data[i] = 2 * i;

只要数组没有被重新分配，指针就一直有效。

该函数主要用于将数组传递给接受纯 C++ 数组的函数。

另请参阅 constData() 和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)

在迭代器pos 指向的项目前插入一个项目，并将args 传递给它的构造函数。

返回指向插入项的迭代器。

此函数在 Qt 6.3 中引入。

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

在QVarLengthArray 的后部插入一个项目，并将args 传递给它的构造函数。

返回对插入项的引用。

此函数在 Qt 6.3 中引入。

bool QVarLengthArray::empty() const

如果数组大小为 0，则返回true ；否则返回false 。

与isEmpty() 相同。与 STL 兼容。

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

返回一个STL 样式的迭代器，指向数组中最后一个项目之后的虚数项目。

另请参阅 begin() 和constEnd()。

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

这是一个重载函数。

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

从向量中删除迭代器pos 指向的项目，并返回指向向量中下一个项目的迭代器（可能是end() ）。

另请参阅 insert() 和remove()。

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

这是一个重载函数。

删除begin 至end （但不包括 ）的所有项目。返回一个迭代器，指向调用前end 所指向的同一项目。

T &QVarLengthArray::first()

返回数组中第一个项目的引用。数组不能为空。如果数组可能为空，请在调用此函数前检查isEmpty() 。

另请参阅 last() 和isEmpty()。

const T &QVarLengthArray::first() const

这是一个重载函数。

T &QVarLengthArray::front()

与first() 相同。提供 STL 兼容性。

const T &QVarLengthArray::front() const

这是一个重载函数。

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

返回value 在数组中首次出现的索引位置，从索引位置from 开始向前搜索。如果没有匹配项，则返回-1。

此函数要求值类型具有operator==() 的实现。

另请参阅 lastIndexOf() 和contains()。

QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::insert(QVarLengthArray<T, Prealloc>::const_iterator before, qsizetype count, const T &value)

在迭代器before 指向的项目前插入count value 的副本。返回指向第一个插入项的迭代器。

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

这是一个重载函数。

在向量的索引位置i 插入count 份value 。

bool QVarLengthArray::isEmpty() const

如果数组大小为 0，则返回true ；否则返回false 。

另请参见 size() 和resize()。

T &QVarLengthArray::last()

返回数组中最后一个项目的引用。数组不得为空。如果数组可能为空，请在调用此函数前检查isEmpty() 。

另请参阅 first() 和isEmpty()。

const T &QVarLengthArray::last() const

这是一个重载函数。

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

返回数组中最后出现的value 值的索引位置，从索引位置from 开始向后搜索。如果from 为 -1（默认值），则从最后一项开始搜索。如果没有匹配项，则返回-1。

此函数要求值类型具有operator==() 的实现。

另请参见 indexOf() 和contains()。

qsizetype QVarLengthArray::length() const

与size() 相同。

另请参阅 isEmpty() 和resize() 。

void QVarLengthArray::pop_back()

与removeLast() 相同。提供 STL 兼容性。

void QVarLengthArray::push_back(const T &t)

将项目t 添加到数组中，必要时扩展数组。提供 STL 兼容性。

void QVarLengthArray::push_back(T &&t)

此函数重载 push_back。

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

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

返回一个STL 样式的反向迭代器，以相反的顺序指向变长数组中的第一个项目。

另请参阅 begin()、crbegin() 和rend()。

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

这是一个重载函数。

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

这是一个重载函数。

从数组中间删除count 元素，从索引位置i 开始。

另请参见 insert() 和replace()。

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

删除数组中所有比较值等于t 的元素。如果有，则返回删除的元素数。

此函数在 Qt 6.1 中引入。

另请参阅 removeOne()。

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

从数组中删除谓词pred 返回 true 的所有元素。如果有，则返回移除元素的个数。

此函数在 Qt 6.1 中引入。

另请参阅 removeAll()。

void QVarLengthArray::removeLast()

将数组的大小减小一个。分配的大小不会改变。

另请参阅 append().

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

从数组中删除第一个比较值等于t 的元素。返回元素是否已被移除。

此函数在 Qt 6.1 中引入。

另请参阅 removeAll()。

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

返回一个STL 样式的反向迭代器，以相反的顺序指向变长数组中最后一个项目的后面一个项目。

另请参见 end()、crend() 和rbegin()。

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

这是一个重载函数。

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

用value 替换索引位置i 上的项目。

i 必须是数组中有效的索引位置（即 0 <= < () ）。i size

另请参阅 operator[]() 和remove()。

void QVarLengthArray::reserve(qsizetype size)

尝试为至少size 个元素分配内存。如果事先知道数组能有多大，就可以调用这个函数，如果经常调用resize() ，性能可能会更好。如果size 是一个低估的值，那么最坏的情况就是QVarLengthArray 会慢一些。

该函数的唯一目的是提供一种微调QVarLengthArray 内存使用情况的方法。一般来说，你很少需要调用这个函数。如果要改变数组的大小，请调用resize() 。

另请参阅 capacity() 和squeeze()。

void QVarLengthArray::resize(qsizetype size)

将数组的大小设置为size 。如果size 大于当前大小，则在末尾添加元素。如果size 小于当前大小，则从末尾移除元素。

如果值类型是原始类型（如 char、int、float）或指针类型（如QWidget *），则不会初始化新元素。对于其他类型，则使用默认构造值初始化元素。

另请参见 size() 和squeeze()。

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

将数组的大小设置为size 。如果size 大于当前大小，则在末尾添加v 的副本。如果size 小于当前大小，则从末尾删除元素。

此函数在 Qt 6.4 中引入。

另请参阅 size() 和squeeze()。

void QVarLengthArray::shrink_to_fit()

与squeeze() 相同。提供 STL 兼容性。

qsizetype QVarLengthArray::size() const

返回数组中元素的个数。

另请参阅 isEmpty() 和resize()。

void QVarLengthArray::squeeze()

释放存储项目所不需要的内存。如果容器的存储空间能满足堆栈分配的要求，它就会释放堆分配并将元素复制回堆栈。

此函数的唯一目的是提供一种微调QVarLengthArray 内存使用情况的方法。一般来说，您很少需要调用该函数。

另请参阅 reserve()、capacity() 和resize()。

T QVarLengthArray::value(qsizetype i) const

返回索引位置i 上的值。

如果索引i 越界，函数将返回默认构造值。如果确定i 在界内，可以使用at() 代替，速度会稍快一些。

另请参阅 at() 和operator[]()。

T QVarLengthArray::value(qsizetype i, const T &defaultValue) const

这是一个重载函数。

如果索引i 越界，函数将返回defaultValue 。

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator+=(const T &value)

将value 添加到数组中，并返回对该向量的引用。

另请参阅 append() 和operator<<()。

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator+=(T &&value)

这是一个重载函数。

另请参阅 append() 和operator<<()。

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator<<(const T &value)

将value 添加到数组中，并返回对该向量的引用。

另请参阅 append() 和operator+=()。

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator<<(T &&value)

这是一个重载函数。

另请参阅 append() 和operator+=()。

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

Move 将other 赋值给该数组，并返回该数组的引用。移动后，other 为空。

此函数在 Qt 6.0 中引入。

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

将other 赋值给此数组，并返回此数组的引用。

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator=(std::initializer_list<T> list)

将list 的值赋值给此数组，并返回此数组的引用。

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

返回位于i 索引位置的项目的引用。

i 必须是数组中有效的索引位置（即 0 <= < () ）。i size

另请参阅 data() 和at()。

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

这是一个重载函数。