QCborValue Class

メンバ関数のドキュメント

QCborValue::QCborValue()

Undefined 型のQCborValueを作成します。

CBORの未定義値は、通常、前の操作が期待通りに完了しなかった結果として生じる情報の欠落を示すために使用されます。また、QCborArray およびQCborMap APIでは、検索対象が見つからなかったことを示すためにも使用されます。

未定義値は `Undefined simple type` で表されます。そのため、未定義値を持つ `QCborValue` は、`isSimpleType()` および `isSimpleType(QCborSimpleType::Undefined)` に対しても `true` を返します。

未定義の値は、null値とは異なります。

未定義の値を持つQCborValueオブジェクトは、無効なQCborValueオブジェクトとも異なります。APIは無効なQCborValueを作成することはありませんが、構文解析エラーの結果として無効な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用の2つの型で表現されます。そのため、ブール型のQCborValueは、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)

dt で表される値を含む、日付/時刻の拡張型である QCborValue オブジェクトを作成します。この値は、後でtoDateTime() を使用して取得できます。

CBORの日時型は、タグを使用した拡張型です。具体的には、DateTime としてタグ付けされた文字列（ISO日付形式）か、UnixTime_t としてタグ付けされた数値（1970年1月1日00:00:00 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拡張型であり、url で表される値を含む QCborValue オブジェクトを作成します。この値は、後でtoUrl() を使用して取得できます。

CBOR URL 型は、Url としてタグ付けされた文字列によって表される拡張型です。

toUrl()、isUrl()、およびtaggedValue()も参照してください 。

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

UUID拡張型であり、uuid で表される値を含む QCborValue オブジェクトを作成します。この値は、後で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のnull値は、指定されなかったオプションの値を示すために使用されます。null値は、通常、それ以前のエラーや問題の結果ではないという点で、未定義の値とは区別されます。

isNull()、isUndefined()、およびisSimpleType()も参照してください 。

タグ値 `tag`、タグ付け値 `tv` で表される拡張型に対して、QCborValue を作成します。このタグは後で `tag()` を使用して取得でき、タグ付けされた値は `taggedValue()` を使用して取得できます。

isTag()、tag()、taggedValue()、およびQCborKnownTagsも参照してください 。

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を返した場合、2つの値は等しく、同じ内容を持っています。

各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で定義されており、ここではカノニカルエンコーディングに従ったマップ内のキーのソートについて論じられています。仕様によると、「ソートはキーデータ項目の表現のバイトに対して行われる」とされており、その結果として次のように挙げられています：

• 「2つのキーの長さが異なる場合、短い方が先にソートされる」
• 「2つのキーの長さが同じ場合、（バイト単位の）辞書順で値が小さい方が先にソートされる。」

これにより、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 ストリームから 1 つの項目をデコードし、それに対応する表現を返します。この関数は再帰的です。つまり、項目がマップまたは配列である場合、最外層のオブジェクトが処理されるまで、そのマップまたは配列に含まれるすべての項目をデコードします。

この関数は、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 ストリームから 1 つの項目をデコードし、それに対応する表現を返します。この関数は再帰的です。つまり、項目がマップまたは配列である場合、最外層のオブジェクトが処理されるまで、そのマップまたは配列に含まれるすべての項目をデコードします。

この関数は、エラーが発生した場合は、そのエラー状態とエラーが発生した位置のオフセットを、error が指すオブジェクトに格納します。エラーが発生しなかった場合は、エラー状態に `NoError ` を格納し、消費したバイト数を格納します（つまり、最初に未使用のバイトのオフセットを格納します）。 この情報を使用することで、同じバイト配列内に存在する可能性のあるさらなるデータを解析することが可能になります。

デコードに失敗した場合でも、戻り値は部分的に完了しており、有効なQCborValue と見分けがつかない場合があります。エラーが発生したかどうかを確認するには、error にエラーが格納されているかどうかを確認してください。この関数は、最初のエラーが発生した直後にデコードを停止します。

toCbor()、toDiagnosticNotation()、toVariant()、およびtoJsonValue()も参照してください 。

len バイトのdata をQByteArray に変換し、その後、QByteArray を受け取るこの関数のオーバーロードを呼び出し、指定されている場合はerror も渡します。

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

v に含まれるJSON値を、対応するCBOR値に変換して返します。CBORの型セットはJSONよりも豊富であるため、JSONからCBORへの変換においてデータの損失は発生しません。さらに、この関数を使用して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用の2つの別々の型として格納されているためです。

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 がマップ型である場合、trueを返します。マップの値は、toMap() を使用して取得できます。

type() およびtoMap()も参照してください 。

bool QCborValue::isNull() const

このQCborValue がnull型である場合、trueを返します。

CBORのnull値は、指定されなかったオプションの値を示すために使用されます。null値は、通常、それ以前のエラーや問題の結果ではないという点で、undefined値とは異なります。

null値は、未定義の値や無効なQCborValue オブジェクトとは区別されます。APIは無効なQCborValuesを作成することはありませんが、構文解析エラーの結果として無効なQCborValuesが存在する可能性があります。

type()、isUndefined()、およびisInvalid()も参照してください 。

bool QCborValue::isRegularExpression() const

このQCborValue に正規表現のパターンが含まれている場合、trueを返します。このパターンは、toRegularExpression() を使用して取得できます。

type() およびtoRegularExpression()も参照してください 。

bool QCborValue::isSimpleType() const

このQCborValue がCBORの単純型のいずれかに該当する場合、trueを返します。この型自体は、APIに列挙型がない場合でも、後でtype() を使用して取得できます。また、isSimpleType （QCborSimpleType）のオーバーロードを使用して確認することもできます。

QCborSimpleType 、isSimpleType(QCborSimpleType)、およびtoSimpleType()も参照してください 。

bool QCborValue::isSimpleType(QCborSimpleType st) const

このQCborValue が単純型であり、toSimpleType()がst を返す場合、trueを返します。それ以外の場合はfalseを返します。この関数は、APIに列挙型が存在しないものも含め、あらゆるCBOR単純型のチェックに使用できます。例えば、値が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用の2つの別々の型として格納されているためです。

type()、isBool()、isFalse()、およびtoBool()も参照してください 。

bool QCborValue::isUndefined() const

このQCborValue が「未定義」タイプである場合、trueを返します。

CBORの未定義値は、通常、期待どおりに完了しなかった前の操作の結果として生じる情報の欠落を示すために使用されます。また、QCborArray およびQCborMap APIでは、検索対象が見つからなかったことを示すためにも使用されます。

未定義値は、null 値とは異なります。

QCborValue 未定義値を持つオブジェクトは、無効なQCborValue オブジェクトとも異なります。APIは無効な QCborValues を作成することはありませんが、構文解析エラーの結果としてそれらが存在する場合があります。

type()、isNull()、およびisInvalid()も参照してください 。

bool QCborValue::isUrl() const

このQCborValue がURL型である場合、trueを返します。URLの値は、toUrl() を使用して取得できます。

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

この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 ` オブジェクトを、opt で指定されたオプションを使用して 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

このQCborValue オブジェクトを、opt で指定されたオプションを使用して、writer で指定されたライターに対して CBOR 表現にエンコードします。同じライターを複数の QCborValues で共有して使用することも可能です。例えば、より大きな配列内の異なる要素をエンコードする場合などが挙げられます。

この関数は、QCborValue 自体、または（これがマップや配列である場合）その中に含まれる項目のいずれかが無効である場合を除き、失敗することはありません。無効な型は通常、APIによって生成されるものではありませんが、デコードエラーの結果として生じる可能性があります。

デフォルトでは、この関数はQCborValue 内の値に対して変換を行わず、すべての浮動小数点数を直接倍精度（binary64）型として書き込みます。UseFloat オプションが指定された場合、その表現を使用しても精度の損失がない浮動小数点値については、単精度（binary32）が使用されます。 これには、無限大やNaN値も含まれます。

同様に、UseFloat16 が指定されている場合、この関数は、変換によって精度の損失が生じない限り、半精度（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 は格納されません。

QVariantMapsはCBORとは異なり、キーが文字列であるため、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)

指定されたkey を用いて、このオブジェクト内のエントリ（マップとして）を読み取ったり変更したりするために使用できるQCborValueRefを返します。この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)

指定されたkey を用いて、このオブジェクト内のエントリ（マップとして）を読み取ったり変更したりするために使用できるQCborValueRefを返します。このQCborValue がQCborMap である場合、この関数はそのマップに対する対応する演算子[]と同等です。

参照を返す前に：このQCborValue が配列であった場合、まずマップに変換されます（これにより、各インデックスi に対して、map[i] はarray[i] となり、array[i] が有効になります）。それ以外の場合、マップでなかった場合は空のマップで上書きされます。

operator[] （qint64）、QCborMap::operator[] 、QCborMap::value()、およびQCborMap::find()も参照してください 。

QCborValueRef QCborValue::operator[](qint64 key)

指定されたkey を用いて、このオブジェクト内のエントリをマップまたは配列として読み取ったり変更したりするために使用できるQCborValueRefを返します。この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()も参照してください 。