QJsonArray Class

Documentation sur les fonctions membres

QJsonArray::QJsonArray()

Crée un tableau vide.

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

Crée un tableau initialisé à partir de la liste d'initialisation args.

QJsonArray peut être construit d'une manière similaire à la notation JSON, par exemple :

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

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

Crée une copie de other.

Comme QJsonArray est implicitement partagé, la copie est superficielle tant que l'objet n'est pas modifié.

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

Move-construit un QJsonArray à partir de other.

[noexcept] QJsonArray::~QJsonArray()

Supprime le tableau.

void QJsonArray::append(const QJsonValue &value)

Insère value à la fin du tableau.

Voir également prepend() et insert().

QJsonValue QJsonArray::at(qsizetype i) const

Renvoie un QJsonValue représentant la valeur de l'index i.

L'adresse QJsonValue renvoyée est Undefined, si i est hors limites.

QJsonArray::iterator QJsonArray::begin()

Renvoie un itérateur de style STL pointant sur le premier élément du tableau.

Voir aussi constBegin() et end().

QJsonArray::const_iterator QJsonArray::begin() const

QJsonArray::const_iterator QJsonArray::cbegin() const

Renvoie un itérateur constant de style STL pointant sur le premier élément du tableau.

Voir aussi begin() et cend().

QJsonArray::const_iterator QJsonArray::cend() const

Renvoie un itérateur constant de style STL pointant vers l'élément imaginaire situé après le dernier élément du tableau.

Voir aussi cbegin() et end().

QJsonArray::const_iterator QJsonArray::constBegin() const

Renvoie un itérateur constant de style STL pointant sur le premier élément du tableau.

Voir aussi begin() et constEnd().

QJsonArray::const_iterator QJsonArray::constEnd() const

Renvoie un itérateur constant de style STL pointant vers l'élément imaginaire situé après le dernier élément du tableau.

Voir aussi constBegin() et end().

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

Renvoie true si le tableau contient une occurrence de value, sinon false.

Voir aussi count().

qsizetype QJsonArray::count() const

Identique à size().

Voir également size().

bool QJsonArray::empty() const

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à isEmpty() et renvoie true si le tableau est vide.

QJsonArray::iterator QJsonArray::end()

Renvoie un itérateur de style STL pointant vers l'élément imaginaire situé après le dernier élément du tableau.

Voir aussi begin() et constEnd().

QJsonArray::const_iterator QJsonArray::end() const

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

Supprime l'élément pointé par it, et renvoie un itérateur pointant vers l'élément suivant.

Voir aussi removeAt().

QJsonValue QJsonArray::first() const

Renvoie la première valeur stockée dans le tableau.

Identique à at(0).

Voir aussi at().

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

Convertit la liste de chaînes list en QJsonArray.

Les valeurs contenues dans list seront converties en valeurs JSON.

Voir aussi toVariantList() et QJsonValue::fromVariant().

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

Convertit la liste de variantes list en QJsonArray.

Les valeurs de QVariant dans list seront converties en valeurs JSON.

Voir aussi toVariantList() et QJsonValue::fromVariant().

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

Insère value avant la position indiquée par before, et renvoie un itérateur pointant vers l'élément nouvellement inséré.

Voir aussi erase() et insert(qsizetype, const QJsonValue &).

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

Insère value à la position d'index i dans le tableau. Si i est 0, la valeur est ajoutée au tableau. Si i est size(), la valeur est ajoutée au tableau.

Voir aussi append(), prepend(), replace() et removeAt().

bool QJsonArray::isEmpty() const

Renvoie true si l'objet est vide. C'est la même chose que size() == 0.

Voir aussi size().

QJsonValue QJsonArray::last() const

Renvoie la dernière valeur stockée dans le tableau.

Identique à at(size() - 1).

Voir aussi at().

void QJsonArray::pop_back()

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à removeLast(). Le tableau ne doit pas être vide. Si le tableau peut être vide, appelez isEmpty() avant d'appeler cette fonction.

void QJsonArray::pop_front()

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à removeFirst(). Le tableau ne doit pas être vide. Si le tableau peut être vide, appelez isEmpty() avant d'appeler cette fonction.

void QJsonArray::prepend(const QJsonValue &value)

Insère value au début du tableau.

C'est la même chose que insert(0, value) et cela ajoutera value au tableau.

Voir aussi append() et insert().

void QJsonArray::push_back(const QJsonValue &value)

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à append(valeur) et ajoutera value au tableau.

void QJsonArray::push_front(const QJsonValue &value)

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à prepend(valeur) et ajoutera value au tableau.

void QJsonArray::removeAt(qsizetype i)

Supprime la valeur à la position d'index i. i doit être une position d'index valide dans le tableau (c'est-à-dire 0 <= i < size()).

Voir également insert() et replace().

void QJsonArray::removeFirst()

Supprime le premier élément du tableau. L'appel de cette fonction équivaut à l'appel de removeAt(0). Le tableau ne doit pas être vide. Si le tableau peut être vide, appelez isEmpty() avant d'appeler cette fonction.

Voir également removeAt() et removeLast().

void QJsonArray::removeLast()

Supprime le dernier élément du tableau. L'appel à cette fonction équivaut à l'appel à removeAt(size() - 1). Le tableau ne doit pas être vide. Si le tableau peut être vide, appelez isEmpty() avant d'appeler cette fonction.

Voir également removeAt() et removeFirst().

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

Remplace l'élément à la position d'index i par value. i doit être une position d'index valide dans le tableau (c'est-à-dire 0 <= i < size()).

Voir également operator[]() et removeAt().

qsizetype QJsonArray::size() const

Renvoie le nombre de valeurs stockées dans le tableau.

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

Remplace ce tableau par other. Cette opération est très rapide et n'échoue jamais.

QJsonValue QJsonArray::takeAt(qsizetype i)

Supprime l'élément à la position d'index i et le renvoie. i doit être une position d'index valide dans le tableau (c'est-à-dire 0 <= i < size()).

Si vous n'utilisez pas la valeur de retour, removeAt() est plus efficace.

Voir également removeAt().

QVariantList QJsonArray::toVariantList() const

Convertit cet objet en QVariantList.

Renvoie la carte créée.

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

Renvoie un tableau qui contient tous les éléments de ce tableau suivis de l'adresse value.

Voir aussi operator+=().

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

Ajoute value au tableau et renvoie une référence au tableau lui-même.

Voir aussi append() et operator<<().

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

Ajoute value au tableau et renvoie une référence au tableau lui-même.

Voir aussi operator+=() et append().

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

Move-assigne other à ce tableau.

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

Affecte other à ce tableau.

QJsonValueRef QJsonArray::operator[](qsizetype i)

Renvoie la valeur à la position d'index i sous forme de référence modifiable. i doit être une position d'index valide dans le tableau (c'est-à-dire 0 <= i < size()).

La valeur de retour est de type QJsonValueRef, une classe d'aide pour QJsonArray et QJsonObject. Lorsque vous obtenez un objet de type QJsonValueRef, vous pouvez l'utiliser comme s'il s'agissait d'une référence à QJsonValue. Si vous l'affectez, l'affectation s'appliquera au caractère dans le QJsonArray de QJsonObject à partir duquel vous avez obtenu la référence.

Voir également at().

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

Identique à at().