QJsonArray Class

Documentation des fonctions membres

QJsonArray::QJsonArray()

Crée un tableau vide.

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

Crée un tableau initialisé à partir d'une liste d'initialisation de type « 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)

Crée par « move » 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 aussi prepend() et insert().

QJsonValue QJsonArray::at(qsizetype i) const

Renvoie un objet ` QJsonValue ` représentant la valeur correspondant à l'index ` i`.

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

QJsonArray::iterator QJsonArray::begin()

Renvoie un itérateur de type STL pointant vers le premier élément du tableau.

Voir également constBegin() et end().

QJsonArray::const_iterator QJsonArray::begin() const

QJsonArray::const_iterator QJsonArray::cbegin() const

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

Voir également begin() et cend().

QJsonArray::const_iterator QJsonArray::cend() const

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

Voir également cbegin() et end().

QJsonArray::const_iterator QJsonArray::constBegin() const

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

Voir également begin() et constEnd().

QJsonArray::const_iterator QJsonArray::constEnd() const

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

Voir également constBegin() et end().

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

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

Voir également count().

qsizetype QJsonArray::count() const

Identique à size().

Voir également size().

bool QJsonArray::empty() const

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à ` isEmpty()` et renvoie ` true ` si le tableau est vide.

QJsonArray::iterator QJsonArray::end()

Renvoie un itérateur de type 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 également removeAt().

QJsonValue QJsonArray::first() const

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

Equivalent à ` at(0)`.

Voir aussi at().

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

Convertit la liste de chaînes list en un objet QJsonArray.

Les valeurs contenues dans ` list ` seront converties en valeurs JSON.

Voir également toVariantList() et QJsonValue::fromVariant().

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

Convertit la liste de variantes list en un fichier QJsonArray.

Les valeurs de type « QVariant » contenues dans « list » seront converties en valeurs JSON.

Voir également toVariantList() et QJsonValue::fromVariant().

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

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

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

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

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

Voir également append(), prepend(), replace() et removeAt().

bool QJsonArray::isEmpty() const

Renvoie « true » si l'objet est vide. Cela revient à vérifier si ` size()` == 0.

Voir aussi size().

QJsonValue QJsonArray::last() const

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

Equivalent à ` at(size() - 1)`.

Voir aussi at().

void QJsonArray::pop_back()

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à ` 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 à des fins de compatibilité avec la STL. Elle est équivalente à ` removeFirst()`. Le tableau ne doit pas être vide. Si le tableau peut être vide, appelez d'abord ` isEmpty()` avant d'appeler cette fonction.

void QJsonArray::prepend(const QJsonValue &value)

Insère value au début du tableau.

Cette fonction est identique à ` insert(0, value) ` et ajoute ` value ` au début du tableau.

Voir également append() et insert().

void QJsonArray::push_back(const QJsonValue &value)

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à ` append(value)` et ajoute ` value ` à la liste.

void QJsonArray::push_front(const QJsonValue &value)

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à ` prepend(value)` et ajoute ` value ` au début du tableau.

void QJsonArray::removeAt(qsizetype i)

Supprime la valeur située à l'index i. i doit être un 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 l'élément de fin du tableau. L'appel de cette fonction équivaut à l'appel de ` 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 situé à l'index i par value. i doit être un 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)

Permute les éléments de ce tableau avec ceux d'other. Cette opération est très rapide et ne rencontre jamais d'échec.

QJsonValue QJsonArray::takeAt(qsizetype i)

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

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

Voir également removeAt().

QVariantList QJsonArray::toVariantList() const

Convertit cet objet en une carte « QVariantList ».

Renvoie la carte créée.

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

Renvoie un tableau contenant tous les éléments de ce tableau, suivis de l'value fournie.

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 également 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)

La commande « move » attribue la valeur « other » à ce tableau.

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

Attribue la valeur « other » à ce tableau.

QJsonValueRef QJsonArray::operator[](qsizetype i)

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

La valeur renvoyée 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 à un QJsonValue. Si vous lui attribuez une valeur, l'affectation s'appliquera au caractère situé à l'QJsonArray de QJsonObject à partir duquel vous avez obtenu la référence.

Voir également at().

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

Identique à ` at()`.