QCborArray Class

メンバ関数ドキュメント

この配列のi の位置にある配列にvalue を挿入する。i が -1 の場合、エントリは配列に追加される。i が配列の事前サイズより大きい場合、配列に無効なエントリを追加します。

at()、operator[]()、first()、last()、prepend()、append()、removeAt()、takeAt()、extract()も参照のこと 。

イテレータit が示す位置の配列から値を取り出し、取り出した値を返します。

insert()、erase()、takeAt() およびremoveAt()も参照 。

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

at()、operator[]()、first()、last()、insert()、append()、removeAt()、takeAt()も 参照のこと。

配列に既に含まれている他のすべての要素の後に、value を追加する。

at()、operator[]()、first()、last()、insert()、prepend()、removeAt()、takeAt()も参照 。

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

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

erase()、removeAt()、prepend() およびappend()も参照 。

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

insert()、removeAt()、takeAt()、takeFirst()、takeLast()も参照 。

[noexcept] QCborArray::QCborArray()

空の QCborArray を構築します。

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

この QCborArray を、args にある C++ 中括弧で囲まれたリストから初期化します：

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

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

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

[noexcept] QCborArray::~QCborArray()

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

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 を使用する汎用コードとの互換性のために用意されています。

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

isEmpty() およびsize()も参照 。

QCborArray::iterator QCborArray::end()

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

begin() およびconstEnd()も参照 。

QCborArray::const_iterator QCborArray::end() const

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

constBegin() およびconstEnd()も参照 。

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)

QCborValue::fromJson() を使用して、array 配列で見つかったすべての JSON アイテムを 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()も参照 。

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

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 に変換すると、QCborArrays のアイテムとして、またQCborMap のキーやマップされた型としてなど、QCborValues を使用できるすべてのコンテキストで使用できます。配列をQCborValue に変換すると、QCborValue::toCbor() にアクセスできます。

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

QJsonArray QCborArray::toJsonArray() const

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

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

fromJsonArray()、QCborValue::toJsonValue()、QCborMap::toJsonObject()、toVariantList()も参照 。

QVariantList QCborArray::toVariantList() const

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

QVariant への変換は完全なロスレスではない。詳しくはQCborValue::toVariant() のドキュメントを参照されたい。

fromVariantList()、fromStringList()、toJsonArray()、QCborValue::toVariant()、QCborMap::toVariantMap()も参照 。

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

この配列と同じ要素を含む新しいQCborArray を返し、さらに最後の要素としてv を追加する。

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] QCborArray &QCborArray::operator=(const QCborArray &other)

この配列の内容をother にある内容で置換し、このオブジェクトへの参照を返します。

QCborValueRef QCborArray::operator[](qsizetype i)

配列の位置i にあるQCborValue 要素への参照を返します。配列の終端を超えるインデックスを指定すると、指定したインデックスの位置にエントリが入るまで、未定義のエントリで満たされながら配列が拡張されます。

QCborValueRef の API はQCborValue とまったく同じですが、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()も参照の こと。