QJsonArray Class

Dokumentation zu den Member-Funktionen

QJsonArray::QJsonArray()

Erstellt ein leeres Array.

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

Erstellt ein Array, das anhand einer Initialisierungsliste im Format „ args “ initialisiert wird.

QJsonArray kann ähnlich wie in der JSON-Notation erstellt werden, zum Beispiel:

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

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

Erstellt eine Kopie von ` other`.

Da QJsonArray implizit gemeinsam genutzt wird, handelt es sich um eine oberflächliche Kopie, solange das Objekt nicht verändert wird.

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

Erstellt ein QJsonArray aus „ other “ mithilfe von „move-construct“.

[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`, falls ` i ` außerhalb des zulässigen Bereichs liegt.

QJsonArray::iterator QJsonArray::begin()

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

Siehe auch constBegin() und end().

QJsonArray::const_iterator QJsonArray::begin() const

QJsonArray::const_iterator QJsonArray::cbegin() const

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

Siehe auch „ begin()“ und „ cend()“.

QJsonArray::const_iterator QJsonArray::cend() const

Gibt einen konstanen Iterator im STL-Stil 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 konstanten Iterator im STL-Stil zurück, der auf das erste Element des Arrays zeigt.

Siehe auch „ begin()“ und „ constEnd()“.

QJsonArray::const_iterator QJsonArray::constEnd() const

Gibt einen konstanten Iterator im STL-Stil 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

Wie unter size() beschrieben.

Siehe auch size().

bool QJsonArray::empty() const

Diese Funktion dient der STL-Kompatibilität. Sie entspricht ` 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

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

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

Siehe auch removeAt().

QJsonValue QJsonArray::first() const

Gibt den ersten im Array gespeicherten Wert zurück.

Entspricht ` at(0)`.

Siehe auch ` at()`.

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

Konvertiert die Zeichenfolgenliste „ list “ in „ 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 QVariant -Werte 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(qsizetype, const QJsonValue &)`.

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 am Anfang des Arrays eingefügt. Wenn i gleich size() ist, wird der Wert am Ende des Arrays angehängt.

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

bool QJsonArray::isEmpty() const

Gibt „ true “ zurück, wenn das Objekt leer ist. Dies entspricht der Bedingung „ size() == 0“.

Siehe auch size().

QJsonValue QJsonArray::last() const

Gibt den zuletzt im Array gespeicherten Wert zurück.

Entspricht ` at(size() - 1)`.

Siehe auch ` at()`.

void QJsonArray::pop_back()

Diese Funktion dient der STL-Kompatibilität. Sie entspricht der Funktion ` removeLast()`. Das Array darf nicht leer sein. Falls das Array leer sein darf, rufen Sie vor dem Aufruf dieser Funktion die Funktion ` isEmpty()` auf.

void QJsonArray::pop_front()

Diese Funktion dient der STL-Kompatibilität. Sie entspricht der Funktion „ removeFirst()“. Das Array darf nicht leer sein. Falls das Array leer sein darf, rufen Sie vor dem Aufruf dieser Funktion die Funktion „ isEmpty()“ auf.

void QJsonArray::prepend(const QJsonValue &value)

Fügt „ value “ am Anfang des Arrays ein.

Dies entspricht der Funktion ` insert(0, value) ` und fügt ` value ` am Anfang des Arrays ein.

Siehe auch „ append()“ und „ insert()“.

void QJsonArray::push_back(const QJsonValue &value)

Diese Funktion dient der STL-Kompatibilität. Sie entspricht „ append(value)“ und fügt „ value “ an das Array an.

void QJsonArray::push_front(const QJsonValue &value)

Diese Funktion dient der STL-Kompatibilität. Sie entspricht „ prepend(value)“ und fügt dem Array „ value “ vor.

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 aus dem Array. Der Aufruf dieser Funktion entspricht dem Aufruf von ` removeAt(0)`. Das Array darf nicht leer sein. Wenn das Array leer sein darf, rufen Sie vor dem Aufruf dieser Funktion ` isEmpty()` auf.

Siehe auch removeAt() und removeLast().

void QJsonArray::removeLast()

Entfernt das letzte Element aus dem Array. Der Aufruf dieser Funktion entspricht dem Aufruf von ` removeAt(size() - 1)`. Das Array darf nicht leer sein. Wenn das Array leer sein darf, rufen Sie vor dem Aufruf dieser Funktion ` isEmpty()` auf.

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 Array mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals 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 Map zurück.

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

Gibt ein Array zurück, das alle Elemente dieses Arrays enthält, gefolgt von dem angegebenen „ value “.

Siehe auch ` operator+=()`.

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

Fügt „ value “ zum Array hinzu und gibt eine Referenz auf das Array selbst zurück.

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

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

Fügt „ value “ zum Array hinzu und gibt eine Referenz auf das Array selbst zurück.

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

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

Mit „Move“ wird „ other “ diesem Array zugewiesen.

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

Weist diesem Array den Wert „ other “ zu.

QJsonValueRef QJsonArray::operator[](qsizetype i)

Gibt den Wert an der Indexposition „ i “ als veränderbare 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 so verwenden, als wäre es eine Referenz auf ein ` QJsonValue`. Wenn Sie ihm einen Wert zuweisen, wirkt sich die Zuweisung auf das Zeichen an der Position ` QJsonArray ` von ` QJsonObject ` aus, von dem Sie die Referenz erhalten haben.

Siehe auch at().

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

Entspricht „ at()“.