class QCborArray#

The QCborArray class is used to hold an array of CBOR elements. More…

Synopsis#

Methods#

静态函数#

注意

这份文档可能包含从C++自动翻译成Python的片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建工单的方式告诉我们。

详细描述#

这个类可以用作在CBOR（一个数组）中持有单个顺序容器。CBOR是紧凑的二进制对象表示，是一种非常紧凑的二进制数据编码形式，它是JSON的超集。它是由IETF受约束RESTful环境（CoRE）工作组创建的，该工作组已将其用于许多新的RFC中。它打算与CoAP协议一起使用。

QCborArray与QVariantList和QJsonArray非常相似，其API几乎与这两个类相同。它还可以转换为这两个类，尽管在某些转换中可能会损失信息。

另请参阅

QCborValue QCborMap QJsonArray QList 解析和显示CBOR数据 序列化转换 存储和加载游戏

__init__(other)#
参数:

other – QCborArray

将other的内容复制到该对象中。

__init__()

创建一个空的QCborArray。

append(value)#
参数:

value – QCborValue

at(i)#
参数:

i – 整数

返回类型：

QCborValue

返回数组中位置为 i 的 QCborValue 元素。

如果数组中小于 i 个元素，此函数将返回一个包含未定义值的 QCborValue。因此，使用此函数无法区分数组大小不足的情况与数组以未定义值开头的情况。

clear()#

清空此数组。

另请参阅

isEmpty()

compare(other)#
参数:

other – QCborArray

返回类型：

整数

比较此数组和 other，顺序比较每个元素，并返回一个整数，表示此数组是否应该在 other 之前（如果结果是负数）或之后（如果结果是正数）排序。如果此函数返回 0，则两个数组相等且包含相同的元素。

有关 CBOR 排序顺序的更多信息，请参阅 compare() 。

另请参阅

compare() compare() operator==()

contains(value)#
参数:

value – QCborValue

返回类型：

布尔值

如果此数组包含一个等于 value 的元素，返回 true。

empty()#
返回类型：

布尔值

是isEmpty()的别称。此函数提供与使用标准库API的通用代码的兼容性。

如果此数组为空（size() == 0），则返回true。

另请参阅

isEmpty() size()

first()#
返回类型：

QCborValue

返回此数组的第一个QCborValue对象。

如果数组为空，此函数将返回一个包含未定义值的QCborValue对象。因此，使用此函数无法区分数组长度不足的情况与数组合尾始终是未定义值的情况。

静态 fromJsonArray(array)#
参数:

array – QJsonArray

返回类型：

QCborArray

将QJsonArray数组中找到的所有JSON项目转换为CBOR，使用QCborValue::fromJson()，然后返回由这些元素组成的CBOR数组。

由于CBOR类型系统是JSON的超集，此转换是无损失的。此外，可以使用toJsonArray()将此函数返回的数组转换回原始的array。

静态 fromStringList(list)#
参数:

list – 字符串列表

返回类型：

QCborArray

返回一个包含在列表中找到的所有字符串的 QCborArray。

静态 fromVariantList(list)#
参数:

list – .QVariant列表

返回类型：

QCborArray

将 list 列表中的所有项转换为CBOR，使用 fromVariant() 转换，并返回由这些元素组成的数组。

从 QVariant 转换并不是完全无损。请参阅fromVariant()中的文档以获取更多信息。

insert(i, value)#
参数:
isEmpty()#
返回类型：

布尔值

如果此 QCborArray 为空（即 size() 为 0），则返回 true。

另请参阅

size() clear()

last()#
返回类型：

QCborValue

返回数组的最后一个 QCborValue。

如果数组为空，此函数将返回一个包含未定义值的QCborValue对象。因此，使用此函数无法区分数组长度不足的情况与数组合尾始终是未定义值的情况。

__ne__(other)#
参数:

other – QCborArray

返回类型：

布尔值

比较此数组与 其他，按照顺序比较每个元素，如果两个数组的元素内容不同，则返回 true，否则返回 false。

有关 Qt 中 CBOR 等式更详细的信息，请参阅，compare()。

另请参阅

compare() operator==() operator==() operator

__add__(v)#
参数:

v – QCborValue

返回类型：

QCborArray

返回一个新的 QCborArray，包含与该数组相同的元素，并将 v 作为最后一个元素附加。

另请参阅

operator+=() operator append()

__iadd__(v)#
参数:

v – QCborValue

返回类型：

QCborArray

将 v 添加到该数组，并返回该数组的引用。

另请参阅

append() insert() operator+() operator

__lt__(other)#
参数:

other – QCborArray

返回类型：

布尔值

比较该数组和 other，按顺序比较每个元素，如果该数组应该在该数组之前排序，则返回 true，否则返回 false。

有关 CBOR 排序顺序的更多信息，请参阅 compare() 。

另请参阅

compare() operator==() operator==() operator!=()

__lshift__(v)#
参数:

v – QCborValue

返回类型：

QCborArray

将 v 添加到该数组，并返回该数组的引用。

另请参阅

append() insert() operator+() operator+=()

__eq__(other)#
参数:

other – QCborArray

返回类型：

布尔值

比较该数组和 other，按顺序比较每个元素，如果两个数组包含相同的元素，则返回 true，否则返回 false。

有关 Qt 中 CBOR 等式更详细的信息，请参阅，compare()。

另请参阅

compare() operator==() operator==() operator!=()

operator(i)#
参数:

i – 整数

返回类型：

QCborValue

返回数组中位置为 i 的 QCborValue 元素。

如果数组中的元素小于 i 个，则该函数返回一个包含未定义值的 QCborValue 对象。因此，使用此函数无法区分数组大小不足的情况和数组在位置 i 处包含未定义值的情况。

pop_back()#

是 removeLast() 的同义词。此函数提供是为了与使用标准库API的通用代码兼容。

删除该数组的最后一个元素。删除前数组不得为空。

pop_front()#

是 removeFirst() 的同义词。此函数提供是为了与使用标准库API的通用代码兼容。

删除该数组的第一元素。删除前数组不得为空。

prepend(value)#
参数:

value – QCborValue

push_back(t)#
参数:

t – QCborValue

与 append() 同义。此函数是为了与使用标准库API的通用代码兼容而提供的。

将元素 t 添加到该数组中。

push_front(t)#
参数:

t – QCborValue

与 prepend() 同义。此函数是为了与使用标准库API的通用代码兼容而提供的。

将元素 t 添加到该数组的前面。

removeAt(i)#
参数:

i – 整数

从数组中移除位置为 i 的元素。在移除之前，数组必须具有比 i 更多的元素。

removeFirst()#

移除数组中的第一个元素，使第二个元素成为第一个。在调用之前，数组不能为空。

removeLast()#

移除数组中的最后一个元素。在调用之前，数组不能为空。

size()#
返回类型：

整数

返回本数组的长度。

另请参阅

isEmpty()

swap(other)#
参数:

other – QCborArray

交换此对象与 other 的内容。

takeAt(i)#
参数:

i – 整数

返回类型：

QCborValue

从数组中移除位置 i 的项并返回它。移除之前，数组必须有多于 i 的元素。

takeFirst()#
返回类型：

QCborValue

从数组中移除第一个元素并返回它，使其第二个元素成为第一个。在此次调用之前，数组不能为空。

takeLast()#
返回类型：

QCborValue

从数组中移除最后一个元素并返回它。在此次调用之前，数组不能为空。

toCborValue()#
返回类型：

QCborValue

显式构造一个表示该数组的 QCborValue 对象。此函数通常不是必需的，因为 QCborValue 有一个用于 QCborArray 的构造函数，因此转换是隐式的。

将 QCborArray 转换为 QCborValue 允许在可以使用 QCborValues 的任何上下文中使用它，包括作为 QCborArrays 的项目以及在 QCborMap 中的键和映射类型。将数组转换为 QCborValue 允许访问 toCbor()。

另请参阅

QCborValue(const QCborArray &)

toJsonArray()#
返回类型：

QJsonArray

递归地将此数组中的每个 QCborValue 元素转换为 JSON，使用 toJsonValue() 并返回由这些元素组成的相应的 QJsonArray。

请注意，CBOR 比 JSON 具有更丰富和更广泛的类型集，因此在转换过程中可能会丢失某些信息。有关应用转换的更多详细信息，请参阅 toJsonValue()。

toVariantList()#
返回类型：

QVariant 列表

递归地将这个数组中的每个 QCborValue 转换为 toVariant() 并返回由转换后的项组成的 QVariantList。

转换到 QVariant 并非完全无损。有关更多信息，请参阅 toVariant() 的文档。