QJsonArray Class

成员函数文档

QJsonArray::QJsonArray()

创建一个空数组。

QJsonArray::QJsonArray(std::initializer_list<QJsonValue> args)

创建一个由args 初始化列表初始化的数组。

QJsonArray 的构造方式与 JSON 语法类似，例如：

QJsonArray array = { 1, 2.2, QString() };

[noexcept] QJsonArray::QJsonArray(const QJsonArray &other)

创建other 的副本。

由于 QJsonArray 是隐式共享的，因此只要对象未被修改，该副本就是浅拷贝。

[noexcept] QJsonArray::QJsonArray(QJsonArray &&other)

从other 构建一个QJsonArray。

[noexcept] QJsonArray::~QJsonArray()

删除该数组。

void QJsonArray::append(const QJsonValue &value)

将value 插入数组末尾。

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

QJsonValue QJsonArray::at(qsizetype i) const

返回一个QJsonValue ，表示索引i 对应的值。

如果i 超出范围，则返回的QJsonValue 为Undefined 。

QJsonArray::iterator QJsonArray::begin()

返回一个指向数组中第一个元素的STL 风格迭代器。

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

QJsonArray::const_iterator QJsonArray::begin() const

QJsonArray::const_iterator QJsonArray::cbegin() const

返回一个指向数组中第一个元素的常量STL 风格迭代器。

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

QJsonArray::const_iterator QJsonArray::cend() const

返回一个指向数组中最后一个元素之后那个虚构元素的、STL 风格的const迭代器。

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

QJsonArray::const_iterator QJsonArray::constBegin() const

返回一个指向数组中第一个元素的常量STL 风格迭代器。

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

QJsonArray::const_iterator QJsonArray::constEnd() const

返回一个指向数组中最后一个元素之后那个“虚构”元素的、STL 风格的const迭代器。

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

bool QJsonArray::contains(const QJsonValue &value) const

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

另请参阅 count()。

qsizetype QJsonArray::count() const

与size() 相同。

另请参阅 size()。

bool QJsonArray::empty() const

提供此函数是为了兼容 STL。它等同于 `isEmpty()`，若数组为空，则返回 `true `。

QJsonArray::iterator QJsonArray::end()

返回一个STL 风格的迭代器，该迭代器指向数组中最后一个元素之后的一个虚构元素。

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

QJsonArray::const_iterator QJsonArray::end() const

QJsonArray::iterator QJsonArray::erase(QJsonArray::iterator it)

删除由 `it` 指向的项目，并返回一个指向下一个项目的迭代器。

另请参阅 removeAt()。

QJsonValue QJsonArray::first() const

返回数组中存储的第一个值。

与at(0) 相同。

另请参阅 at()。

[static] QJsonArray QJsonArray::fromStringList(const QStringList &list)

将字符串列表list 转换为QJsonArray 。

list 中的值将被转换为 JSON 值。

另请参阅 toVariantList() 和QJsonValue::fromVariant()。

[static] QJsonArray QJsonArray::fromVariantList(const QVariantList &list)

将变体列表list 转换为QJsonArray 。

list 中的QVariant 值将被转换为JSON值。

另请参阅 toVariantList() 和QJsonValue::fromVariant()。

QJsonArray::iterator QJsonArray::insert(QJsonArray::iterator before, const QJsonValue &value)

在before 所指向的位置之前插入value ，并返回一个指向新插入项的迭代器。

另请参阅 erase() 和insert(qsizetype, const QJsonValue &)。

void QJsonArray::insert(qsizetype i, const QJsonValue &value)

将value 插入数组的索引位置i 。如果i 为0 ，则将该值插入数组开头；如果i 为size()，则将该值插入数组末尾。

另请参阅 append()、prepend()、replace() 以及removeAt()。

bool QJsonArray::isEmpty() const

如果对象为空，则返回true 。这与size() == 0的效果相同。

另请参阅 size()。

QJsonValue QJsonArray::last() const

返回数组中存储的最后一个值。

与 `at(size() - 1)` 相同。

另请参阅 at()。

void QJsonArray::pop_back()

提供此函数是为了兼容 STL。它等同于 `removeLast()`。数组不能为空。如果数组可以为空，请在调用此函数之前先调用 `isEmpty()`。

void QJsonArray::pop_front()

提供此函数是为了兼容 STL。它等同于 `removeFirst()`。数组不能为空。如果数组可以为空，请在调用此函数之前先调用 `isEmpty()`。

void QJsonArray::prepend(const QJsonValue &value)

将value 插入数组开头。

这与insert(0, value) 效果相同，会将value 追加到数组开头。

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

void QJsonArray::push_back(const QJsonValue &value)

提供此函数是为了兼容 STL。它等同于 `append(value)`，并将 `value ` 追加到数组中。

void QJsonArray::push_front(const QJsonValue &value)

提供此函数是为了兼容 STL。它等同于 `prepend(value)`，并将 `value ` 追加到数组开头。

void QJsonArray::removeAt(qsizetype i)

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

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

void QJsonArray::removeFirst()

删除数组中的第一个元素。调用此函数等同于调用removeAt(0) 。数组不能为空。如果数组可以为空，请在调用此函数之前先调用isEmpty()。

另请参阅 removeAt() 和removeLast()。

void QJsonArray::removeLast()

移除数组中的最后一个元素。调用此函数等同于调用removeAt(size() - 1) 。数组不能为空。如果数组可以为空，请在调用此函数之前先调用isEmpty()。

另请参见 removeAt() 和removeFirst()。

void QJsonArray::replace(qsizetype i, const QJsonValue &value)

将索引位置为i 的元素替换为value 。i 必须是数组中的有效索引位置（即，0 <= i < size() ）。

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

qsizetype QJsonArray::size() const

返回数组中存储的值的个数。

[noexcept] void QJsonArray::swap(QJsonArray &other)

将该数组与other 互换。该操作速度极快，且绝不会失败。

QJsonValue QJsonArray::takeAt(qsizetype i)

移除索引位置为i 的项并返回该项。i 必须是数组中的有效索引位置（即0 <= i < size() ）。

如果不使用返回值，removeAt() 的效率更高。

另请参阅 removeAt()。

QVariantList QJsonArray::toVariantList() const

将该对象转换为QVariantList 。

返回生成的映射。

QJsonArray QJsonArray::operator+(const QJsonValue &value) const

返回一个数组，其中包含该数组中的所有元素，后面跟上指定的value 。

另请参阅 ` operator+=()`。

QJsonArray &QJsonArray::operator+=(const QJsonValue &value)

将value 追加到数组中，并返回该数组本身的引用。

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

QJsonArray &QJsonArray::operator<<(const QJsonValue &value)

将value 追加到数组中，并返回该数组本身的引用。

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

[noexcept] QJsonArray &QJsonArray::operator=(QJsonArray &&other)

该操作将other 移入并赋值给此数组。

[noexcept] QJsonArray &QJsonArray::operator=(const QJsonArray &other)

将other 赋值给该数组。

QJsonValueRef QJsonArray::operator[](qsizetype i)

返回索引位置i 处的值，并将其作为可修改的引用返回。i 必须是数组中的有效索引位置（即0 <= i < size() ）。

返回值的类型为QJsonValueRef ，这是QJsonArray 和QJsonObject 的辅助类。当您获得一个类型为QJsonValueRef 的对象时，可以将其视为对QJsonValue 的引用。如果您对其进行赋值，该赋值将作用于您从中获取该引用的QJsonObject 中QJsonArray 位置处的字符。

另请参阅 at()。

QJsonValue QJsonArray::operator[](qsizetype i) const

与at()相同。