QCborValue Class

成员函数文档

QCborValue::QCborValue()

创建一个类型为Undefined 的QCborValue。

CBOR中的未定义值用于指示信息缺失，通常是由于先前操作未按预期完成所致。QCborArray 和QCborMap API 也会使用这些值来表示未找到所搜索的项目。

未定义值由Undefined simple type 表示。因此，包含未定义值的QCborValue在调用isSimpleType()和isSimpleType(QCborSimpleType::Undefined) 时也会返回true。

未定义值与 null 值不同。

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

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

使用数组a 创建一个QCborValue 。该数组稍后可通过toArray() 获取。

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

创建一个包含映射m 的QCborValue 。该映射稍后可通过toMap() 进行检索。

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

QCborValue::QCborValue(QCborSimpleType st)

创建一个简单类型为st 的QCborValue。该类型随后可通过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。因此，布尔型 QCborValue 在调用isSimpleType() 时将返回 true，而在调用isSimpleType(QCborSimpleType::False) 或isSimpleType(QCborSimpleType::True) 时将返回其中之一。

另请参阅 toBool()、isBool()、isTrue()、isFalse() 以及isSimpleType()。

QCborValue::QCborValue(const QByteArray &ba)

创建一个 QCborValue 对象，其值为字节数组ba 。该值随后可通过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)

创建一个QCborValue对象，该对象属于UUID扩展类型，并包含由uuid 表示的值。该值随后可通过toUuid()获取。

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

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

[delete] QCborValue::QCborValue(const void *)

默认构造一个QCborValue 的实例。该函数已被删除。

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()。

为由标签值tag 和标记值tv 所表示的扩展类型创建一个QCborValue 。之后可通过tag() 检索该标签，并通过taggedValue() 检索被标记的值。

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

QCborValue::QCborValue(QLatin1StringView s)

创建一个 QCborValue 对象，其中包含由s 解析的 Latin-1 字符串。该值随后可通过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 类型会对参数进行规范化或其他修改。上述表达式之所以为真，仅仅是因为右侧的字符串是左侧QCborValue 所采用的规范化值。例如，如果双方的“https”部分均为大写，则比较将失败。 有关QCborValue 执行的标准化处理，请查阅相关 Qt 类型的构造函数文档。

排序顺序

CBOR 中的排序顺序在RFC 7049 第 3.9 节中定义，该节讨论了遵循规范编码时映射中键的排序。根据规范，“排序是基于键数据项表示形式的字节进行的”，并列出了以下结果：

• “如果两个键的长度不同，较短的键排序优先；”
• “如果两个键的长度相同，则（按字节顺序）字面顺序值较小的那个排序在前。”

这导致 QCborValues 的排序结果出人意料，该函数的返回结果与后续通过比较所含元素所获得的结果不同。 例如，包含字符串“zzz”的QCborValue 在排序时会排在包含字符串“foobar”的QCborValue 之前，尽管当按QStrings 或QByteArrays 进行比较时，“zzz”在字典顺序中排在“foobar”之后。

规范并未明确说明对不同类型的值应采用何种排序顺序（规范中提到排序不应“关注主要类型的 3/5 位划分”）。QCborValue 假设类型也应被排序。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()。

将len 字节的data 转换为QByteArray ，然后调用该函数的那个接受QByteArray 作为参数的重载版本，同时若提供了error ，也会将其一并传递。

[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 并返回该值。

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

下表列出了该函数将执行的转换：

如果 `QVariant::isNull()` 返回 `true`，则无论 `QVariant` 携带的类型为何，都会返回一个 `null` 的 `QCborValue `，或将其插入到列表或对象中。请注意，Qt 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布尔值被存储为两种独立的类型，一种表示true，另一种表示false。

另请参阅 type()、isBool()、isTrue()，以及toBool()。

bool QCborValue::isInteger() const

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

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

bool QCborValue::isInvalid() const

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

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

bool QCborValue::isMap() const

如果该QCborValue 属于map类型，则返回true。可使用toMap()获取map的值。

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

bool QCborValue::isNull() const

如果该QCborValue 为null类型，则返回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 API 更新以支持扩展类型之前直接处理扩展类型的代码，可以使用taggedValue() 重新创建标签与标记值对。

另请参阅 type()、tag() 和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 包含未定义值的对象也不同于无效的QCborValue 对象。API 不会创建无效的 QCborValues，但它们可能因解析错误而存在。

另请参阅 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 对象的标签；如果该对象属于tag类型，则返回其标签；否则返回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()。

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

请注意，此函数不会将其他类型转换为QCborArray 。

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

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

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

除非该QCborValue 对象（若为映射或数组）及其包含的任何项均无效，否则此函数不会失败。API 通常不会产生无效类型，但解码错误可能会导致此类情况。

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

同样地，如果指定了UseFloat16 ，当转换为半精度（qfloat16 ）不会导致精度损失时，该函数将尝试使用半精度浮点数。对于无穷大和NaN，这种情况总是成立的。

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

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

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

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

除非该QCborValue （若其为映射或数组）本身或其中任何项无效，否则此函数不会失败。API 通常不会产生无效类型，但解码错误可能会导致此类情况。

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

同样地，如果指定了UseFloat16 ，当转换为半精度（binary16）浮点数不会导致精度损失时，该函数将尝试使用半精度（binary16）浮点数。对于无穷大值和 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

如果该QCborValue 中存储的是Double类型的浮点数，则返回该值；如果是Integer类型的整数，则返回转换为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 ` 包含 `undefined` 值，则该函数也将返回一个 `undefined` 的 `QJsonValue `。 请注意，JSON 不支持 undefined 值，而 undefined 的 QJsonValues 是对规范的一种扩展。它们不能保存在QJsonArray 或QJsonObject 中，但可以由函数返回以表示失败。在所有其他情况下，它们与 null 相同。

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

某些标签会受到特殊处理，并改变被标记值从 CBOR 到 JSON 的转换方式。下表列出了这些特殊情况：

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

如果该QCborValue 存储的是映射类型，则返回该映射的值；否则，返回defaultValue 。

请注意，此函数不会将其他类型转换为QCborMap 。

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

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()、isNull()，以及isUndefined()。

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

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

请注意，此函数不会将其他类型转换为QString 。

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

[since 6.10] QAnyStringView QCborValue::toStringView(QAnyStringView defaultValue = {}) const

返回存储在此QCborValue 中的字符串值，前提是该值为字符串类型。否则，返回defaultValue 。由于QCborValue 将字符串存储为US-ASCII、UTF-8或UTF-16格式，因此返回的QAnyStringView 可能采用上述任意一种编码。

此函数不会分配内存。返回值的有效期持续到对该对象的下一次非const成员函数调用为止。如果该对象超出作用域，则返回值的有效期持续到对父CBOR对象（映射或数组）的下一次非const成员函数调用为止。

请注意，此函数不会将其他类型转换为 `QString`。

该函数在 Qt 6.10 中引入。

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

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

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

请注意，此函数不会将其他类型转换为 `QUrl`。

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

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

如果该QCborValue 属于UUID扩展类型，则返回其中存储的UUID值；否则，返回defaultValue 。

请注意，此函数不会将其他类型转换为QUuid 。

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

QVariant QCborValue::toVariant() const

将该值转换为原生 Qt 类型，并返回相应的QVariant 。

下表列出了QCborValue types 与Qt meta types 之间的映射关系。

请注意，CBOR映射和数组中的值也会使用此函数进行递归转换，并分别存放在QVariantMap 和QVariantList 中。您不会在QVariant中找到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)

将此 QCborObject 的内容替换为other 的副本。

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

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

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

返回一个 QCborValueRef，可用于读取或修改该映射（作为映射）中与给定key 对应的条目。当该QCborValue 为QCborMap 时，此函数等同于该映射上的对应 [] 运算符。

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

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

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

如果此QCborValue 是QCborMap ，则会在元素中搜索键值与key 匹配的项。如果映射中不存在与key 匹配的键，或者此QCborValue 对象不是映射，则返回 undefined 值。

该函数等同于：

value.toMap().value(key);

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

QCborValueRef QCborValue::operator[](QLatin1StringView key)

返回一个 QCborValueRef，可用于通过给定的key 读取或修改此映射中的条目。当此QCborValue 为QCborMap 时，该函数等同于该映射上的 [] 运算符。

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

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

QCborValueRef QCborValue::operator[](qint64 key)

返回一个 QCborValueRef，可用于读取或修改该映射或数组中与给定key 对应的条目。当该QCborValue 为QCborMap ，或者当 0 <= key < 0x10000 时为QCborArray ，则该函数等同于对该映射或数组执行相应的 [] 运算符。

在返回引用之前：如果该QCborValue 原本是一个数组，但键超出了范围，则首先将数组转换为映射（使得对于每个索引，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 匹配的项。如果地图中没有与key 匹配的键，或者此QCborValue 对象不是地图，则返回 undefined 值。

该函数等同于：

value.toMap().value(key);

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

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

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

另请参阅 operator[] 、QCborMap::operator[] 、QCborMap::value()、QCborMap::find()、QCborArray::operator[] 以及QCborArray::at()。