QCborArray Class

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

[noexcept] QCborArray::QCborArray()

空のQCborArrayを生成します。

QCborArray::QCborArray(std::initializer_list<QCborValue> args)

args にある C++ の中括弧で囲まれたリストから、この QCborArray を初期化します。以下の例のように行います。

QCborArray a = { null, 0, 1, 1.5, 2, "Hello", QByteArray("World") };

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

other の内容をこのオブジェクトにコピーします。

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

移動コンストラクタ。

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

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

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

[noexcept] QCborArray::~QCborArray()

この `QCborArray ` を破棄し、関連するリソースをすべて解放します。

value を、配列にすでに含まれている可能性のある他のすべての要素の後に追加します。

at()、operator[]()、first()、last()、insert()、prepend()、removeAt()、およびtakeAt()も参照してください 。

QCborValue QCborArray::at(qsizetype i) const

配列のi の位置にあるQCborValue 要素を返します。

配列の要素数がi 個未満の場合、この関数は未定義の値を含むQCborValue を返します。そのため、この関数では、配列の要素数が不足している場合と、配列の先頭が未定義の値である場合とを区別することはできません。

関連項目： operator[]()、first()、last()、insert()、prepend()、append()、removeAt()、およびtakeAt()。

QCborArray::iterator QCborArray::begin()

この配列の最初の要素を指す配列イテレータを返します。配列が空の場合、この関数は `end()` と同じ値を返します。

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

QCborArray::const_iterator QCborArray::begin() const

この配列の最初の要素を指す配列イテレータを返します。配列が空の場合、この関数は `end()` と同じ値を返します。

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

QCborArray::const_iterator QCborArray::cbegin() const

この配列の最初の要素を指す配列イテレータを返します。配列が空の場合、この関数はend()と同じ値を返します。

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

QCborArray::const_iterator QCborArray::cend() const

この配列の最後の要素の直後を指す配列イテレータを返します。

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

void QCborArray::clear()

この配列を空にします。

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

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

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

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

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

QCborArray::const_iterator QCborArray::constBegin() const

この配列の最初の要素を指す配列イテレータを返します。配列が空の場合、この関数は `end()` と同じ値を返します。

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

QCborArray::const_iterator QCborArray::constEnd() const

この配列の最後の要素の直後を指す配列イテレータを返します。

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

bool QCborArray::contains(const QCborValue &value) const

この配列に、value と等しい要素が含まれている場合、true を返します。

bool QCborArray::empty() const

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

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

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

QCborArray::iterator QCborArray::end()

この配列の最後の要素の直後を指す配列イテレータを返します。

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

QCborArray::const_iterator QCborArray::end() const

この配列の最後の要素の直後を指す配列イテレータを返します。

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

配列イテレータ `it ` が指す要素をこの配列から削除し、次の要素（it がかつて占めていた配列内の位置と同じ位置にある要素）へのイテレータを返します。

insert()、removeAt()、takeAt()、takeFirst()、およびtakeLast()も参照してください 。

イテレータ `it ` が示す位置にある配列から値を抽出し、抽出された値を返します。

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

QCborValueRef QCborArray::first()

この配列の最初のQCborValue への参照を返します。配列は空であってはなりません。

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

関連項目： operator[]()、at()、last()、insert()、prepend()、append()、removeAt()、およびtakeAt()。

QCborValue QCborArray::first() const

この配列の最初のQCborValue を返します。

配列が空の場合、この関数は未定義の値を含むQCborValue を返します。そのため、この関数では、配列の要素数が不足している場合と、配列の末尾が未定義の値で終わっている場合とを区別することはできません。

関連項目: operator[](),at(),last(),insert(),prepend(),append(),removeAt(), およびtakeAt().

[static] QCborArray QCborArray::fromJsonArray(const QJsonArray &array)

array 配列内に見つかったすべてのJSON項目を、QCborValue::fromJson() を使用してCBORに変換し、それらの要素で構成されるCBOR配列を返します。

CBORの型体系はJSONのスーパーセットであるため、この変換はロスレスです。さらに、この関数が返す配列は、toJsonArray() を使用することで、元のarray に戻すことができます。

toJsonArray()、toVariantList()、QCborValue::fromJsonValue()、およびQCborMap::fromJsonObject()も参照してください 。

[static noexcept, since 6.3] QCborArray QCborArray::fromJsonArray(QJsonArray &&array)

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

[static] QCborArray QCborArray::fromStringList(const QStringList &list)

list リストに含まれるすべての文字列を格納したQCborArray を返します。

fromVariantList() およびfromJsonArray()も参照してください 。

[static] QCborArray QCborArray::fromVariantList(const QVariantList &list)

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

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

toVariantList()、fromStringList()、fromJsonArray()、およびQCborMap::fromVariantMap()も参照してください 。

value を、この配列のi の位置に挿入します。i が-1の場合、その要素は配列の末尾に追加されます。i が配列の以前のサイズよりも大きい場合、配列の先頭と末尾に無効な要素を埋め込みます。

関連項目： at()、operator[]()、first()、last()、prepend()、append()、removeAt()、takeAt()、およびextract()。

この配列の要素before の前にvalue を挿入し、挿入されたばかりの要素を指す配列イテレータを返します。

erase()、removeAt()、prepend()、およびappend()も参照してください 。

bool QCborArray::isEmpty() const

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

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

QCborValueRef QCborArray::last()

この配列の最後のQCborValue への参照を返します。配列は空であってはなりません。

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

関連項目： operator[]()、at()、first()、insert()、prepend()、append()、removeAt()、およびtakeAt()。

QCborValue QCborArray::last() const

この配列の最後のQCborValue を返します。

配列が空の場合、この関数は未定義の値を含むQCborValue を返します。そのため、この関数では、配列の要素数が不足している場合と、配列の末尾が未定義の値で終わっている場合とを区別することはできません。

operator[]()、at()、first()、insert()、prepend()、append()、removeAt()、およびtakeAt()も参照してください 。

void QCborArray::pop_back()

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

この配列の最後の要素を削除します。削除を行う前に、配列が空であってはなりません。

removeLast()、takeLast()、pop_front()、push_back()、append()、およびinsert()も参照してください 。

void QCborArray::pop_front()

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

この配列の先頭要素を削除します。削除を行う前に、配列は空であってはなりません。

removeFirst()、takeFirst()、pop_back()、push_front()、prepend()、およびinsert()も参照してください 。

配列にすでに含まれている他の要素の前に、「value 」を追加します。

at()、operator[]()、first()、last()、insert()、append()、removeAt()、およびtakeAt()も参照してください 。

void QCborArray::push_back(const QCborValue &t)

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

要素 `t ` をこの配列に追加します。

append()、push_front()、pop_back()、prepend()、およびinsert()も参照してください 。

void QCborArray::push_front(const QCborValue &t)

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

この配列の先頭に要素 `t ` を追加します。

prepend()、push_back()、pop_front()、append()、およびinsert()も参照してください 。

void QCborArray::removeAt(qsizetype i)

配列のi の位置にある要素を削除します。削除を行う前に、配列の要素数がi 以上である必要があります。

関連項目： takeAt()、removeFirst()、removeLast()、at()、operator[]()、insert()、prepend()、およびappend()。

void QCborArray::removeFirst()

配列の最初の要素を削除し、2番目の要素を最初の要素にします。この呼び出しを行う前に、配列が空であってはなりません。

関連項目： removeAt()、takeFirst()、removeLast()、at()、operator[]()、insert()、prepend()、およびappend()。

void QCborArray::removeLast()

配列の最後の要素を削除します。この呼び出しを行う前に、配列が空であってはなりません。

関連項目： removeAt()、takeLast()、removeFirst()、at()、operator[]()、insert()、prepend()、およびappend()。

[noexcept] qsizetype QCborArray::size() const

この配列のサイズを返します。

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

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

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

QCborValue QCborArray::takeAt(qsizetype i)

配列のi の位置にある要素を削除し、その要素を返します。削除を行う前に、配列の要素数がi 以上である必要があります。

関連項目: removeAt(),removeFirst(),removeLast(),at(),operator[](),insert(),prepend(), およびappend().

QCborValue QCborArray::takeFirst()

配列の最初の要素を削除してそれを返し、2番目の要素が最初の要素になります。この呼び出しを行う前に、配列が空であってはなりません。

関連項目： takeAt()、removeFirst()、removeLast()、at()、operator[]()、insert()、prepend()、およびappend()。

QCborValue QCborArray::takeLast()

配列の最後の要素を削除し、それを返します。この呼び出しを行う前に、配列が空であってはなりません。

関連項目： takeAt()、removeLast()、removeFirst()、at()、operator[]()、insert()、prepend()、append()。

QCborValue QCborArray::toCborValue() const

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

QCborArray をQCborValue に変換することで、QCborValuesが使用可能なあらゆるコンテキスト（QCborArraysの要素や、QCborMap のキーおよびマップされた型など）で利用できるようになります。配列をQCborValue に変換することで、QCborValue::toCbor()へのアクセスが可能になります。

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

QJsonArray QCborArray::toJsonArray() const

この配列内のすべてのQCborValue 要素を、QCborValue::toJsonValue() を使用して再帰的にJSONに変換し、それらの要素で構成される対応するQJsonArray を返します。

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

fromJsonArray()、QCborValue::toJsonValue()、QCborMap::toJsonObject()、およびtoVariantList()も参照してください 。

QVariantList QCborArray::toVariantList() const

この配列内の各QCborValue を、QCborValue::toVariant() を使用して再帰的に変換し、変換された項目で構成されるQVariantList を返します。

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

fromVariantList()、fromStringList()、toJsonArray()、QCborValue::toVariant()、およびQCborMap::toVariantMap()も参照してください 。

QCborArray QCborArray::operator+(const QCborValue &v) const

この配列と同じ要素に加え、v を最後の要素として追加した新しいQCborArray を返します。

operator+=()、operator<<()、およびappend()も参照してください 。

QCborArray &QCborArray::operator+=(const QCborValue &v)

この配列に `v ` を追加し、この配列への参照を返します。

append()、insert()、operator+()、およびoperator<<()も参照してください 。

QCborArray &QCborArray::operator<<(const QCborValue &v)

この配列に `v ` を追加し、この配列への参照を返します。

append()、insert()、operator+()、およびoperator+=()も参照してください 。

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

移動代入演算子。

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

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

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

この配列の内容を `other` に格納されている内容に置き換え、その後、このオブジェクトへの参照を返します。

QCborValueRef QCborArray::operator[](qsizetype i)

配列のi の位置にあるQCborValue 要素への参照を返します。配列の末尾を超えるインデックスを指定した場合、指定されたインデックスに要素が存在するようになるまで、配列が拡張され、未定義のエントリで埋められます。

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

関連項目： at()、first()、last()、insert()、prepend()、append()、removeAt()、およびtakeAt()。

const QCborValue QCborArray::operator[](qsizetype i) const

配列のi の位置にあるQCborValue 要素を返します。

配列の要素数がi 個未満の場合、この関数は未定義の値を含むQCborValue を返します。そのため、この関数では、配列の要素数が不足している場合と、配列のi の位置に未定義の値が含まれている場合とを区別することはできません。

関連項目： at()、first()、last()、insert()、prepend()、append()、removeAt()、およびtakeAt()。