QCborValue Class

成员函数文档

使用数组a 创建QCborValue 。之后可使用toArray() 检索该数组。

另请参阅 toArray()、isArray() 和isMap()。

使用地图m 创建QCborValue 。随后可使用toMap() 检索该地图。

另请参阅 toMap(),isMap() 和isArray()。

为扩展类型创建QCborValue ，扩展类型由标记值tag 和标记值tv 表示。以后可使用tag() 检索标记，使用taggedValue() 检索标记值。

另请参阅 isTag()、tag()、taggedValue() 和QCborKnownTags 。

如果是数组类型，则返回存储在QCborValue 中的数组值。否则，返回defaultValue 。

请注意，此函数不执行从其他类型到QCborArray 的转换。

另请参阅 isArray()、isByteArray()、isMap()、isContainer() 和toMap()。

如果是映射类型，则返回存储在此QCborValue 中的映射值。否则，返回defaultValue 。

请注意，此函数不执行从其他类型到QCborMap 的转换。

另请参阅 isMap()、isArray()、isContainer() 和toArray()。

这是一个重载函数。

将len 字节的data 转换为QByteArray ，然后调用该函数的重载，重载函数接受QByteArray ，如果提供了error ，也将传递 。

QCborValue::QCborValue()

创建Undefined 类型的 QCborValue。

CBOR 未定义值用于表示信息缺失，通常是由于之前的操作没有按预期完成。QCborArray 和QCborMap API 也使用它们来表示未找到搜索项。

未定义的值由Undefined simple type 表示。因此，对于isSimpleType() 和isSimpleType(QCborSimpleType::Undefined) ，具有未定义值的 QCborValues 也将返回 true。

未定义值不同于空值。

具有未定义值的 QCborValue 对象也不同于无效的 QCborValue 对象。API 不会创建无效的 QCborValue，但它们可能因解析错误而存在。

另请参阅 isUndefined()、isNull() 和isSimpleType()。

QCborValue::QCborValue(QCborSimpleType st)

创建一个简单类型的 QCborValuest 。以后可以使用toSimpleType() 和isSimpleType(st) 来检索该类型。

CBOR 简单类型是没有任何关联值的类型，如 C++ 的std::nullptr_t 类型，其唯一可能的值是nullptr 。

如果st 是QCborSimpleType::Null ，生成的 QCborValue 将是Null 类型，类似的还有QCborSimpleType::Undefined 。如果st 是QCborSimpleType::False 或QCborSimpleType::True ，创建的 QCborValue 将是一个布尔值，分别包含 false 或 true 值。

此函数可用于 API 中未定义的简单类型。例如，要创建一个简单类型为 12 的 QCborValue，可以写入以下内容

    QCborValue value(QCborSimpleType(12));

在简单类型规范发布之前，不应使用这些类型，因为其他实现可能无法正确支持它们。简单类型值 24 至 31 是保留值，不得使用。

isSimpleType(),isNull(),isUndefined(),isTrue(),isFalse()

QCborValue::QCborValue(QCborValue::Type t_)

创建t_ 类型的 QCborValue。与该类型相关的值（如果有）将被默认构造。

另请参阅 type().

QCborValue::QCborValue(QStringView s)

创建字符串值为s 的 QCborValue。稍后可使用toString() 检索该值。

另请参阅 toString(),isString() 和isByteArray()。

QCborValue::QCborValue(bool b)

创建布尔值为b 的 QCborValue。稍后可使用toBool() 检索该值。

在内部，CBOR 布尔值由一对类型表示，一个表示 "true"，一个表示 "false"。因此，布尔 QCborValues 将返回isSimpleType() 的 true 值，以及isSimpleType(QCborSimpleType::False) 或isSimpleType(QCborSimpleType::True) 中的一个。

另请参阅 toBool(),isBool(),isTrue(),isFalse() 和isSimpleType() 。

QCborValue::QCborValue(const QByteArray &ba)

创建具有字节数组值ba 的 QCborValue。随后可使用toByteArray() 检索该值。

另请参阅 toByteArray(),isByteArray() 和isString() 。

[explicit] QCborValue::QCborValue(const QDateTime &dt)

创建一个日期/时间扩展类型的 QCborValue 对象，其中包含dt 所代表的值。以后可以使用toDateTime() 检索该值。

CBOR 日期/时间类型是使用标记的扩展类型：标记为DateTime 的字符串（ISO 日期格式）或标记为UnixTime_t 的数字（自 1970 年开始的秒数，UTC）。在解析 CBOR 数据流时，QCborValue 会将UnixTime_t 转换为基于字符串的类型。

另请参阅 toDateTime(),isDateTime(), 和taggedValue().

[explicit] QCborValue::QCborValue(const QRegularExpression &rx)

创建正则表达式模式扩展类型的 QCborValue 对象，其中包含rx 所代表的值。以后可以使用toRegularExpression() 检索该值。

CBOR 正则表达式类型是一种扩展类型，由标记为RegularExpression 的字符串表示。请注意，CBOR 正则表达式只存储模式，因此QRegularExpression 对象可能携带的任何标记都将丢失。

另请参阅 toRegularExpression()、isRegularExpression() 和taggedValue()。

QCborValue::QCborValue(const QString &s)

创建字符串值为s 的 QCborValue。稍后可使用toString() 检索该值。

另请参阅 toString(),isString() 和isByteArray()。

[explicit] QCborValue::QCborValue(const QUrl &url)

创建一个 URL 扩展类型的 QCborValue 对象，其中包含url 所代表的值。以后可使用toUrl() 检索该值。

CBOR URL 类型是一种扩展类型，由标记为Url 的字符串表示。

另请参阅 toUrl()、isUrl() 和taggedValue()。

[explicit] QCborValue::QCborValue(const QUuid &uuid)

创建一个 UUID 扩展类型的 QCborValue 对象，其中包含uuid 所代表的值。以后可以使用toUuid() 检索该值。

CBOR UUID 类型是一种扩展类型，由标记为Uuid 的字节数组表示。

另请参见 toUuid()、isUuid() 和taggedValue()。

QCborValue::QCborValue(double d)

创建一个带有浮点数值d 的 QCborValue。以后可使用toDouble() 检索该值。

CBOR 浮点数值不同于整数数值。因此，包含整数值的 QCborValue 对象与包含浮点数值的 QCborValue 对象的比较方式不同，即使对象中包含的值相同。

另请参见 toDouble()、isDouble() 和isInteger()。

QCborValue::QCborValue(qint64 i)

创建一个具有整数值i 的 QCborValue。以后可以使用toInteger() 检索该值。

CBOR 整数值不同于浮点数值。因此，包含整数的 QCborValue 对象与包含浮点的 QCborValue 对象的比较方式不同，即使对象中包含的值是等价的。

另请参阅 toInteger()、isInteger() 和isDouble()。

QCborValue::QCborValue(std::nullptr_t)

创建Null 类型的 QCborValue。

CBOR 空值用于表示未提供的可选值。它们与未定义值不同，因为空值通常不是先前的错误或问题造成的。

另请参见 isNull()、isUndefined() 和isSimpleType()。

QCborValue::QCborValue(QLatin1StringView s)

这是一个重载函数。

使用s 查看的 Latin-1 字符串创建 QCborValue。稍后可使用toString() 检索该值。

另请参见 toString()、isString() 和isByteArray()。

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

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

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

这是一个重载函数。

将other QCborValue 对象的内容移入此对象，并释放此对象的资源。

[noexcept] QCborValue::~QCborValue()

处理当前QCborValue 对象并释放所有相关资源。

int QCborValue::compare(const QCborValue &other) const

比较此值和other ，并返回一个整数，表示此值应在other 之前（如果结果为负）还是之后（如果结果为正）排序。如果该函数返回 0，则表示两个值相等且内容相同。

如果每个QCborValue 包含一个数组或映射，则比较会递归到其中包含的元素。

扩展类型

QCborValue 比较值等于包含扩展类型的 ，如 和 及其等价标记表示法。因此，举例来说，以下表达式为真：QCborValue Url Url

    QCborValue(QUrl("https://example.com")) == QCborValue(QCborKnownTags::Url, "https://example.com");

请注意，像QUrl 和QDateTime 这样的 Qt XML 类型会对其参数进行规范化和其他修改。上面的表达式之所以为真，是因为右侧的字符串是左侧QCborValue 的规范化值。例如，如果两边的 "https "部分都是大写，比较就会失败。有关QCborValue 执行的规范化的信息，请查阅相关 Qt 类型的构造函数文档。

排序顺序

RFC 7049 第 3.9 节定义了 CBOR 中的排序顺序，其中讨论了按照 Canonical 编码对映射中的键进行排序的问题。根据该规范，"排序是根据键数据项的字节表示法进行的"，并列举了以下结果：

• "如果两个键的长度不同，较短的键排序较早；"
• "如果两个键的长度相同，按（字节）词法顺序排列值较低的键排序较早。

这导致 QCborValues 的排序出人意料，该函数的结果与随后通过比较所含元素而检索到的结果不同。例如，包含字符串 "zzz "的QCborValue 会排序在包含字符串 "foobar "的QCborValue 之前，尽管以QStrings 或QByteArrays 进行比较时，"zzz "会排序在 "foobar "之后（字典顺序）。

QCborValue 假设类型也应排序，但规范并没有明确指出不同类型的数值应采用什么排序顺序（规范说排序不应 "注意主要类型的 3/5 位分割"）。QCborValue::Type 枚举的数值按此顺序排列，但扩展类型除外，它们按标记的等价类型进行比较。

另请参阅 QCborArray::compare()、QCborMap::compare() 和operator==()。

[static] QCborValue QCborValue::fromCbor(QCborStreamReader &reader)

从reader 中找到的 CBOR 流中解码一个项目，并返回等价表示。该函数是递归的：如果项目是一个映射或数组，它将解码在该映射或数组中找到的所有项目，直到最外层的对象解码完毕。

此函数不必用于QCborStreamReader 的根元素。例如，下面的代码说明了如何跳过文件开头的 CBOR 签名标记：

    if (reader.isTag() && reader.toTag() == QCborKnownTags::Signature)
        reader.next();

    QCborValue contents = QCborValue::fromCbor(reader);

即使解码失败，返回值也可能是部分完整的，与有效的QCborValue 没有区别。要确定是否存在错误，请检查reader.lastError() 是否显示错误条件。第一次出错后，该函数会立即停止解码。

另请参阅 toCbor()、toDiagnosticNotation()、toVariant() 和toJsonValue()。

[static] QCborValue QCborValue::fromCbor(const QByteArray &ba, QCborParserError *error = nullptr)

这是一个重载函数。

从字节数组ba 中找到的 CBOR 流中解码一个项目，并返回等价表示。该函数是递归的：如果项目是一个映射或数组，它将解码在该映射或数组中找到的所有项目，直到最外层的对象解码完毕。

如果有错误，该函数会将错误状态存储在error 指向的对象中，同时存储错误发生位置的偏移量。如果没有发生错误，则会在错误状态中存储NoError 以及所消耗的字节数（即存储第一个未使用字节的偏移量）。利用这些信息，就可以解析同一字节数组中可能存在的其他数据。

即使解码失败，返回值也可能是部分完整的，与有效的QCborValue 没有区别。要确定是否出错，请检查error 中是否存储了错误信息。第一次出错后，该函数会立即停止解码。

另请参阅 toCbor()、toDiagnosticNotation()、toVariant() 和toJsonValue()。

[static] QCborValue QCborValue::fromJsonValue(const QJsonValue &v)

将v 中包含的 JSON 值转换为相应的 CBOR 值并返回。从 JSON 转换为 CBOR 不会丢失数据，因为 CBOR 类型集比 JSON 更丰富。此外，使用该函数转换为 CBOR 的值可以使用toJsonValue() 转换回 JSON，且不会丢失数据。

下表列出了 JSON 类型到 CBOR 类型的映射：

QJsonValue 也可以是未定义的，表示之前的操作未能完成（例如，搜索对象中不存在的键）。未定义值不是 JSON 类型，可能不会出现在 JSON 数组和对象中，但如果相应的 未定义，则该函数会返回 未定义值。QJsonValue QCborValue

另请参见 toJsonValue()、fromVariant()、QCborArray::fromJsonArray() 和QCborMap::fromJsonObject()。

[static] QCborValue QCborValue::fromVariant(const QVariant &variant)

将QVariant variant 转换为QCborValue 并返回。

QVariants 可能包含大量不同的元类型，其中许多在 CBOR 中没有对应的表示。这包括所有用户定义的元类型。在准备使用 CBOR 传输时，建议对每个值进行仔细编码，以防止丢失表示。

下表列出了该函数将应用的转换：

如果QVariant::isNull() 返回 true，则返回一个空QCborValue 或插入到列表或对象中，与QVariant 所携带的类型无关。请注意 Qt XML 6.0 中影响QVariant::isNull() 的行为变化也会影响此函数。

对于上面未列出的其他类型，将尝试转换为字符串，通常但不总是调用QVariant::toString() 。如果转换失败，该值将被未定义的 CBOR 值取代。请注意，对于大多数类型，QVariant::toString() 也是有损的。

请注意，通过QVariant::toString() 进行的转换可能会随时更改。QVariant 和QCborValue 今后可能会扩展以支持更多类型，这将导致该函数执行转换的方式发生变化。

另请参阅 toVariant()、fromJsonValue()、QCborArray::toVariantList()、QCborMap::toVariantMap() 和QJsonValue::fromVariant()。

bool QCborValue::isArray() const

如果QCborValue 属于数组类型，则返回 true。可使用toArray() 获取数组值。

另请参阅 type() 和toArray()。

bool QCborValue::isBool() const

如果QCborValue 是布尔值，则返回 true。可使用toBool() 检索该值。

另请参阅 type()、toBool()、isTrue() 和isFalse()。

bool QCborValue::isByteArray() const

如果QCborValue 是字节数组类型，则返回 true。可以使用toByteArray() 获取字节数组值。

另请参阅 type() 和toByteArray()。

bool QCborValue::isContainer() const

如果QCborValue 是数组或映射，则此方便函数返回 true。

另请参阅 isArray() 和isMap()。

bool QCborValue::isDateTime() const

如果QCborValue 属于日期/时间类型，则返回 true。可以使用toDateTime() 检索该值。日期/时间是使用标签DateTime 的扩展类型。

此外，从 CBOR 数据流解码时，QCborValue 将解释值为UnixTime_t 的标记，并将其转换为等效的日期/时间。

另请参阅 type() 和toDateTime()。

bool QCborValue::isDouble() const

如果QCborValue 是浮点类型，则返回 true。可以使用toDouble() 获取该值。

另请参阅 type() 和toDouble()。

bool QCborValue::isFalse() const

如果QCborValue 是布尔型，且值为 false，则返回 true。之所以存在这个函数，是因为 CBOR 布尔型在内部被存储为两个独立的类型，一个表示真值，一个表示假值。

另请参阅 type()、isBool()、isTrue() 和toBool()。

bool QCborValue::isInteger() const

如果QCborValue 是整数类型，则返回 true。可使用toInteger() 获取整数值。

另请参阅 type() 和toInteger()。

bool QCborValue::isInvalid() const

如果QCborValue 不属于任何有效类型，则返回 true。无效的 QCborValues 与未定义值的 QCborValues 不同，它们通常代表解码错误。

另请参阅 isUndefined() 和isNull()。

bool QCborValue::isMap() const

如果QCborValue 属于映射类型，则返回 true。可使用toMap() 检索映射值。

另请参阅 type() 和toMap()。

bool QCborValue::isNull() const

如果QCborValue 为空类型，则返回 true。

CBOR 空值用于表示未提供的可选值。空值有别于未定义值，因为空值通常不是先前的错误或问题造成的。

空值有别于未定义值和无效的QCborValue 对象。API 不会创建无效的 QCborValues，但它们可能因解析错误而存在。

另请参阅 type()、isUndefined() 和isInvalid()。

bool QCborValue::isRegularExpression() const

如果QCborValue 包含正则表达式的模式，则返回 true。可使用toRegularExpression() 检索该模式。

另请参阅 type() 和toRegularExpression()。

bool QCborValue::isSimpleType() const

如果QCborValue 属于 CBOR 简单类型之一，则返回 true。以后可以使用type() 检索类型本身，即使是在 API 中没有枚举的类型。还可以使用isSimpleType(QCborSimpleType) 重载检查它们。

另请参见 QCborSimpleType 、isSimpleType(QCborSimpleType) 和toSimpleType()。

bool QCborValue::isSimpleType(QCborSimpleType st) const

这是一个重载函数。

如果QCborValue 属于简单类型，且toSimpleType() 返回st ，则返回 true；否则返回 false。该函数可用于检查任何 CBOR 简单类型，甚至是 API 中没有枚举的类型。例如，对于值为 12 的简单类型，可以写入

    value.isSimpleType(QCborSimpleType(12));

另请参见 QCborValue::QCborValue(QCborSimpleType),isSimpleType(),isFalse(),isTrue(),isNull,isUndefined(), 和toSimpleType().

bool QCborValue::isString() const

如果QCborValue 是字符串类型，则返回 true。可使用toString() 获取字符串值。

另请参阅 type() 和toString()。

bool QCborValue::isTag() const

如果QCborValue 属于标记类型，则返回 true。标签值可使用tag() 检索，标记值可使用taggedValue() 检索。

对于 API 可识别的扩展类型，该函数也返回 true。对于在 Qt XML API 更新以支持扩展类型之前直接处理扩展类型的代码，可以使用taggedValue() 重新创建标记 + 标记值对。

另请参见 type()、tag()、taggedValue() 和taggedValue()。

bool QCborValue::isTrue() const

如果QCborValue 是一个具有 true 值的布尔值，则返回 true。之所以存在这个函数，是因为 CBOR 布尔型在内部被存储为两个独立的类型，一个表示 false，一个表示 true。

另请参阅 type()、isBool()、isFalse() 和toBool()。

bool QCborValue::isUndefined() const

如果QCborValue 属于未定义类型，则返回 true。

CBOR 未定义值用于表示信息缺失，通常是由于之前的操作未按预期完成。QCborArray 和QCborMap API 也使用它们来表示未找到搜索项。

未定义值不同于空值。

QCborValue 未定义值的对象也不同于无效的 对象。API 不会创建无效的 QCborValues，但它们可能因解析错误而存在。QCborValue

另请参阅 type()、isNull() 和isInvalid()。

bool QCborValue::isUrl() const

如果QCborValue 属于 URL 类型，则返回 true。可以使用toUrl() 获取 URL 值。

另请参阅 type() 和toUrl()。

bool QCborValue::isUuid() const

如果QCborValue 包含 UUID，则返回 true。可以使用toUuid() 获取该值。

另请参阅 type() 和toUuid()。

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

将此值与other 互换。该操作速度非常快，从未出现过故障。

QCborTag QCborValue::tag(QCborTag defaultValue = QCborTag(-1)) const

如果该扩展QCborValue 对象属于标记类型，则返回该对象的标记，否则返回defaultValue 。

CBOR 通过将一个数字（标记）与存储的表示关联起来来表示扩展类型。该函数返回该数字。要检索表示法，请使用taggedValue() 。

另请参见 isTag()、taggedValue()、isDateTime()、isUrl()、isRegularExpression() 和isUuid()。

QCborValue QCborValue::taggedValue(const QCborValue &defaultValue = QCborValue()) const

如果该扩展QCborValue 对象属于标记类型，则返回该对象的标记值，否则返回defaultValue 。

CBOR 通过将一个数字（标记）与一个存储表示相关联来表示扩展类型。本函数将返回该表示。要检索标签，请使用tag() 。

另请参见 isTag()、tag()、isDateTime()、isUrl()、isRegularExpression() 和isUuid()。

bool QCborValue::toBool(bool defaultValue = false) const

如果是布尔类型，则返回存储在QCborValue 中的布尔值。否则，返回defaultValue 。

另请参阅 isBool()、isTrue() 和isFalse()。

QByteArray QCborValue::toByteArray(const QByteArray &defaultValue = {}) const

如果是字节数组类型，则返回存储在QCborValue 中的字节数组值。否则，返回defaultValue 。

请注意，此函数不执行从其他类型到QByteArray 的转换。

另请参阅 isByteArray()、isString() 和toString()。

QByteArray QCborValue::toCbor(QCborValue::EncodingOptions opt = NoTransformation) const

使用opt 中指定的选项，将QCborValue 对象编码为 CBOR 表示形式，并返回包含该表示形式的字节数组。

该函数不会失败，除非该QCborValue 或其中包含的任何项（如果是映射或数组）无效。无效类型通常不会由 API 生成，但可能是解码错误造成的。

默认情况下，该函数不对QCborValue 中的值执行转换，直接将所有浮点写成双精度 (double) 类型。如果指定了UseFloat 选项，它将使用单精度 (float) 来表示任何浮点数值，因为使用这种表示方法不会损失精度。这包括无穷大和 NaN 值。

同样，如果指定了UseFloat16 ，如果转换为半精度 (qfloat16) 浮点数不会造成精度损失，该函数将尝试使用半精度浮点数。对于无穷小和 NaN 值，这始终是正确的。

如果指定UseIntegers ，该函数将对任何包含实际整数的浮点数值使用整数。

另请参见 fromCbor()、fromVariant() 和fromJsonValue()。

void QCborValue::toCbor(QCborStreamWriter &writer, QCborValue::EncodingOptions opt = NoTransformation) const

这是一个重载函数。

使用opt 中指定的选项，将QCborValue 对象编码为其 CBOR 表示形式，并发送给writer 指定的写入器。例如，多个 QCborValues 可以使用同一个写入器，以便对较大数组中的不同元素进行编码。

该函数不会失败，除非该QCborValue 或所包含的任何项目（如果是映射或数组）无效。无效类型通常不会由 API 生成，但可能是解码错误造成的。

默认情况下，该函数不会对QCborValue 中的值进行转换，而是直接将所有浮点写入双精度（二进制 64）类型。如果指定了UseFloat 选项，该函数将使用单精度（二进制 32）表示任何浮点数值，使用该表示法不会损失精度。这包括无穷大和 NaN 值。

同样，如果指定了UseFloat16 ，如果转换为半精度（二进制 16）浮点数不会造成精度损失，那么该函数将尝试使用半精度（二进制 16）浮点数。对于无穷小和 NaN 值，这始终是正确的。

如果指定UseIntegers ，则将对包含实际整数的浮点数值使用整数。

另请参见 fromCbor()、fromVariant() 和fromJsonValue()。

QDateTime QCborValue::toDateTime(const QDateTime &defaultValue = {}) const

如果是日期/时间扩展类型，则返回存储在此QCborValue 中的日期/时间值。否则，返回defaultValue 。

请注意，此函数不执行从其他类型到QDateTime 的转换。

另请参阅 isDateTime()、isTag() 和taggedValue()。

QString QCborValue::toDiagnosticNotation(QCborValue::DiagnosticNotationOptions opts = Compact) const

创建该 CBOR 对象的等效诊断符号并返回。opts 参数控制符号的方言。诊断符号在调试中非常有用，可以帮助开发人员了解QCborValue 或 CBOR 流中存储的值。因此，Qt API 不支持将诊断符号解析回内存格式或 CBOR 数据流，尽管这种表示方法是独特的，而且是可能的。

CBOR 诊断符号由 RFC 7049第 6 节规定。它是 CBOR 流的文本表示法，与 JSON 非常相似，但它支持 JSON 中没有的 CBOR 类型。ExtendedFormat 标志启用的扩展格式目前还在一些 IETF 草案中，其格式可能会发生变化。

该函数生成与toCbor() 生成的流等价的表示形式，但不提供任何转换选项。这也意味着，如果对象是使用fromCbor() 创建的，该函数可能不会生成用于创建该对象的流的表示形式，因为该函数可能已经应用了转换。有关不带变换的流的高保真表示法，请参阅cbordump 示例。

另请参阅 toCbor() 和QJsonDocument::toJson()。

double QCborValue::toDouble(double defaultValue = 0) const

如果是 Double 类型，则返回存储在QCborValue 中的浮点数值。如果是整数类型，则返回转换为 double 的整数值。在其他情况下，返回defaultValue 。

另请参见 isDouble()、isInteger() 和toInteger()。

qint64 QCborValue::toInteger(qint64 defaultValue = 0) const

如果是整数类型，则返回存储在QCborValue 中的整数值。如果是 Double 类型，该函数将返回转换为整数的浮点数值。在其他情况下，返回defaultValue 。

另请参见 isInteger()、isDouble() 和toDouble()。

QJsonValue QCborValue::toJsonValue() const

将QCborValue 对象转换为等价的 JSON 表示形式，并以QJsonValue 的形式返回。

请注意，CBOR 包含的类型集比 JSON 更丰富、更广泛，因此在转换过程中可能会丢失一些信息。下表比较了 CBOR 类型和 JSON 类型，并指出是否会丢失信息。

有关将 CBOR 映射键转换为字符串的信息，请参见QCborMap::toJsonObject()。

如果QCborValue 包含未定义的值，该函数也将返回未定义的QJsonValue 。请注意，JSON 不支持未定义的值，而未定义的 QJsonValues 是对规范的扩展。它们不能保存在QJsonArray 或QJsonObject 中，但可以从函数中返回以表示失败。就所有其他意图和目的而言，它们与 null 相同。

标记和扩展类型的特殊处理

某些标记会进行特殊处理，并将标记值从 CBOR 转换为 JSON。下表列出了这些特殊情况：

另请参阅 fromJsonValue()、toVariant()、QCborArray::toJsonArray() 和QCborMap::toJsonObject()。

QRegularExpression QCborValue::toRegularExpression(const QRegularExpression &defaultValue = {}) const

如果是正则表达式模式扩展类型，则返回存储在QCborValue 中的正则表达式值。否则，返回defaultValue 。

请注意，此函数不执行从其他类型到QRegularExpression 的转换。

另请参阅 isRegularExpression()、isTag() 和taggedValue()。

QCborSimpleType QCborValue::toSimpleType(QCborSimpleType defaultValue = QCborSimpleType::Undefined) const

如果QCborValue 是简单类型，则返回它的简单类型。如果不是简单类型，则返回defaultValue 。

以下类型属于简单类型，该函数将返回列出的值：

另请参见 type()、isSimpleType()、isBool()、isTrue()、isFalse()、isTrue()、isNull() 和isUndefined()。

QString QCborValue::toString(const QString &defaultValue = {}) const

如果是字符串类型，则返回存储在QCborValue 中的字符串值。否则，返回defaultValue 。

请注意，此函数不执行从其他类型到QString 的转换。

另请参阅 isString()、isByteArray() 和toByteArray()。

QUrl QCborValue::toUrl(const QUrl &defaultValue = {}) const

如果是 URL 扩展类型，则返回存储在QCborValue 中的 URL 值。否则，返回defaultValue 。

请注意，此函数不执行从其他类型到QUrl 的转换。

另请参阅 isUrl()、isTag() 和taggedValue()。

QUuid QCborValue::toUuid(const QUuid &defaultValue = {}) const

如果是 UUID 扩展类型，则返回存储在QCborValue 中的 UUID 值。否则，返回defaultValue 。

请注意，该函数不执行从其他类型到QUuid 的转换。

另请参阅 isUuid()、isTag() 和taggedValue()。

QVariant QCborValue::toVariant() const

将此值转换为本地 Qt 类型并返回相应的QVariant 。

下表列出了QCborValue types 和Qt meta types 之间的映射。

请注意，CBOR 地图和数组中的值也会使用此函数进行递归转换，并将其放入QVariantMap 和QVariantList 。您不会在 QVariants 中找到QCborMap 和QCborArray 。

与 CBOR 不同，QVariantMaps 的键值是字符串，因此将QCborMap 转换为QVariantMap 意味着要对键值进行 "字符串化 "处理。详见QCborMap::toJsonObject() 。

另请参见 fromVariant()、toJsonValue()、QCborArray::toVariantList() 和QCborMap::toVariantMap()。

QCborValue::Type QCborValue::type() const

返回QCborValue 的类型。以后也可通过 "isXxx "函数之一检索该类型。

另请参阅 isInteger(),isByteArray(),isString(),isArray(),isMap(),isTag(),isFalse(),isTrue(),isBool(),isNull(),isUndefined,isDouble(),isDateTime(),isUrl(),isRegularExpression(), 和isUuid().

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

用other 的副本替换该 QCborObject 的内容。

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

这是一个重载函数。

将other QCborValue 对象的内容移入此对象，并释放此对象的资源。返回此对象的引用。

QCborValueRef QCborValue::operator[](const QString &key)

返回一个 QCborValueRef，可用于读取或修改 this 中的条目，作为一个映射，并带有给定的key 。当QCborValue 是一个QCborMap 时，该函数等同于该映射上的匹配运算符[]。

map[i] 在返回引用之前：如果QCborValue 是一个数组，则首先将其转换为映射（这样，对于每个索引，array[i] ，i ，有效的array[i] ）；否则，如果它不是一个映射，则将用一个空映射覆盖。

另请参阅 operator[](qint64)、QCborMap::operator[],QCborMap::value() 和QCborMap::find() 。

const QCborValue QCborValue::operator[](const QString &key) const

如果此QCborValue 是QCborMap ，则搜索元素，查找键与key 匹配的值。如果在 map 中没有与key 匹配的 key，或者此QCborValue 对象不是 map，则返回未定义的值。

此函数等同于

    value.toMap().value(key);

另请参见 operator[](qint64)、QCborMap::operator[],QCborMap::value() 和QCborMap::find()。

QCborValueRef QCborValue::operator[](QLatin1StringView key)

这是一个重载函数。

返回一个 QCborValueRef，可用于读取或修改 this 中的条目，作为一个映射，并使用给定的key 。当QCborValue 是一个QCborMap 时，该函数等同于该映射上的匹配操作符[]。

map[i] 在返回引用之前：如果QCborValue 是一个数组，则首先将其转换为映射（这样，对于每个索引，array[i] ，i ，有效的array[i] ）；否则，如果它不是一个映射，则将用一个空映射覆盖。

另请参阅 operator[](qint64)、QCborMap::operator[],QCborMap::value() 和QCborMap::find() 。

QCborValueRef QCborValue::operator[](qint64 key)

这是一个重载函数。

返回一个 QCborValueRef，可用于读取或修改 this 中的条目（作为一个映射或数组），并使用给定的key 。当QCborValue 是一个QCborMap ，或者当 0 <= key < 0x10000 时，是一个QCborArray 时，该函数等同于该映射或数组上的匹配运算符[]。

在返回引用之前：如果QCborValue 是一个数组，但 key 不在范围内，则首先将数组转换为映射（这样，map[i] 就是array[i] ，每个索引，i ，都有有效的array[i] ）；否则，如果不是映射，则将用一个空映射重写。

另请参见 operator[],QCborMap::operator[],QCborMap::value(),QCborMap::find(),QCborArray::operator[], 和QCborArray::at() 。

const QCborValue QCborValue::operator[](QLatin1StringView key) const

这是一个重载函数。

如果QCborValue 是一个QCborMap ，则搜索键值与key 匹配的元素。如果 map 中没有与key 匹配的 key，或者此QCborValue 对象不是 map，则返回未定义的值。

此函数等同于

    value.toMap().value(key);

另请参见 operator[](qint64)、QCborMap::operator[],QCborMap::value() 和QCborMap::find()。

const QCborValue QCborValue::operator[](qint64 key) const

这是一个重载函数。

如果QCborValue 是QCborMap ，则搜索键值与key 匹配的元素。如果 this 是QCborArray ，则返回索引为key 的元素。如果数组或映射中没有匹配值，或QCborValue 对象不是数组或映射，则返回未定义的值。

另请参阅 operator[],QCborMap::operator[],QCborMap::value(),QCborMap::find(),QCborArray::operator[] 和QCborArray::at() 。