QCborMap Class

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

[noexcept] QCborMap::QCborMap()

空の CBOR Map オブジェクトを作成します。

isEmpty()も参照してください 。

QCborMap::QCborMap(std::initializer_list<QCborMap::value_type> args)

args にある中括弧による初期化リストの項目を使用して、QCborMap を生成します。以下の例のように：

QCborMap map = {
    {0, "Hello"},
    {1, "World"},
    {"foo", nullptr},
    {"bar", QCborArray{0, 1, 2, 3, 4}}
};

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

other のコピーとなる QCborMap オブジェクトを作成します。

[constexpr noexcept default, since 6.10] QCborMap::QCborMap(QCborMap &&other)

移動コンストラクタ。

移動元のオブジェクト `other ` は、デフォルトコンストラクタで初期化された状態になります。

この関数は Qt 6.10 で導入されました。

QCborMap::QCborMap()も参照してください 。

[noexcept] QCborMap::~QCborMap()

この `QCborMap ` オブジェクトを破棄し、そのオブジェクトが所有する関連リソースをすべて解放します。

このマップをキー/値のペアとして反復処理できる範囲オブジェクトを返します。

この方法で取得される値は、マップ内の値への参照である点に注意してください。具体的には、その値を変更すると、マップ自体が変更されます。

これらの関数は Qt 6.10 で導入されました。

QKeyValueIteratorも参照してください 。

QCborMap::iterator QCborMap::begin()

このマップの最初のキーと値のペアを指すマップイテレータを返します。このマップが空の場合、返されるイテレータは `end()` と同じものになります。

constBegin() およびend()も参照してください 。

QCborMap::const_iterator QCborMap::begin() const

このマップの最初のキーと値のペアを指すマップイテレータを返します。このマップが空の場合、返されるイテレータは `constEnd()` と同じものになります。

cbegin() およびconstEnd()も参照してください 。

QCborMap::const_iterator QCborMap::cbegin() const

このマップの最初のキーと値のペアを指すマップイテレータを返します。このマップが空の場合、返されるイテレータは `constEnd()` と同じものになります。

begin() およびconstEnd()も参照してください 。

QCborMap::const_iterator QCborMap::cend() const

マップの最後の要素のすぐ次の要素を表すマップ・イテレータを返します。

begin()、constBegin()、find()、およびconstFind()も参照してください 。

void QCborMap::clear()

このマップを空にします。

isEmpty()も参照してください 。

[noexcept] int QCborMap::compare(const QCborMap &other) const

このマップと `other` を、各要素を順番に比較して照合し、このマップを `other ` の実行前（結果が負の場合）または実行後（結果が正の場合）にソートすべきかどうかを示す整数を返します。この関数が 0 を返した場合、2 つのマップは等しく、同じ要素を含んでいることを意味します。

CBORマップは順序付けられていないことに注意してください。つまり、まったく同じペアを含んでいても順序が異なれば、2つのマップの比較結果は異なります。これを回避するには、キー値の昇順など、予測可能な順序で要素をマップに挿入することをお勧めします。実際、正規化されたCBOR表現では、キーがソートされた順序のマップが必須となります。

CBORのソート順序に関する詳細については、QCborValue::compare() を参照してください。

また、 QCborValue::compare()、QCborArray::compare()、およびoperator==()も参照してください 。

QCborMap::const_iterator QCborMap::constBegin() const

このマップの最初のキーと値のペアを指すマップイテレータを返します。このマップが空の場合、返されるイテレータは `constEnd()` と同じものになります。

begin() およびconstEnd()も参照してください 。

QCborMap::const_iterator QCborMap::constEnd() const

マップの最後の要素のすぐ後の要素を表すマップイテレータを返します。

begin()、constBegin()、find()、およびconstFind()も参照してください 。

QCborMap::const_iterator QCborMap::constFind(qint64 key) const

マップにkey というキーを持つキーと値のペアが含まれている場合、そのペアへのマップイテレータを返します。含まれていない場合、この関数はconstEnd()を返します。

CBORでは、整数のキーを使用することを推奨しています。これは、整数のキーの方が占有するスペースが少なく、エンコードおよびデコードが容易であるためです。

マップ内にkey と等しいキーが複数存在する場合、この関数がどのキーを検出するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、そのようなキーを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複するキーは許可されておらず、重複キーが存在することは、送信側に問題があることを示唆しています。

関連項目： value(qint64)、operator[](qint64)、find(qint64)、remove(qint64)、contains(qint64)、value(QLatin1StringView)、value(const QString &)、およびvalue(const QCborValue &)。

QCborMap::const_iterator QCborMap::constFind(QLatin1StringView key) const

マップにkey というキーを持つキー・値ペアが含まれている場合、そのペアへのマップイテレータを返します。含まれていない場合、この関数はconstEnd()を返します。

マップにkey と等しいキーが複数存在する場合、この関数がどのキーを検出するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、これらは許可されておらず、重複するキーが存在することは、送信側に問題があることを示唆しています。

value(QLatin1StringView)、operator[](QLatin1StringView)、find(QLatin1StringView)、remove(QLatin1StringView)、contains(QLatin1StringView)、value(qint64)、value(const QString &)、およびvalue(const QCborValue &)も参照してください 。

QCborMap::const_iterator QCborMap::constFind(const QCborValue &key) const

マップにkey というキーを持つキーと値のペアが含まれている場合、そのペアへのマップイテレータを返します。含まれていない場合、この関数はconstEnd()を返します。

マップにkey と等しいキーが複数存在する場合、この関数がどのキーを検出するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、これらは許可されておらず、重複するキーが存在することは、送信側に問題があることを示唆しています。

value(const QCborValue &)、operator[](const QCborValue &)、find(const QCborValue &)、remove(const QCborValue &)、contains(const QCborValue &)、value(qint64)、value(QLatin1StringView)、およびvalue(const QString &)も参照してください。

QCborMap::const_iterator QCborMap::constFind(const QString &key) const

マップにkey というキーを持つキー・値ペアが含まれている場合、そのペアへのマップイテレータを返します。含まれていない場合、この関数はconstEnd()を返します。

マップ内にkey と等しいキーが複数存在する場合、この関数がどのキーを検出するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複するキーは許可されておらず、重複するキーが存在することは、送信側に問題があることを示唆しています。

関連項目： value(const QString &)、operator[](const QString &)、find(const QString &)、remove(const QString &)、contains(const QString &)、value(qint64)、value(QLatin1StringView)、およびvalue(const QCborValue &)。

[since 6.10] QCborMap::const_key_value_iterator QCborMap::constKeyValueBegin() const

マップの最初のエントリを指す、STL スタイルのconstイテレータを返します。

この関数は Qt 6.10 で導入されました。

keyValueBegin()も参照してください 。

[since 6.10] QCborMap::const_key_value_iterator QCborMap::constKeyValueEnd() const

マップの最後のエントリの直後に位置する仮想のエントリを指す、STL スタイルのconstイテレータを返します。

この関数は Qt 6.10 で導入されました。

constKeyValueBegin()も参照してください 。

bool QCborMap::contains(const QCborValue &key) const

このマップに、キー「key 」で識別されるキーと値のペアが含まれている場合、true を返します。

関連項目: value(const QCborValue &)、operator[](const QCborValue &)、find(const QCborValue &)、remove(const QCborValue &)、contains(qint64)、remove(QLatin1StringView)、およびremove(const QString &)。

bool QCborMap::contains(qint64 key) const

このマップに、キー「key 」で識別されるキー・値のペアが含まれている場合、true を返します。CBOR では、整数のキーを使用することを推奨しています。これは、整数のキーの方が占有するスペースが少なく、エンコードやデコードも簡単だからです。

関連項目： value(qint64)、operator[](qint64)、find(qint64)、remove(qint64)、contains(QLatin1StringView)、remove(const QString &)、およびremove(const QCborValue &)。

bool QCborMap::contains(QLatin1StringView key) const

このマップに、キー「key 」で識別されるキーと値のペアが含まれている場合、true を返します。

value(QLatin1StringView)、operator[](QLatin1StringView)、find(QLatin1StringView)、remove(QLatin1StringView)、contains(qint64)、remove(const QString &)、およびremove(const QCborValue &)も参照してください 。

bool QCborMap::contains(const QString &key) const

このマップに、キー「key 」で識別されるキーと値のペアが含まれている場合、true を返します。

value(const QString &)、operator[](const QString &)、find(const QString &)、remove(const QString &)、contains(qint64)、remove(QLatin1StringView)、およびremove(const QCborValue &)も参照してください。

bool QCborMap::empty() const

isEmpty() の別名です。この関数は、標準ライブラリ API を使用する汎用コードとの互換性を確保するために提供されています。

このマップが空の場合、true を返します（size() == 0）。

isEmpty() およびsize()も参照してください 。

QCborMap::iterator QCborMap::end()

マップの最後の要素のすぐ後の要素を表すマップイテレータを返します。

begin()、constBegin()、find()、およびconstFind()も参照してください 。

QCborMap::const_iterator QCborMap::end() const

マップの最後の要素の直後の要素を表すマップイテレータを返します。

begin()、constBegin()、find()、およびconstFind()も参照してください 。

QCborMap::iterator QCborMap::erase(QCborMap::const_iterator it)

マップイテレータ `it ` が指すキーと値のペアを削除し、削除後の次の要素へのポインタを返します。

remove()、begin()、end()、insert()、およびextract()も参照してください 。

QCborMap::iterator QCborMap::erase(QCborMap::iterator it)

マップイテレータ `it ` が指すキーと値のペアを削除し、削除後の次の要素へのポインタを返します。

remove()、begin()、end()、およびinsert()も参照してください 。

イテレータ `it ` で指定された位置にあるマップから値を抽出し、抽出した値を返します。

insert()、erase()、take()、およびremove()も参照してください 。

マップにkey というキーを持つキーと値のペアが含まれている場合、そのペアへのマップイテレータを返します。含まれていない場合、この関数はend()を返します。

CBORでは、整数のキーを使用することを推奨しています。これは、整数のキーの方が占有するスペースが少なく、エンコードおよびデコードが簡単だからです。

マップ内にkey と等しいキーが複数存在する場合、この関数がどのキーを検出するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、そのようなキーを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複するキーは許可されておらず、重複するキーが存在することは、送信側に問題があることを示唆しています。

関連項目： value(qint64)、operator[](qint64)、constFind(qint64)、remove(qint64)、contains(qint64)、value(QLatin1StringView)、value(const QString &)、およびvalue(const QCborValue &)。

マップにkey というキーを持つキー・値ペアが含まれている場合、そのペアへのマップイテレータを返します。含まれていない場合、この関数はend()を返します。

マップにkey と等しいキーが複数含まれている場合、この関数がどのキーを見つけるかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複するキーは許可されておらず、重複するキーが存在することは、送信元に問題があることを示唆しています。

関連項目： value(QLatin1StringView)、operator[](QLatin1StringView)、constFind(QLatin1StringView)、remove(QLatin1StringView)、contains(QLatin1StringView)、value(qint64)、value(const QString &)、およびvalue(const QCborValue &)。

マップにkey というキーを持つキー・値ペアが存在する場合、そのペアへのマップイテレータを返します。存在しない場合、この関数はend()を返します。

マップ内にkey と等しいキーが複数存在する場合、この関数がどのキーを検出するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、そのようなキーを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複キーは許可されておらず、重複キーが存在することは、送信側に問題があることを示唆しています。

関連項目： value(const QCborValue &)、operator[](const QCborValue &)、constFind(const QCborValue &)、remove(const QCborValue &)、contains(const QCborValue &)、value(qint64)、value(QLatin1StringView)、およびvalue(const QString &)。

マップにkey というキーを持つキー・値ペアが含まれている場合、そのペアへのマップイテレータを返します。含まれていない場合、この関数はend()を返します。

マップ内にkey と等しいキーが複数存在する場合、この関数がどのキーを検出するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複するキーは許可されておらず、重複キーが存在することは、送信側に問題があることを示唆しています。

関連項目： value(const QString &)、operator[](const QString &)、constFind(const QString &)、remove(const QString &)、contains(const QString &)、value(qint64)、value(QLatin1StringView)、およびvalue(const QCborValue &)。

[static] QCborMap QCborMap::fromJsonObject(const QJsonObject &obj)

obj オブジェクト内に見つかったすべてのJSON項目を、QCborValue::fromJson() を使用してCBORに変換し、それらの要素で構成されるマップを返します。

CBORの型体系はJSONの超集合であるため、この変換は損失なしで行われます。さらに、この関数によって返されるマップは、toJsonObject() を使用することで、元のobj に戻すことができます。

toJsonObject()、toVariantMap()、QCborValue::fromJsonValue()、およびQCborArray::fromJsonArray()も参照してください 。

[static noexcept, since 6.3] QCborMap QCborMap::fromJsonObject(QJsonObject &&obj)

この関数は Qt 6.3 で導入されました。

[static] QCborMap QCborMap::fromVariantHash(const QVariantHash &hash)

`QCborValue::fromVariant()` を使用して、hash 内のすべての項目を CBOR に変換し、それらの要素で構成されるマップを返します。

QVariant からの変換は、完全にロスレスではありません。詳細については、QCborValue::fromVariant() のドキュメントを参照してください。

toVariantHash()、fromVariantMap()、fromJsonObject()、およびQCborValue::fromVariant()も参照してください 。

[static] QCborMap QCborMap::fromVariantMap(const QVariantMap &map)

`QCborValue::fromVariant()` を使用して、map 内のすべての項目を CBOR に変換し、それらの要素で構成されるマップを返します。

QVariant からの変換は完全にロスレスではありません。詳細については、QCborValue::fromVariant() のドキュメントを参照してください。

toVariantMap()、fromVariantHash()、fromJsonObject()、およびQCborValue::fromVariant()も参照してください 。

QCborMap::iterator QCborMap::insert(QCborMap::value_type v)

v に含まれるキーと値のペアをこのマップに挿入し、新しく挿入されたペアを指すマップイテレータを返します。

マップにすでにv.first と等しいキーが存在する場合、その値はv.second で上書きされます。

operator[] 、erase()、およびextract()も参照してください 。

QCborMap::iterator QCborMap::insert(QLatin1StringView key, const QCborValue &value)

このマップにキー「key 」と値「value 」を挿入し、新しく挿入されたペアを指すマップイテレータを返します。

マップにすでにkey と等しいキーが存在する場合、その値はvalue で上書きされます。

erase()、remove(QLatin1StringView)、value(QLatin1StringView)、operator[](QLatin1StringView)、find(QLatin1StringView)、contains(QLatin1StringView)、take(QLatin1StringView)、およびextract()も参照してください 。

QCborMap::iterator QCborMap::insert(const QCborValue &key, const QCborValue &value)

このマップにキー「key 」と値「value 」を挿入し、新しく挿入されたペアを指すマップイテレータを返します。

マップにすでにkey と等しいキーが存在する場合、その値はvalue で上書きされます。

erase()、remove(const QCborValue &)、value(const QCborValue &)、operator[](const QCborValue &)、find(const QCborValue &)、contains(const QCborValue &)、take(const QCborValue &)、およびextract()も参照してください。

QCborMap::iterator QCborMap::insert(const QString &key, const QCborValue &value)

このマップにキー「key 」と値「value 」を挿入し、新しく挿入されたペアを指すマップイテレータを返します。

マップにすでにkey と等しいキーが存在する場合、その値はvalue で上書きされます。

erase()、remove(const QString &)、value(const QString &)、operator[](const QString &)、find(const QString &)、contains(const QString &)、take(const QString &)、およびextract()も参照してください 。

QCborMap::iterator QCborMap::insert(qint64 key, const QCborValue &value)

このマップにキー「key 」と値「value 」を挿入し、新しく挿入されたペアを指すマップイテレータを返します。

マップにすでにkey と等しいキーが存在する場合、その値はvalue で上書きされます。

erase()、remove(qint64)、value(qint64)、operator[](qint64)、find(qint64)、contains(qint64)、take(qint64)、およびextract()も参照してください 。

bool QCborMap::isEmpty() const

このマップが空の場合（つまり、size() の値が 0 の場合）、true を返します。

size() およびclear()も参照してください 。

[since 6.10] QCborMap::key_value_iterator QCborMap::keyValueBegin()

マップの最初のエントリを指すSTL スタイルのイテレータを返します。

この関数は Qt 6.10 で導入されました。

keyValueEnd()も参照してください 。

[since 6.10] QCborMap::const_key_value_iterator QCborMap::keyValueBegin() const

マップの最初のエントリを指す、STL スタイルのconstイテレータを返します。

この関数は Qt 6.10 で導入されました。

keyValueEnd()も参照してください 。

[since 6.10] QCborMap::key_value_iterator QCborMap::keyValueEnd()

マップの最後のエントリの直後に位置する仮想のエントリを指す、STL 形式のイテレータを返します。

この関数は Qt 6.10 で導入されました。

keyValueBegin()も参照してください 。

[since 6.10] QCborMap::const_key_value_iterator QCborMap::keyValueEnd() const

マップの最後のエントリの直後に位置する仮想のエントリを指す、STL スタイルのconstイテレータを返します。

この関数は Qt 6.10 で導入されました。

keyValueBegin()も参照してください 。

QList<QCborValue> QCborMap::keys() const

このマップに含まれるすべてのキーのリストを返します。

QMap::keys() およびQHash::keys()も参照してください 。

void QCborMap::remove(const QCborValue &key)

マップからキー「key 」とそれに対応する値が見つかった場合、それらを削除します。マップにそのようなキーが含まれていない場合、この関数は何も行いません。

マップ内に `key` と等しいキーが複数存在する場合、この関数がどのキーを削除するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含む CBOR ストリームをデコードすることで、そのようなマップが生成される可能性があります。通常、重複するキーは許可されておらず、重複キーの存在は送信側での問題を示唆していることが一般的です。

remove(qint64)、remove(QLatin1StringView)、remove(constQString &)

value(const QCborValue &)、operator[](const QCborValue &)、find(const QCborValue &)、およびcontains(const QCborValue &)も参照してください。

void QCborMap::remove(qint64 key)

マップから、key というキーとそれに対応する値が見つかった場合に、それらを削除します。マップにそのようなキーが含まれていない場合、この関数は何もしません。

マップ内に `key` と等しいキーが複数存在する場合、この関数がどのキーを削除するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、そのようなキーを含む CBOR ストリームをデコードすることで、そのようなマップが生成される可能性があります。通常、重複するキーは許可されておらず、重複キーが存在することは、送信側に問題があることを示唆しています。

remove(QLatin1StringView), remove(constQString &), remove(constQCborValue &)

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

void QCborMap::remove(QLatin1StringView key)

マップからキー「key 」と、それに対応する値が見つかった場合はそれらを削除します。マップにそのようなキーが含まれていない場合、この関数は何も行いません。

マップ内にkey と等しいキーが複数存在する場合、この関数がどのキーを削除するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含む CBOR ストリームをデコードすることで、そのようなマップを作成することは可能です。通常、これらは許可されておらず、重複するキーが存在することは、送信側に問題があることを示唆しています。

value(QLatin1StringView)、operator[](QLatin1StringView)、find(QLatin1StringView)、contains(QLatin1StringView)、remove(qint64)、remove(const QString &)、およびremove(const QCborValue &)も参照してください 。

void QCborMap::remove(const QString &key)

マップからキー「key 」とそれに対応する値が見つかった場合、それらを削除します。マップにそのようなキーが含まれていない場合、この関数は何も行いません。

マップ内に `key` と等しいキーが複数存在する場合、本関数がどのキーを削除するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含む CBOR ストリームをデコードすることで、そのようなマップが生成される可能性があります。通常、重複するキーは許可されておらず、重複キーが存在することは、送信側に問題があることを示している場合がほとんどです。

remove(qint64)、remove(QLatin1StringView)、remove(constQCborValue &)

value(const QString &)、operator[](const QString &)、find(const QString &)、およびcontains(const QString &)も参照してください 。

[noexcept] qsizetype QCborMap::size() const

このマップに含まれる要素の数を返します。

isEmpty()も参照してください 。

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

このマップを「other 」と入れ替えます。この操作は非常に高速で、失敗することはありません。

QCborValue QCborMap::take(QLatin1StringView key)

マップからキー「key 」とそれに対応する値を削除し、値が見つかった場合はその値を返します。マップにそのようなキーが含まれていない場合、この関数は何も行いません。

マップ内に「key 」と等しいキーが複数存在する場合、この関数がどのキーを削除するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップが生成される可能性があります。通常、重複するキーは許可されておらず、重複キーの存在は送信側に問題があることを示唆しています。

関連項目： value(QLatin1StringView)、operator[](QLatin1StringView)、find(QLatin1StringView)、contains(QLatin1StringView)、take(qint64)、take(const QString &)、take(const QCborValue &)、およびinsert()。

QCborValue QCborMap::take(const QCborValue &key)

マップからキー「key 」とそれに対応する値を削除し、値が見つかった場合はその値を返します。マップにそのようなキーが含まれていない場合、この関数は何も行いません。

マップ内にkey と等しいキーが複数存在する場合、この関数がどのキーを削除するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含む CBOR ストリームをデコードすることで、そのようなマップが生成される可能性があります。通常、重複するキーは許可されておらず、重複キーが存在することは、送信側に問題があることを示している場合がほとんどです。

関連項目： value(const QCborValue &)、operator[](const QCborValue &)、find(const QCborValue &)、contains(const QCborValue &)、take(QLatin1StringView)、take(const QString &)、take(qint64)、およびinsert()。

QCborValue QCborMap::take(const QString &key)

マップからキー「key 」とそれに対応する値を削除し、値が見つかった場合はその値を返します。マップにそのようなキーが含まれていない場合、この関数は何も行いません。

マップ内にkey と等しいキーが複数存在する場合、この関数がどのキーを削除するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含む CBOR ストリームをデコードすることで、そのようなマップが生成される可能性があります。通常、重複するキーは許可されておらず、重複キーが存在することは、送信側に問題があることを示唆しています。

関連項目： value(const QString &)、operator[](const QString &)、find(const QString &)、contains(const QString &)、take(QLatin1StringView)、take(qint64)、take(const QCborValue &)、およびinsert()。

QCborValue QCborMap::take(qint64 key)

マップからキー「key 」とそれに対応する値を削除し、値が見つかった場合はその値を返します。マップにそのようなキーが含まれていない場合、この関数は何も行いません。

マップ内に `key` と等しいキーが複数存在する場合、この関数がどのキーを削除するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、そのようなキーを含む CBOR ストリームをデコードすることで、そのようなマップを作成することは可能です。通常、これらは許可されておらず、重複するキーが存在することは、送信元に問題があることを示唆しています。

value(qint64)、operator[](qint64)、find(qint64)、contains(qint64)、take(QLatin1StringView)、take(const QString &)、take(const QCborValue &)、およびinsert()も参照してください 。

QCborValue QCborMap::toCborValue() const

このマップを表すQCborValue オブジェクトを明示的に生成します。QCborValue にはQCborMap 用のコンストラクタが用意されているため、通常はこの関数は必要なく、変換は暗黙的に行われます。

QCborMap をQCborValue に変換することで、QCborValues が使用可能なあらゆるコンテキストでこれを使用できるようになります。これには、QCborMap におけるキーやマップされた型としての使用、およびQCborValue::toCbor() での使用が含まれます。

QCborValue::QCborValue(const QCborMap &)も参照してください 。

QJsonObject QCborMap::toJsonObject() const

このマップ内のすべてのQCborValue 値を、QCborValue::toJsonValue() を使用して再帰的にJSONに変換し、文字列でないすべてのキーに対して文字列キーを作成した後、それらの関連付けで構成される対応するQJsonObject を返します。

CBORはJSONよりも豊富で幅広い型セットを含むため、この変換の過程で一部の情報が失われる可能性がある点にご注意ください。適用される変換の詳細については、QCborValue::toJsonValue()を参照してください。

キーの文字列への変換

JSONオブジェクトは、CBORとは異なり、キーが文字列であると定義されているため、QCborMap からQJsonObject への変換には、キー値の「文字列化」というステップが含まれます。この変換では、前述のタグおよび拡張型の特別な処理が適用されるほか、その他の型についても以下のように変換されます：

fromJsonObject()、QCborValue::toJsonValue()、QCborArray::toJsonArray()、およびtoVariantMap()も参照してください 。

QVariantHash QCborMap::toVariantHash() const

QCborValue::toVariant() を使用して CBOR 値をQVariant に変換し、このマップ内のすべての CBOR キーを「文字列化」して、その結果として得られる関連付けリストであるQVariantHash を返します。

QVariantMapsはCBORとは異なり、キーが文字列であるため、QCborMap からQVariantMap への変換には、キー値の「文字列化」という手順が含まれます。詳細については、QCborMap::toJsonObject()を参照してください。

また、QVariant への変換は完全には損失なしとは限りません。詳細については、QCborValue::toVariant() のドキュメントを参照してください。

fromVariantHash()、toVariantMap()、toJsonObject()、QCborValue::toVariant()、およびQCborArray::toVariantList()も参照してください 。

QVariantMap QCborMap::toVariantMap() const

QCborValue::toVariant() を使用して CBOR 値をQVariant に変換し、このマップ内のすべての CBOR キーを「文字列化」して、その結果として得られる関連付けリストをQVariantMap として返します。

QVariantMapsはCBORとは異なり、キーが文字列であるため、QCborMap からQVariantMap への変換には、キー値の「文字列化」という手順が含まれます。詳細については、QCborMap::toJsonObject()を参照してください。

また、QVariant への変換は完全にロスレスではありません。詳細については、QCborValue::toVariant() のドキュメントを参照してください。

fromVariantMap()、toVariantHash()、toJsonObject()、QCborValue::toVariant()、およびQCborArray::toVariantList()も参照してください 。

QCborValue QCborMap::value(const QCborValue &key) const

このマップ内のキー `key` に対応する要素 `QCborValue ` が存在する場合、それを返します。

マップにキー `key` が含まれていない場合、この関数は未定義の値を含む `QCborValue ` を返します。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップにkey と等しいキーが複数存在する場合、この関数がどのキーを返すかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、これらは許可されておらず、重複するキーが存在することは、送信側に問題があることを示唆しています。

value(qint64)、value(QLatin1StringView)、value(constQString &)

operator[](const QCborValue &)、find(const QCborValue &)、constFind(const QCborValue &)、remove(const QCborValue &)、およびcontains(const QCborValue &)も参照してください。

QCborValue QCborMap::value(qint64 key) const

このマップ内のキー `key` に対応する `QCborValue ` 要素が存在する場合、それを返します。CBOR では、整数のキーを使用することを推奨しています。これは、整数のキーの方が占有するスペースが少なく、エンコードおよびデコードが簡単であるためです。

マップにキー `key` が含まれていない場合、この関数は未定義の値を含む `QCborValue ` を返します。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップにkey と等しいキーが複数含まれている場合、関数の戻り値がどのキーを参照するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複するキーは許可されておらず、重複キーが存在することは送信側に問題があることを示唆しています。

value(QLatin1StringView), value(constQString &), value(constQCborValue &)

operator[](qint64)、find(qint64)、constFind(qint64)、remove(qint64)、およびcontains(qint64)も参照してください 。

QCborValue QCborMap::value(QLatin1StringView key) const

このマップ内のキー `key` に対応する `QCborValue ` 要素が存在する場合、それを返します。

マップにキー `key` が含まれていない場合、この関数は未定義の値を含む `QCborValue ` を返します。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップにkey と等しいキーが複数存在する場合、この関数がどのキーを返すかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、これらは許可されておらず、重複するキーが存在することは、送信側に問題があることを示唆しています。

value(qint64)、value(constQString &)、value(constQCborValue &)

operator[](QLatin1StringView)、find(QLatin1StringView)、constFind(QLatin1StringView)、remove(QLatin1StringView)、およびcontains(QLatin1StringView)も参照してください 。

QCborValue QCborMap::value(const QString &key) const

このマップ内のキー `key` に対応する `QCborValue ` 要素が存在する場合、それを返します。

マップにキー `key` が含まれていない場合、この関数は未定義の値を含む `QCborValue ` を返します。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップにkey と等しいキーが複数含まれている場合、この関数がどのキーを返すかは未定義である。QCborMap では重複するキーの挿入は許可されていないが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能である。通常、これらは許可されておらず、重複するキーが存在することは、送信側に問題があることを示している。

value(qint64), value(QLatin1StringView), value(constQCborValue &)

operator[](const QString &)、find(const QString &)、constFind(const QString &)、remove(const QString &)、およびcontains(const QString &)も参照してください 。

[noexcept, since 6.10] QCborMap &QCborMap::operator=(QCborMap &&other)

移動代入演算子。

移動元のオブジェクト `other ` は、有効ではあるが未指定の状態になります。

この関数は Qt 6.10 で導入されました。

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

このオブジェクトの内容を `other` のコピーに置き換え、その後、このオブジェクトへの参照を返します。

QCborValueRef QCborMap::operator[](qint64 key)

このマップ内のキー「key 」に対応する値への QCborValueRef を返します。CBOR では、整数のキーを使用することを推奨しています。これは、整数のキーの方が占有するスペースが少なく、エンコードおよびデコードが簡単だからです。

QCborValueRef の API はQCborValue と完全に同じですが、1 つの重要な違いがあります。それは、新しい値を割り当てると、このマップがその新しい値で更新されるという点です。

マップにkey と等しいキーが存在しなかった場合、そのキーが挿入され、この関数は新しい値への参照を返します。この新しい値は、値が未定義の `QCborValue ` となります。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップにkey に等しいキーが複数存在する場合、戻り値がどのキーを参照するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複するキーは許可されておらず、重複するキーが存在することは、送信側に問題があることを示している場合がほとんどです。

関連項目： value(qint64)、find(qint64)、contains(qint64)、remove(qint64)、operator[](QLatin1StringView)、operator[](const QString &)、operator[](const QCborValue &)。

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

このマップ内で、キー `key` に対応する `QCborValue ` 要素が存在する場合、それを返します。

マップにキー `key` が含まれていない場合、この関数は未定義の値を含む `QCborValue ` を返します。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップにkey と等しいキーが複数存在する場合、この関数がどのキーを返すかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複するキーは許可されておらず、重複キーの存在は送信側に問題があることを示唆しています。

operator[](qint64)、operator[](QLatin1StringView)、operator[](const QCborOperator[] &)

関連項目： value(const QCborValue &)、find(const QCborValue &)、constFind(const QCborValue &)、remove(const QCborValue &)、およびcontains(const QCborValue &)。

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

このマップ内のキー `key` に対応する要素 `QCborValue ` が存在する場合、それを返します。CBORでは、整数キーを使用することを推奨しています。これは、整数キーの方が占有するスペースが少なく、エンコードおよびデコードが簡単だからです。

マップにキー `key` が含まれていない場合、この関数は未定義の値を含む `QCborValue ` を返します。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップにkey に等しいキーが複数存在する場合、この関数がどのキーを返すかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、これらは許可されておらず、重複するキーが存在することは、送信側に問題があることを示唆しています。

operator[](QLatin1StringView), operator[](constQString &), operator[](const QCborOperator[] &)

value(qint64)、find(qint64)、constFind(qint64)、remove(qint64)、およびcontains(qint64)も参照してください 。

QCborValueRef QCborMap::operator[](QLatin1StringView key)

このマップ内の、キー「key 」に対応する値への QCborValueRef を返します。

QCborValueRef の API はQCborValue と全く同じですが、1 つの重要な違いがあります。それは、新しい値を割り当てると、このマップがその新しい値で更新されるという点です。

マップにkey と等しいキーが存在しなかった場合、そのキーが挿入され、この関数は新しい値への参照を返します。この新しい値は、値が未定義のQCborValue となります。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップにkey と等しいキーが複数存在する場合、戻り値がどのキーを参照するかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複するキーは許可されておらず、重複キーが存在することは、送信側に問題があることを示唆しています。

value(QLatin1StringView)、find(QLatin1StringView)、contains(QLatin1StringView)、remove(QLatin1StringView)、operator[](qint64)、operator[](const QString &)、およびoperator[](const QCborValue &)も参照してください 。

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

このマップ内の、キー「key 」に対応する値への QCborValueRef を返します。

QCborValueRef の API はQCborValue と全く同じですが、1 つの重要な違いがあります。それは、新しい値を割り当てると、このマップがその新しい値で更新されるという点です。

マップにkey と等しいキーが存在しなかった場合、そのキーが挿入され、この関数は新しい値への参照を返します。この新しい値は、値が未定義の `QCborValue ` となります。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップ内にkey と等しいキーが複数存在する場合、戻り値がどのキーを参照するかは未定義となります。QCborMap は重複するキーの挿入を許可していませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複キーは許可されておらず、重複キーが存在することは、送信側に問題があることを示している場合がほとんどです。

value(const QCborValue &)、find(const QCborValue &)、contains(const QCborValue &)、remove(const QCborValue &)、operator[](qint64)、operator[](QLatin1StringView)、およびoperator[](const QString &)も参照してください 。

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

このマップ内の、キー「key 」に対応する値への QCborValueRef を返します。

QCborValueRef はQCborValue とまったく同じ API を持っていますが、1 つの重要な違いがあります。それは、新しい値を割り当てると、このマップがその新しい値で更新されるという点です。

マップにkey と等しいキーが存在しなかった場合、そのキーが挿入され、この関数は新しい値への参照を返します。この新しい値は、値が未定義の `QCborValue ` となります。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマップされていた場合とを区別することはできません。

マップにkey に等しいキーが複数存在する場合、戻り値がどのキーを参照するかは未定義となります。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複キーは許可されておらず、重複キーが存在することは、送信側に問題があることを示唆しています。

関連項目: value(const QString &)、find(const QString &)、contains(const QString &)、remove(const QString &)、operator[](qint64)、operator[](QLatin1StringView)、およびoperator[](const QCborValue &)。

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

このマップ内のキー `key` に対応する要素 `QCborValue ` が存在する場合、それを返します。

マップにキー `key` が含まれていない場合、この関数は未定義の値を含む `QCborValue ` を返します。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップに「key 」と等しいキーが複数含まれている場合、この関数がどのキーを返すかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含む CBOR ストリームをデコードすることで、そのようなマップを作成することは可能です。通常、これらは許可されておらず、重複するキーが存在することは、送信側に問題があることを示唆しています。

operator[](qint64)、operator[](constQString &)、operator[](const QCborOperator[] &)

value(QLatin1StringView)、find(QLatin1StringView)、constFind(QLatin1StringView)、remove(QLatin1StringView)、およびcontains(QLatin1StringView)も参照してください 。

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

このマップ内のキー `key` に対応する `QCborValue ` 要素が存在する場合、それを返します。

マップにキー `key` が含まれていない場合、この関数は未定義の値を含む `QCborValue ` を返します。そのため、この関数では、キーが存在しなかった場合と、キーが未定義の値にマッピングされていた場合とを区別することはできません。

マップにkey と等しいキーが複数存在する場合、本関数がどのキーを返すかは未定義です。QCborMap では重複するキーの挿入は許可されていませんが、それらを含むCBORストリームをデコードすることで、そのようなマップを作成することは可能です。通常、重複するキーは許可されておらず、重複キーの存在は送信側で問題が発生していることを示唆しています。

operator[](qint64)、operator[](QLatin1StringView)、operator[](const QCborOperator[] &)

value(const QString &)、find(const QString &)、constFind(const QString &)、remove(const QString &)、およびcontains(const QString &)も参照してください 。