QJsonArray Class

Dokumentation der Mitgliedsfunktionen

QJsonArray::QJsonArray()

Erzeugt ein leeres Array.

QJsonArray::QJsonArray(std::initializer_list<QJsonValue> args)

Erzeugt ein Array, das aus der args Initialisierungsliste initialisiert wird.

QJsonArray kann z.B. ähnlich wie die JSON-Notation aufgebaut sein:

QJsonArray array = { 1, 2.2, QString() };

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

Erzeugt eine Kopie von other.

Da QJsonArray implizit gemeinsam genutzt wird, ist die Kopie oberflächlich, solange das Objekt nicht verändert wird.

[noexcept] QJsonArray::QJsonArray(QJsonArray &&other)

Move-konstruiert ein QJsonArray aus other.

[noexcept] QJsonArray::~QJsonArray()

Löscht das Array.

void QJsonArray::append(const QJsonValue &value)

Fügt value am Ende des Arrays ein.

Siehe auch prepend() und insert().

QJsonValue QJsonArray::at(qsizetype i) const

Gibt ein QJsonValue zurück, das den Wert für den Index i darstellt.

Der zurückgegebene QJsonValue ist Undefined, wenn i außerhalb der Grenzen liegt.

QJsonArray::iterator QJsonArray::begin()

Gibt einen Iterator im STL-Stil zurück, der auf das erste Element im Array zeigt.

Siehe auch constBegin() und end().

QJsonArray::const_iterator QJsonArray::begin() const

Dies ist eine überladene Funktion.

QJsonArray::const_iterator QJsonArray::cbegin() const

Gibt einen const STL-artigen Iterator zurück, der auf das erste Element im Array zeigt.

Siehe auch begin() und cend().

QJsonArray::const_iterator QJsonArray::cend() const

Gibt einen const STL-artigen Iterator zurück, der auf das imaginäre Element nach dem letzten Element im Array zeigt.

Siehe auch cbegin() und end().

QJsonArray::const_iterator QJsonArray::constBegin() const

Gibt einen const STL-artigen Iterator zurück, der auf das erste Element im Array zeigt.

Siehe auch begin() und constEnd().

QJsonArray::const_iterator QJsonArray::constEnd() const

Gibt einen const STL-artigen Iterator zurück, der auf das imaginäre Element nach dem letzten Element im Array zeigt.

Siehe auch constBegin() und end().

bool QJsonArray::contains(const QJsonValue &value) const

Gibt true zurück, wenn das Array ein Vorkommen von value enthält, andernfalls false.

Siehe auch count().

qsizetype QJsonArray::count() const

Dasselbe wie size().

Siehe auch size().

bool QJsonArray::empty() const

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu isEmpty() und gibt true zurück, wenn das Array leer ist.

QJsonArray::iterator QJsonArray::end()

Gibt einen Iterator im STL-Stil zurück, der auf das imaginäre Element nach dem letzten Element im Array zeigt.

Siehe auch begin() und constEnd().

QJsonArray::const_iterator QJsonArray::end() const

Dies ist eine überladene Funktion.

QJsonArray::iterator QJsonArray::erase(QJsonArray::iterator it)

Entfernt das Element, auf das it zeigt, und gibt einen Iterator zurück, der auf das nächste Element zeigt.

Siehe auch removeAt().

QJsonValue QJsonArray::first() const

Gibt den ersten im Array gespeicherten Wert zurück.

Dasselbe wie at(0).

Siehe auch at().

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

Konvertiert die Stringliste list in eine QJsonArray.

Die Werte in list werden in JSON-Werte umgewandelt.

Siehe auch toVariantList() und QJsonValue::fromVariant().

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

Konvertiert die Variantenliste list in eine QJsonArray.

Die Werte von QVariant in list werden in JSON-Werte umgewandelt.

Siehe auch toVariantList() und QJsonValue::fromVariant().

QJsonArray::iterator QJsonArray::insert(QJsonArray::iterator before, const QJsonValue &value)

Fügt value vor der Position ein, auf die before zeigt, und gibt einen Iterator zurück, der auf das neu eingefügte Element zeigt.

Siehe auch erase() und insert().

void QJsonArray::insert(qsizetype i, const QJsonValue &value)

Fügt value an der Indexposition i in das Array ein. Wenn i gleich 0 ist, wird der Wert dem Array vorangestellt. Wenn i gleich size() ist, wird der Wert an das Array angehängt.

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

bool QJsonArray::isEmpty() const

Gibt true zurück, wenn das Objekt leer ist. Dies ist dasselbe wie size() == 0.

Siehe auch size().

QJsonValue QJsonArray::last() const

Gibt den letzten im Array gespeicherten Wert zurück.

Dasselbe wie at(size() - 1).

Siehe auch at().

void QJsonArray::pop_back()

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu removeLast(). Das Array darf nicht leer sein. Wenn das Array leer sein kann, rufen Sie isEmpty() auf, bevor Sie diese Funktion aufrufen.

void QJsonArray::pop_front()

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu removeFirst(). Das Array darf nicht leer sein. Wenn das Array leer sein kann, rufen Sie isEmpty() auf, bevor Sie diese Funktion aufrufen.

void QJsonArray::prepend(const QJsonValue &value)

Fügt value an den Anfang des Arrays ein.

Dies ist dasselbe wie insert(0, value) und stellt value dem Array vor.

Siehe auch append() und insert().

void QJsonArray::push_back(const QJsonValue &value)

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu append(Wert) und fügt value an das Array an.

void QJsonArray::push_front(const QJsonValue &value)

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt. Sie ist äquivalent zu prepend(Wert) und stellt value dem Array voran.

void QJsonArray::removeAt(qsizetype i)

Entfernt den Wert an der Indexposition i. i muss eine gültige Indexposition im Array sein (d. h. 0 <= i < size()).

Siehe auch insert() und replace().

void QJsonArray::removeFirst()

Entfernt das erste Element im Array. Der Aufruf dieser Funktion ist gleichbedeutend mit dem Aufruf von removeAt(0). Das Array darf nicht leer sein. Wenn das Array leer sein kann, rufen Sie isEmpty() auf, bevor Sie diese Funktion aufrufen.

Siehe auch removeAt() und removeLast().

void QJsonArray::removeLast()

Entfernt das letzte Element im Array. Der Aufruf dieser Funktion ist gleichbedeutend mit dem Aufruf von removeAt(size() - 1). Das Array darf nicht leer sein. Wenn das Array leer sein kann, rufen Sie isEmpty() auf, bevor Sie diese Funktion aufrufen.

Siehe auch removeAt() und removeFirst().

void QJsonArray::replace(qsizetype i, const QJsonValue &value)

Ersetzt das Element an der Indexposition i durch value. i muss eine gültige Indexposition im Array sein (d. h. 0 <= i < size()).

Siehe auch operator[]() und removeAt().

qsizetype QJsonArray::size() const

Gibt die Anzahl der im Array gespeicherten Werte zurück.

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

Tauscht dieses Feld mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QJsonValue QJsonArray::takeAt(qsizetype i)

Entfernt das Element an der Indexposition i und gibt es zurück. i muss eine gültige Indexposition im Array sein (d. h. 0 <= i < size()).

Wenn Sie den Rückgabewert nicht verwenden, ist removeAt() effizienter.

Siehe auch removeAt().

QVariantList QJsonArray::toVariantList() const

Konvertiert dieses Objekt in eine QVariantList.

Gibt die erstellte Karte zurück.

QJsonArray QJsonArray::operator+(const QJsonValue &value) const

Gibt ein Array zurück, das alle Elemente in diesem Array enthält, gefolgt von der angegebenen value.

Siehe auch operator+=().

QJsonArray &QJsonArray::operator+=(const QJsonValue &value)

Hängt value an das Array an und gibt einen Verweis auf das Array selbst zurück.

Siehe auch append() und operator<<().

QJsonArray &QJsonArray::operator<<(const QJsonValue &value)

Hängt value an das Array an und gibt einen Verweis auf das Array selbst zurück.

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

[noexcept] QJsonArray &QJsonArray::operator=(QJsonArray &&other)

Verschieben - ordnet other diesem Array zu.

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

Weist diesem Array other zu.

QJsonValueRef QJsonArray::operator[](qsizetype i)

Gibt den Wert an der Indexposition i als modifizierbare Referenz zurück. i muss eine gültige Indexposition im Array sein (d.h. 0 <= i < size()).

Der Rückgabewert ist vom Typ QJsonValueRef, einer Hilfsklasse für QJsonArray und QJsonObject. Wenn Sie ein Objekt vom Typ QJsonValueRef erhalten, können Sie es wie einen Verweis auf QJsonValue verwenden. Wenn Sie es zuweisen, gilt die Zuweisung für das Zeichen in QJsonArray von QJsonObject, von dem Sie den Verweis erhalten haben.

Siehe auch at().

QJsonValue QJsonArray::operator[](qsizetype i) const

Dies ist eine überladene Funktion.

Dasselbe wie at().