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)

Move-从other 构造一个 QJsonArray。

[noexcept] QJsonArray::~QJsonArray()

删除数组。

void QJsonArray::append(const QJsonValue &value)

在数组末尾插入value 。

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

QJsonValue QJsonArray::at(qsizetype i) const

返回代表索引i 值的QJsonValue 。

如果i 越界，则返回的QJsonValue 为Undefined 。

QJsonArray::iterator QJsonArray::begin()

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

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

QJsonArray::const_iterator QJsonArray::begin() const

这是一个重载函数。

QJsonArray::const_iterator QJsonArray::cbegin() const

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

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

QJsonArray::const_iterator QJsonArray::cend() const

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

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

QJsonArray::const_iterator QJsonArray::constBegin() const

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

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

QJsonArray::const_iterator QJsonArray::constEnd() const

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

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

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

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

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)

用value 替换索引位置i 上的项目。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)

Move-assignsother 到该数组。

[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() 相同。