QCborArray Class

Dokumentation der Member-Funktionen

[noexcept] QCborArray::QCborArray()

Erstellt ein leeres QCborArray.

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

Initialisiert dieses QCborArray anhand der in geschweiften Klammern eingeschlossenen C++-Liste unter args, wie im folgenden Beispiel gezeigt:

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

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

Kopiert den Inhalt von „ other “ in dieses Objekt.

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

Move-Konstruktor.

Das Objekt, aus dem verschoben wird ( other ), wird in den Zustand der Standardkonstruktion versetzt.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch QCborArray::QCborArray().

[noexcept] QCborArray::~QCborArray()

Löscht dieses „ QCborArray “ und gibt alle damit verbundenen Ressourcen frei.

Fügt value am Ende des Arrays hinter allen anderen Elementen ein, die es möglicherweise bereits enthält.

Siehe auch at(), operator[](), first(), last(), insert(), prepend(), removeAt() und takeAt().

QCborValue QCborArray::at(qsizetype i) const

Gibt das Element „ QCborValue “ an der Position „ i “ im Array zurück.

Ist das Array kleiner als i Elemente, gibt diese Funktion ein QCborValue zurück, das einen undefinierten Wert enthält. Aus diesem Grund lässt sich mit dieser Funktion nicht unterscheiden, ob das Array nicht groß genug ist oder ob es mit einem undefinierten Wert beginnt.

Siehe auch operator[](), first(), last(), insert(), prepend(), append(), removeAt() und takeAt().

QCborArray::iterator QCborArray::begin()

Gibt einen Array-Iterator zurück, der auf das erste Element dieses Arrays verweist. Ist das Array leer, gibt diese Funktion dasselbe Ergebnis zurück wie end().

Siehe auch constBegin() und end().

QCborArray::const_iterator QCborArray::begin() const

Gibt einen Array-Iterator zurück, der auf das erste Element dieses Arrays verweist. Ist das Array leer, gibt diese Funktion dasselbe Ergebnis zurück wie end().

Siehe auch constBegin() und constEnd().

QCborArray::const_iterator QCborArray::cbegin() const

Gibt einen Array-Iterator zurück, der auf das erste Element dieses Arrays verweist. Ist das Array leer, gibt diese Funktion dasselbe Ergebnis zurück wie end().

Siehe auch constBegin() und constEnd().

QCborArray::const_iterator QCborArray::cend() const

Gibt einen Array-Iterator zurück, der auf die Position unmittelbar nach dem letzten Element dieses Arrays verweist.

Siehe auch constBegin() und constEnd().

void QCborArray::clear()

Leert dieses Array.

Siehe auch ` isEmpty()`.

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

Vergleicht dieses Array mit ` other`, wobei jedes Element nacheinander verglichen wird, und gibt eine Ganzzahl zurück, die angibt, ob dieses Array vor (bei negativem Ergebnis) oder nach ` other ` (bei positivem Ergebnis) sortiert werden sollte. Wenn diese Funktion 0 zurückgibt, sind die beiden Arrays gleich und enthalten dieselben Elemente.

Weitere Informationen zur CBOR-Sortierreihenfolge finden Sie unter ` QCborValue::compare()`.

Siehe auch QCborValue::compare(), QCborMap::compare() und operator==().

QCborArray::const_iterator QCborArray::constBegin() const

Gibt einen Array-Iterator zurück, der auf das erste Element dieses Arrays verweist. Ist das Array leer, gibt diese Funktion dasselbe Ergebnis zurück wie end().

Siehe auch begin() und constEnd().

QCborArray::const_iterator QCborArray::constEnd() const

Gibt einen Array-Iterator zurück, der auf die Position unmittelbar nach dem letzten Element dieses Arrays verweist.

Siehe auch ` constBegin()` und ` end()`.

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

Gibt „true“ zurück, wenn dieses Array ein Element enthält, das mit „ value “ übereinstimmt.

bool QCborArray::empty() const

Synonym für ` isEmpty()`. Diese Funktion wird aus Kompatibilitätsgründen für generischen Code bereitgestellt, der die Standardbibliotheks-API nutzt.

Gibt „true“ zurück, wenn dieses Array leer ist (size() == 0).

Siehe auch „ isEmpty()“ und „ size()“.

QCborArray::iterator QCborArray::end()

Gibt einen Array-Iterator zurück, der auf die Position unmittelbar nach dem letzten Element dieses Arrays verweist.

Siehe auch begin() und constEnd().

QCborArray::const_iterator QCborArray::end() const

Gibt einen Array-Iterator zurück, der auf die Position unmittelbar nach dem letzten Element dieses Arrays verweist.

Siehe auch ` constBegin()` und ` constEnd()`.

Entfernt das Element, auf das der Array-Iterator it verweist, aus diesem Array und gibt anschließend einen Iterator auf das nächste Element zurück (dasjenige, das nun dieselbe Position im Array einnimmt, die zuvor von it eingenommen wurde).

Siehe auch insert(), removeAt(), takeAt(), takeFirst() und takeLast().

Extrahiert einen Wert aus dem Array an der durch den Iterator it angegebenen Position und gibt den so extrahierten Wert zurück.

Siehe auch insert(), erase(), takeAt() und removeAt().

QCborValueRef QCborArray::first()

Gibt eine Referenz auf das erste Element „ QCborValue “ dieses Arrays zurück. Das Array darf nicht leer sein.

QCborValueRef verfügt über genau dieselbe API wie QCborValue, mit einem wichtigen Unterschied: Wenn Sie ihm neue Werte zuweisen, wird dieses Array mit diesen neuen Werten aktualisiert.

Siehe auch „ operator[]()“, „ at()“, „ last()“, „ insert()“, „ prepend()“, „ append()“, „ removeAt()“ und „ takeAt()“.

QCborValue QCborArray::first() const

Gibt das erste ` QCborValue ` dieses Arrays zurück.

Ist das Array leer, gibt diese Funktion ein ` QCborValue ` zurück, das einen undefinierten Wert enthält. Aus diesem Grund lässt sich mit dieser Funktion nicht unterscheiden, ob das Array nicht groß genug ist oder ob es mit einem undefinierten Wert endet.

Siehe auch operator[](), at(), last(), insert(), prepend(), append(), removeAt() und takeAt().

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

Konvertiert alle im Array „ array “ gefundenen JSON-Elemente mithilfe von QCborValue::fromJson() in CBOR und gibt das aus diesen Elementen bestehende CBOR-Array zurück.

Diese Konvertierung ist verlustfrei, da das CBOR-Typsystem eine Obermenge des JSON-Typsystems ist. Darüber hinaus kann das von dieser Funktion zurückgegebene Array mithilfe von ` toJsonArray()` wieder in das ursprüngliche ` array ` zurückkonvertiert werden.

Siehe auch „ toJsonArray()“, „ toVariantList()“, „ QCborValue::fromJsonValue()“ und „ QCborMap::fromJsonObject()“.

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

Diese Funktion wurde in Qt 6.3 eingeführt.

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

Gibt ein ` QCborArray ` zurück, das alle Zeichenfolgen enthält, die in der Liste ` list ` gefunden wurden.

Siehe auch „ fromVariantList()“ und „ fromJsonArray()“.

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

Konvertiert alle Elemente im „ list “ mithilfe von „ QCborValue::fromVariant()“ in das CBOR-Format und gibt das aus diesen Elementen bestehende Array zurück.

Die Konvertierung aus „ QVariant “ erfolgt nicht vollständig verlustfrei. Weitere Informationen finden Sie in der Dokumentation zu „ QCborValue::fromVariant()“.

Siehe auch „ toVariantList()“, „ fromStringList()“, „ fromJsonArray()“ und „ QCborMap::fromVariantMap()“.

Fügt value an der Position i in dieses Array ein. Ist i gleich -1, wird der Eintrag an das Ende des Arrays angehängt. Füllt das Array mit ungültigen Einträgen auf, wenn i größer ist als die bisherige Größe des Arrays.

Siehe auch at(), operator[](), first(), last(), prepend(), append(), removeAt(), takeAt() und extract().

Fügt value in dieses Array vor dem Element before ein und gibt einen Array-Iterator zurück, der auf das gerade eingefügte Element verweist.

Siehe auch erase(), removeAt(), prepend() und append().

bool QCborArray::isEmpty() const

Gibt „true“ zurück, wenn dieses „ QCborArray “ leer ist (d. h., wenn „ size()“ den Wert 0 hat).

Siehe auch size() und clear().

QCborValueRef QCborArray::last()

Gibt eine Referenz auf das letzte „ QCborValue “ dieses Arrays zurück. Das Array darf nicht leer sein.

QCborValueRef verfügt über genau dieselbe API wie QCborValue, mit einem wichtigen Unterschied: Wenn Sie ihm neue Werte zuweisen, wird dieses Array mit diesen neuen Werten aktualisiert.

Siehe auch „ operator[]()“, „ at()“, „ first()“, „ insert()“, „ prepend()“, „ append()“, „ removeAt()“ und „ takeAt()“.

QCborValue QCborArray::last() const

Gibt das letzte „ QCborValue “ dieses Arrays zurück.

Ist das Array leer, gibt diese Funktion einen ` QCborValue ` zurück, der einen undefinierten Wert enthält. Aus diesem Grund lässt sich mit dieser Funktion nicht unterscheiden, ob das Array nicht groß genug ist oder ob es mit einem undefinierten Wert endet.

Siehe auch operator[](), at(), first(), insert(), prepend(), append(), removeAt() und takeAt().

void QCborArray::pop_back()

Synonym für ` removeLast()`. Diese Funktion wird aus Gründen der Kompatibilität mit generischem Code bereitgestellt, der die Standardbibliotheks-API nutzt.

Entfernt das letzte Element dieses Arrays. Das Array darf vor dem Entfernen nicht leer sein

Siehe auch „ removeLast()“, „ takeLast()“, „ pop_front()“, „ push_back()“, „ append()“ und „ insert()“.

void QCborArray::pop_front()

Synonym für ` removeFirst()`. Diese Funktion wird aus Kompatibilitätsgründen für generischen Code bereitgestellt, der die Standardbibliotheks-API nutzt.

Entfernt das erste Element dieses Arrays. Das Array darf vor dem Entfernen nicht leer sein

Siehe auch „ removeFirst()“, „ takeFirst()“, „ pop_back()“, „ push_front()“, „ prepend()“ und „ insert()“.

Fügt „ value “ am Anfang des Arrays vor allen anderen Elementen ein, die es möglicherweise bereits enthält.

Siehe auch „ at()“, „ operator[]()“, „ first()“, „ last()“, „ insert()“, „ append()“, „ removeAt()“ und „ takeAt()“.

void QCborArray::push_back(const QCborValue &t)

Synonym für ` append()`. Diese Funktion wird aus Kompatibilitätsgründen für generischen Code bereitgestellt, der die Standardbibliothek-API nutzt.

Fügt das Element ` t ` an dieses Array an.

Siehe auch „ append()“, „ push_front()“, „ pop_back()“, „ prepend()“ und „ insert()“.

void QCborArray::push_front(const QCborValue &t)

Synonym für ` prepend()`. Diese Funktion dient der Kompatibilität mit generischem Code, der die Standardbibliotheks-API verwendet.

Fügt das Element ` t ` an den Anfang dieses Arrays ein.

Siehe auch „ prepend()“, „ push_back()“, „ pop_front()“, „ append()“ und „ insert()“.

void QCborArray::removeAt(qsizetype i)

Entfernt das Element an der Position i aus dem Array. Das Array muss vor dem Entfernen mehr als i Elemente enthalten.

Siehe auch takeAt(), removeFirst(), removeLast(), at(), operator[](), insert(), prepend() und append().

void QCborArray::removeFirst()

Entfernt das erste Element des Arrays, wodurch das zweite Element zum ersten wird. Das Array darf vor diesem Aufruf nicht leer sein.

Siehe auch removeAt(), takeFirst(), removeLast(), at(), operator[](), insert(), prepend() und append().

void QCborArray::removeLast()

Entfernt das letzte Element aus dem Array. Das Array darf vor diesem Aufruf nicht leer sein.

Siehe auch removeAt(), takeLast(), removeFirst(), at(), operator[](), insert(), prepend() und append().

[noexcept] qsizetype QCborArray::size() const

Gibt die Größe dieses Arrays zurück.

Siehe auch ` isEmpty()`.

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

Tauscht dieses Array mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QCborValue QCborArray::takeAt(qsizetype i)

Entfernt das Element an der Position i aus dem Array und gibt es zurück. Das Array muss vor dem Entfernen mehr als i Elemente enthalten.

Siehe auch removeAt(), removeFirst(), removeLast(), at(), operator[](), insert(), prepend() und append().

QCborValue QCborArray::takeFirst()

Entfernt das erste Element aus dem Array und gibt es zurück, wodurch das zweite Element zum ersten wird. Das Array darf vor diesem Aufruf nicht leer sein.

Siehe auch takeAt(), removeFirst(), removeLast(), at(), operator[](), insert(), prepend() und append().

QCborValue QCborArray::takeLast()

Entfernt das letzte Element aus dem Array und gibt es zurück. Das Array darf vor diesem Aufruf nicht leer sein.

Siehe auch takeAt(), removeLast(), removeFirst(), at(), operator[](), insert(), prepend() und append().

QCborValue QCborArray::toCborValue() const

Erstellt explizit ein ` QCborValue `-Objekt, das dieses Array repräsentiert. Diese Funktion ist in der Regel nicht erforderlich, da ` QCborValue ` über einen Konstruktor für ` QCborArray` verfügt, sodass die Konvertierung implizit erfolgt.

Durch die Konvertierung von ` QCborArray ` in ` QCborValue ` kann es in jedem Kontext verwendet werden, in dem `QCborValues` verwendet werden können, einschließlich als Elemente in `QCborArrays` sowie als Schlüssel und zugeordnete Typen in ` QCborMap`. Die Konvertierung eines Arrays in ` QCborValue ` ermöglicht den Zugriff auf ` QCborValue::toCbor()`.

Siehe auch „ QCborValue::QCborValue“ (const QCborArray &).

QJsonArray QCborArray::toJsonArray() const

Konvertiert rekursiv jedes „ QCborValue “-Element in diesem Array mithilfe von „ QCborValue::toJsonValue()“ in JSON und gibt das entsprechende „ QJsonArray “ zurück, das aus diesen Elementen zusammengesetzt ist.

Bitte beachten Sie, dass CBOR einen umfangreicheren und breiteren Typensatz als JSON enthält, sodass bei dieser Konvertierung möglicherweise einige Informationen verloren gehen. Weitere Details dazu, welche Konvertierungen angewendet werden, finden Sie unter QCborValue::toJsonValue().

Siehe auch fromJsonArray(), QCborValue::toJsonValue(), QCborMap::toJsonObject() und toVariantList().

QVariantList QCborArray::toVariantList() const

Konvertiert jedes Element des Typs „ QCborValue “ in diesem Array rekursiv mithilfe von „ QCborValue::toVariant()“ und gibt das „ QVariantList “ zurück, das aus den konvertierten Elementen besteht.

Die Konvertierung in ` QVariant ` ist nicht vollständig verlustfrei. Weitere Informationen finden Sie in der Dokumentation zu ` QCborValue::toVariant()`.

Siehe auch „ fromVariantList()“, „ fromStringList()“, „ toJsonArray()“, „ QCborValue::toVariant()“ und „ QCborMap::toVariantMap()“.

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

Gibt ein neues ` QCborArray ` zurück, das dieselben Elemente wie dieses Array enthält, ergänzt um ` v ` als letztes Element.

Siehe auch „ operator+=()“, „ operator<<()“ und „ append()“.

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

Fügt „ v “ zu diesem Array hinzu und gibt eine Referenz auf dieses Array zurück.

Siehe auch append(), insert(), operator+() und operator<<().

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

Fügt „ v “ zu diesem Array hinzu und gibt eine Referenz auf dieses Array zurück.

Siehe auch append(), insert(), operator+() und operator+=().

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

Move-Zuweisungsoperator.

Das Objekt, aus dem verschoben wird ( other ), wird in einen gültigen, aber nicht näher spezifizierten Zustand versetzt.

Diese Funktion wurde in Qt 6.10 eingeführt.

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

Ersetzt den Inhalt dieses Arrays durch den Inhalt unter other und gibt anschließend eine Referenz auf dieses Objekt zurück.

QCborValueRef QCborArray::operator[](qsizetype i)

Gibt eine Referenz auf das Element „ QCborValue “ an der Position „ i “ im Array zurück. Indizes, die über das Ende des Arrays hinausgehen, erweitern das Array und füllen es mit undefinierten Einträgen, bis es einen Eintrag am angegebenen Index enthält.

QCborValueRef verfügt über genau dieselbe API wie ` QCborValue`, mit einem wichtigen Unterschied: Wenn Sie ihm neue Werte zuweisen, wird dieses Array mit diesen neuen Werten aktualisiert.

Siehe auch at(), first(), last(), insert(), prepend(), append(), removeAt() und takeAt().

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

Gibt das Element „ QCborValue “ an der Position „ i “ im Array zurück.

Ist das Array kleiner als i Elemente, gibt diese Funktion ein QCborValue zurück, das einen undefinierten Wert enthält. Aus diesem Grund lässt sich mit dieser Funktion nicht unterscheiden, ob das Array nicht groß genug ist oder ob es an der Position i einen undefinierten Wert enthält.

Siehe auch „ at()“, „ first()“, „ last()“, „ insert()“, „ prepend()“, „ append()“, „ removeAt()“ und „ takeAt()“.