QCborArray Class

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

value を配列のi の位置に挿入する。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)

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

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 に変換することで、QCborValues を QCborArrays のアイテムとして、またQCborMap のキーやマップされた型として使用することができます。配列を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 をQCborValue::toVariant() で再帰的に変換し、変換後の項目からなる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()も参照の こと。