QCborValue类

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

如果st是QCborSimpleType::Null，则相应的QCborValue将是空值类型，类似地，如果st是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(const QByteArray &ba)

使用字节数组值ba创建一个QCborValue。可以使用toByteArray()方法稍后检索该值。

参见toByteArray()，isByteArray()和isString()。

QCborValue(const QString &s)

使用字符串值s创建一个QCborValue。可以稍后使用toString()方法检索该值。

参见toString()，isString()和isByteArray()。

QCborValue(QStringView s)

使用字符串值s创建一个QCborValue。可以稍后使用toString()方法检索该值。

参见toString()，isString()和isByteArray()。

QCborValue(QLatin1StringView s)

这是一个重载函数。

使用由s检索的拉丁-1字符串创建一个QCborValue。可以稍后使用toString()方法检索该值。

参见toString()，isString()和isByteArray()。

[显式]QCborValue(const QDateTime &dt)

创建一个包含由dt表示的日期/时间扩展值的QCborValue对象。可以使用toDateTime()方法稍后检索该值。

CBOR日期/时间类型是使用标记作为扩展类型的：要么是一个标记为DateTime的字符串（以ISO日期格式），要么是一个标记为UnixTime_t的数字（自1970年1月1日起的秒数，UTC）。在解析CBOR流时，QCborValue会将UnixTime_t转换为基于字符串的类型。

参见toDateTime()，isDateTime()和taggedValue()。

[显式]QCborValue(const QUrl &url)

创建一个包含由url表示的URL扩展值的QCborValue对象。可以稍后使用toUrl()方法检索该值。

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

另请参阅toUrl()，isUrl()，以及taggedValue。

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

创建一个 QCborValue 对象，其类型为正则表达式扩展类型，包含由 rx 表示的值。可以使用 toRegularExpression() 在以后检索该值。

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

另请参阅toRegularExpression()，isRegularExpression()，以及taggedValue。

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

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

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

另请参阅toUuid()，isUuid()，以及taggedValue。

[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 与包含扩展类型（如 Url 和 Url及其相应的标记表示形式）的 QCborValue 相等。例如，以下表达式为真

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

请注意，像QUrl和QDateTime这样的Qt类型会对它们的参数进行标准化和其他修改。上述表达式之所以成立，仅仅是因为右侧的字符串是左侧的QCborValue所采用的标准化的值。例如，如果两边的“https”部分都是大写，比较将失败。有关QCborValue执行的标准化信息，请参阅采用相应Qt类型的构造函数的文档。

排序顺序

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

• "如果两个键的长度不同，则较短的键先排序；"
• "如果两个键的长度相同，则按字节顺序值较低的键先排序。"

这导致了令人意想不到的QCborValue排序，此函数的结果与稍后通过比较包含的元素检索到的结果不同。例如，包含字符串“zzz”的QCborValue排在包含字符串“foobar”的QCborValue之前，尽管当作为QStrings或QByteArrays比较时，“zzz”排在“foobar”之后（字典顺序）。

规范没有清楚地指出应如何对不同类型的值进行排序（它说排序不应该注意主类型的3/5位分割）。QCborValue假定类型也应该排序。类型枚举的QCborValue::Type的数值按此顺序排列，上述扩展类型除外，它们按它们的带标签等效项比较。

另请参阅QCborArray::compare()，QCborMap::compare()和运算符==()。

[静态] QCborValue QCborValue::fromCbor(QCborStreamReader &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()。

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

这是一个重载函数。

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

如果发生错误，此函数将错误状态存储在由 error 指向的对象中，包括错误发生的偏移。如果没有发生错误，它在错误状态中存储 NoError，并存储它消耗的字节数（即，它存储第一个未使用字节的偏移）。使用这些信息可以解析同一个字节数组中可能存在的其他数据。

返回值可能是不完整的，即使解码失败也可能与有效的 QCborValue 无法区分。要确定是否发生错误，请检查 error 中是否存储了错误。此函数在第一次错误发生后立即停止解码。

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

[静态] 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()。

[静态] QCborValue QCborValue::fromVariant(const QVariant &variant)

将 QVariant variant 转换为 QCborValue 并返回它。

QVariants 可能包含大量不同的元类型，其中许多在 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

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

另请参阅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。无效的 QCborValue 与具有未定义值的那些不同，它们通常表示解码错误。

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

bool QCborValue::isMap() const

如果此 QCborValue 是映射类型，则返回 true。可以使用 toMap() 获取映射值。

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

bool QCborValue::isNull() const

如果此 QCborValue 是 null 类型，则返回 true。

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

null 值与未定义值和无效的 QCborValue 对象不同。API 不会创建无效的 QCborValue，但它们可能是解析错误的结果。

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

这是一个重载函数。