QCborArray Class

Dokumentation der Mitgliedsfunktionen

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

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

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

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

Fügt value in das Array vor allen anderen Elementen ein, die es bereits enthält.

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

Fügt value in das Array nach allen anderen Elementen ein, die es bereits enthält.

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

Dies ist eine überladene Funktion.

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 zeigt.

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

Entfernt das Element, auf das der Array-Iterator it zeigt, aus diesem Array und gibt dann einen Iterator zum nächsten Element zurück (dasjenige, das die gleiche Position im Array eingenommen hat, die it zuvor eingenommen hat).

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

[noexcept] QCborArray::QCborArray()

Konstruiert ein leeres QCborArray.

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

Initialisiert dieses QCborArray aus der in Klammern eingeschlossenen C++-Liste in args, wie im folgenden Beispiel:

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.

[noexcept] QCborArray::~QCborArray()

Zerstört diese QCborArray und gibt alle zugehörigen Ressourcen frei.

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 ist es mit dieser Funktion nicht möglich, den Fall, dass das Array nicht groß genug ist, von dem Fall zu unterscheiden, dass das Array 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 in diesem Array zeigt. Wenn das Array leer ist, gibt diese Funktion dasselbe 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 in diesem Array zeigt. Wenn das Array leer ist, gibt diese Funktion dasselbe 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 in diesem Array zeigt. Wenn das Array leer ist, gibt diese Funktion dasselbe zurück wie end().

Siehe auch constBegin() und constEnd().

QCborArray::const_iterator QCborArray::cend() const

Gibt einen Array-Iterator zurück, der direkt auf das letzte Element in diesem Array zeigt.

Siehe auch constBegin() und constEnd().

void QCborArray::clear()

Entleert dieses Array.

Siehe auch isEmpty().

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

Vergleicht dieses Array und other, wobei jedes Element der Reihe nach verglichen wird, und gibt eine Ganzzahl zurück, die angibt, ob dieses Array vor (wenn das Ergebnis negativ ist) oder nach other (wenn das Ergebnis positiv ist) sortiert werden soll. Wenn diese Funktion 0 zurückgibt, sind die beiden Arrays gleich und enthalten die gleichen 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 in diesem Array zeigt. Wenn das Array leer ist, gibt diese Funktion dasselbe zurück wie end().

Siehe auch begin() und constEnd().

QCborArray::const_iterator QCborArray::constEnd() const

Gibt einen Array-Iterator zurück, der direkt auf das letzte Element in diesem Array zeigt.

Siehe auch constBegin() und end().

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

Gibt true zurück, wenn dieses Array ein Element enthält, das gleich value ist.

bool QCborArray::empty() const

Synonym für isEmpty(). Diese Funktion dient der Kompatibilität mit generischem Code, der die API der Standardbibliothek verwendet.

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 direkt auf das letzte Element in diesem Array zeigt.

Siehe auch begin() und constEnd().

QCborArray::const_iterator QCborArray::end() const

Gibt einen Array-Iterator zurück, der direkt auf das letzte Element in diesem Array zeigt.

Siehe auch constBegin() und constEnd().

QCborValueRef QCborArray::first()

Gibt einen Verweis auf den ersten QCborValue dieses Arrays zurück. Das Array darf nicht leer sein.

QCborValueRef hat genau dieselbe API wie QCborValue, mit einem wichtigen Unterschied: Wenn Sie ihm neue Werte zuweisen, wird dieses Array mit diesem neuen Wert aktualisiert.

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

QCborValue QCborArray::first() const

Gibt den ersten QCborValue dieses Arrays zurück.

Wenn das Array leer ist, gibt diese Funktion ein QCborValue zurück, das einen undefinierten Wert enthält. Aus diesem Grund ist es mit dieser Funktion nicht möglich, den Fall, dass das Array nicht groß genug ist, von dem Fall zu unterscheiden, dass das Array 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 mit 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-Typs ist. Außerdem kann das von dieser Funktion zurückgegebene Array mit toJsonArray() wieder in das ursprüngliche array konvertiert werden.

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

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

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.3 eingeführt.

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

Gibt eine QCborArray zurück, die alle in der Liste list gefundenen Zeichenketten enthält.

Siehe auch fromVariantList() und fromJsonArray().

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

Konvertiert alle Elemente in list nach CBOR mit QCborValue::fromVariant() und gibt das Array zurück, das aus diesen Elementen besteht.

Die Konvertierung von QVariant ist nicht völlig verlustfrei. Bitte lesen Sie die Dokumentation in QCborValue::fromVariant() für weitere Informationen.

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

bool QCborArray::isEmpty() const

Gibt true zurück, wenn diese QCborArray leer ist (d. h. wenn size() 0 ist).

Siehe auch size() und clear().

QCborValueRef QCborArray::last()

Gibt einen Verweis auf das letzte QCborValue dieses Arrays zurück. Das Array darf nicht leer sein.

QCborValueRef hat genau die gleiche API wie QCborValue, mit einem wichtigen Unterschied: wenn Sie ihm neue Werte zuweisen, wird dieses Array mit diesem neuen Wert aktualisiert.

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

QCborValue QCborArray::last() const

Gibt die letzte QCborValue dieses Arrays zurück.

Wenn das Array leer ist, gibt diese Funktion ein QCborValue zurück, das einen undefinierten Wert enthält. Aus diesem Grund ist es mit dieser Funktion nicht möglich, den Fall, dass das Array nicht groß genug ist, von dem Fall zu unterscheiden, dass das Array 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 API der Standardbibliothek verwendet.

Entfernt das letzte Element dieses Arrays. Das Array darf nicht leer sein, bevor es entfernt wird.

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

void QCborArray::pop_front()

Synonym für removeFirst(). Diese Funktion wird aus Gründen der Kompatibilität mit generischem Code bereitgestellt, der die API der Standardbibliothek verwendet.

Entfernt das erste Element dieses Arrays. Das Array darf nicht leer sein, bevor es entfernt wird.

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

void QCborArray::push_back(const QCborValue &t)

Synonym für append(). Diese Funktion wird aus Gründen der Kompatibilität mit generischem Code bereitgestellt, der die API der Standardbibliothek verwendet.

Hängt 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 wird aus Gründen der Kompatibilität mit generischem Code bereitgestellt, der die API der Standardbibliothek verwendet.

Fügt das Element t diesem Array vor.

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 mehr als i Elemente haben, bevor es entfernt wird.

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

void QCborArray::removeFirst()

Entfernt das erste Element des Arrays und macht das zweite Element zum ersten. 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 im 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 Feld mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QCborValue QCborArray::takeAt(qsizetype i)

Entfernt das Element an der Position i aus dem Array und gibt es zurück. Das Array muss mehr als i Elemente haben, bevor es entfernt wird.

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

QCborValue QCborArray::takeFirst()

Entfernt das erste Element im 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 im 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

Konstruiert explizit ein QCborValue Objekt, das dieses Array darstellt. Diese Funktion ist normalerweise nicht notwendig, da QCborValue einen Konstruktor für QCborArray hat, so dass die Konvertierung implizit ist.

Die Konvertierung von QCborArray nach QCborValue ermöglicht die Verwendung in jedem Kontext, in dem QCborValues verwendet werden können, einschließlich als Elemente in QCborArrays und als Schlüssel und gemappte Typen in QCborMap. Die Konvertierung eines Arrays nach 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 mit QCborValue::toJsonValue() in JSON und gibt das entsprechende QJsonArray zurück, das aus diesen Elementen besteht.

Bitte beachten Sie, dass CBOR einen reicheren und breiteren Typensatz als JSON enthält, so dass einige Informationen bei dieser Konvertierung verloren gehen können. Weitere Einzelheiten zu den angewandten Konvertierungen finden Sie unter QCborValue::toJsonValue().

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

QVariantList QCborArray::toVariantList() const

Konvertiert rekursiv jedes QCborValue in diesem Array mit QCborValue::toVariant() und gibt das QVariantList zurück, das aus den konvertierten Elementen besteht.

Die Konvertierung in QVariant ist nicht völlig verlustfrei. Bitte lesen Sie die Dokumentation in QCborValue::toVariant() für weitere Informationen.

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

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

Gibt ein neues QCborArray zurück, das die gleichen Elemente wie dieses Array enthält, plus v als letztes Element angehängt.

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

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

Hängt v an dieses Array an und gibt einen Verweis auf dieses Array zurück.

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

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

Hängt v an dieses Array an und gibt einen Verweis auf dieses Array zurück.

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

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

Ersetzt den Inhalt dieses Arrays durch den in other gefundenen und gibt dann einen Verweis auf dieses Objekt zurück.

QCborValueRef QCborArray::operator[](qsizetype i)

Gibt einen Verweis auf das Element QCborValue an der Position i in dem Array zurück. Indizes, die über das Ende des Arrays hinausgehen, lassen das Array wachsen und füllen es mit undefinierten Einträgen, bis es einen Eintrag am angegebenen Index hat.

QCborValueRef hat genau die gleiche API wie QCborValue, mit einem wichtigen Unterschied: Wenn Sie ihm neue Werte zuweisen, wird dieses Array mit diesem neuen Wert 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 ist es mit dieser Funktion nicht möglich, den Fall, dass das Array nicht groß genug ist, von dem Fall zu unterscheiden, dass das Array einen undefinierten Wert an der Position i enthält.

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