QCborValue Class

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

配列a でQCborValue を作成する。この配列は、後でtoArray() を使用して取得することができます。

toArray()、isArray() およびisMap()も参照 。

マップm を持つQCborValue を作成する。このマップは、後でtoMap() を使用して取得することができる。

toMap()、isMap() およびisArray()も参照 。

タグ値tag 、タグ値tv で表される拡張タイプのQCborValue を作成する。タグは後でtag() を使用して取得でき、タグ値はtaggedValue() を使用して取得できます。

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

このQCborValue に格納されている配列値が配列型であれば、その値を返す。そうでない場合は、defaultValue を返す。

この関数は、他の型からQCborArray への変換は行わないことに注意。

isArray()、isByteArray()、isMap()、isContainer() およびtoMap()も参照 。

このQCborValue に格納されているマップ値がマップ・タイプであれば、それを返す。そうでない場合は、defaultValue を返す。

この関数は、他の型からQCborMap への変換は行わないことに注意。

isMap()、isArray()、isContainer() およびtoArray()も参照 。

これはオーバーロードされた関数である。

data error の バイトを に変換し、 を受け付けるこの関数のオーバーロードを呼び出します。len QByteArray QByteArray

QCborValue::QCborValue()

Undefined タイプの QCborValue を作成します。

CBORの未定義値は、情報の欠落を示すために使用されます。また、QCborArray およびQCborMap API でも、検索された項目が見つからなかったことを示すために使用されます。

未定義の値は、Undefined simple type で表されます。そのため、未定義の値を持つ QCborValues は、isSimpleType() やisSimpleType(QCborSimpleType::Undefined) でも真を返します。

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

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

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

QCborValue::QCborValue(QCborSimpleType st)

st 型の QCborValue を作成する。この型は、isSimpleType(st)と同様に、toSimpleType()を使用して後で取得することができます。

nullptrCBOR の単純型は、C++ のstd::nullptr_t 型のように、関連する値を持たない型です。

st がQCborSimpleType::Null の場合、結果の QCborValue はNull 型になり、QCborSimpleType::Undefined も同様です。st がQCborSimpleType::False またはQCborSimpleType::True の場合、作成される QCborValue はそれぞれ false または true の値を含む boolean 型になります。

この関数は、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 の boolean は、true と false の 2 つの型のペアで表現されます。そのため、ブーリアン型 QCborValues は、isSimpleType() の場合は true を返し、isSimpleType(QCborSimpleType::False) またはisSimpleType(QCborSimpleType::True) の場合は false を返します。

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 年の開始からの秒数、UTC）のいずれかです。CBOR ストリームを解析するとき、QCborValue はUnixTime_t を文字列ベースの型に変換します。

toDateTime()、isDateTime()、taggedValue()も参照してください 。

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

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

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を返す場合、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節で定義されており、Canonicalエンコーディングに従った場合のマップ内のキーのソートについて議論されています。この仕様によると、"ソートはキーのデータ項目の表現のバイト数で実行される "とあり、その結果として以下のように列挙されている：

• 「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()も参照のこと 。

[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 に変換して返す。

QVariantsはさまざまなメタ型の大きなリストを含むことができ、その多くはCBORで対応する表現を持っていない。これには、すべてのユーザー定義メタ型が含まれる。CBORを使用して送信を準備するとき、表現の損失を防ぐために各値を注意深くエンコードすることが推奨される。

次の表は、この関数が適用する変換の一覧です：

QVariant::isNull() が真を返した場合、QVariant が持つ型に関係なく、NULLQCborValue が返されるか、リストやオブジェクトに挿入されます。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 が真偽値であれば真を返す。この値はtoBool() で取得できます。

type()、toBool()、isTrue() およびisFalse()も参照 。

bool QCborValue::isByteArray() const

このQCborValue がバイト配列型であれば真を返す。バイト配列の値は、toByteArray() を使用して取得できます。

type() およびtoByteArray()も参照 。

bool QCborValue::isContainer() const

この便利な関数は、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 が偽の値を持つ boolean であれば真を返す。この関数が存在するのは、内部的に CBOR の boolean は真と偽の 2 つの別々の型として格納されるからである。

type(),isBool(),isTrue(),toBool()も参照 。

bool QCborValue::isInteger() const

このQCborValue が整数型であれば真を返す。整数値はtoInteger() で取得できます。

type() およびtoInteger()も参照 。

bool QCborValue::isInvalid() const

このQCborValue が有効な型でない場合、true を返します。無効な QCborValue は、未定義の値とは異なり、通常はデコード・エラーを表します。

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

bool QCborValue::isMap() const

このQCborValue が map 型であれば true を返す。マップ値はtoMap() で取得できます。

type() およびtoMap()も参照 。

bool QCborValue::isNull() const

このQCborValue がヌル・タイプの場合、true を返す。

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

NULL値は、未定義値や無効なQCborValue オブジェクトとは異なります。API が無効な QCborValue を作成することはありませんが、解析エラーの結果として存在することがあります。

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 が文字列型であれば真を返す。文字列値は、toString() を使用して取得できます。

type() およびtoString()も参照 。

bool QCborValue::isTag() const

このQCborValue がタグ・タイプであれば真を返す。タグ値はtag() で、タグ付き値はtaggedValue() で取得できる。

この関数は、API が認識する拡張型についても真を返します。Qt API が拡張型をサポートするように更新される前に拡張型を直接扱ったコードでは、taggedValue() を使用してタグとタグ付き値のペアを再作成することができます。

type(),tag(),taggedValue(),taggedValue()も参照してください 。

bool QCborValue::isTrue() const

このQCborValue が真値を持つ boolean であれば真を返す。この関数が存在するのは、内部的に CBOR の boolean は false と true の 2 つの別々の型として格納されるからである。

type(),isBool(),isFalse(),toBool()も参照 。

bool QCborValue::isUndefined() const

このQCborValue が未定義型である場合、true を返す。

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

未定義値はヌル値とは異なります。

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

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()も参照のこと 。

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 で指定されたオプションを使用して、writer で指定されたライターに、このQCborValue オブジェクトを CBOR 表現にエンコードします。例えば、より大きな配列の異なる要素をエンコードするために、同じライタを複数の QCborValue で使用することができます。

この関数は、この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診断記法はRFC7049のセクション6で規定されています。これはCBORストリームのテキスト表現であり、JSONに非常に似ているが、JSONにはないCBOR型をサポートしている。ExtendedFormat フラグによって有効化される拡張フォーマットは、現在いくつかのIETFドラフトにあり、そのフォーマットは変更される可能性がある。

この関数は、toCbor()が生成するストリームと同等の表現を、そこで提供される変換オプションなしで生成します。これはまた、オブジェクトがfromCbor() を使って作成された場合、その関数が変換を適用している可能性があるため、この関数は、オブジェクトの作成に使用されたストリームの表現を生成しない可能性があることを意味します。変換のないストリームの忠実度の高い表記については、cbordump の例を参照してください。

toCbor() およびQJsonDocument::toJson()も参照 。

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

Double型の場合は、QCborValue に格納されている浮動小数点値を返します。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 に未定義の値が含まれている場合、この関数は未定義のQJsonValue も返す。JSONは未定義の値をサポートしておらず、未定義のQJsonValueは仕様の拡張であることに注意してください。これらは、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 が格納されることはありません。

QVariantMapは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)

QCborValueRef を返します。この QCborValueRef を使用して、指定されたkey のエントリをマップとして読み取ったり、変更したりすることができます。このQCborValue がQCborMap の場合、この関数はそのマップのマッチング演算子[]と等価です。

参照を返す前に: このQCborValue が配列であった場合、まずマップに変換されます（各インデックス、i 、および有効なarray[i] に対して、map[i] がarray[i] となるように）。

operator[](qint64)、QCborMap::operator[] 、QCborMap::value()、QCborMap::find()も参照のこと 。

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

このQCborValue がQCborMap の場合、キーがkey にマッチする値の要素を検索する。マップ内にkey にマッチするキーがない場合、またはこのQCborValue オブジェクトがマップでない場合は、未定義の値を返します。

この関数は以下と等価である：

    value.toMap().value(key);

operator[](qint64)、QCborMap::operator[] 、QCborMap::value()、QCborMap::find()も参照 。

QCborValueRef QCborValue::operator[](QLatin1StringView key)

これはオーバーロードされた関数です。

QCborValueRef を返します。この QCborValueRef を使用して、指定されたkey のエントリをマップとして読み取ったり、変更したりすることができます。このQCborValue がQCborMap の場合、この関数はそのマップのマッチング演算子[]と等価です。

参照を返す前に: このQCborValue が配列であった場合、まずマップに変換されます（各インデックス、i 、および有効なarray[i] に対して、map[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] が各インデックス、i 、有効なarray[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 オブジェクトがマップでない場合、未定義の値を返します。

この関数は以下と等価である：

    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 オブジェクトが配列またはマップでない場合、未定義の値を返します。

operator[] 、QCborMap::operator[] 、QCborMap::value()、QCborMap::find()、QCborArray::operator[] 、QCborArray::at()も参照 。