QUrlQuery Class

Documentation des fonctions membres

QUrlQuery::QUrlQuery()

Construit un objet QUrlQuery vide. Une requête peut être définie par la suite en appelant setQuery() ou des éléments peuvent être ajoutés en utilisant addQueryItem().

Voir aussi setQuery() et addQueryItem().

[explicit] QUrlQuery::QUrlQuery(const QString &queryString)

Construit un objet QUrlQuery et analyse la chaîne de requête queryString, en utilisant les délimiteurs de requête par défaut. Pour analyser une chaîne de requête en utilisant d'autres délimiteurs, vous devez d'abord les définir à l'aide de setQueryDelimiters(), puis définir la requête à l'aide de setQuery().

[explicit] QUrlQuery::QUrlQuery(const QUrl &url)

Construit un objet QUrlQuery et analyse la chaîne de requête trouvée dans l'URL url, en utilisant les délimiteurs de requête par défaut. Pour analyser une chaîne de requête en utilisant d'autres délimiteurs, vous devez d'abord les définir à l'aide de setQueryDelimiters(), puis définir la requête à l'aide de setQuery().

Voir aussi QUrl::query().

QUrlQuery::QUrlQuery(std::initializer_list<std::pair<QString, QString>> list)

Construit un objet QUrlQuery à partir de la paire clé/valeur list.

QUrlQuery::QUrlQuery(const QUrlQuery &other)

Copie le contenu de l'objet other QUrlQuery, y compris les délimiteurs de la requête.

[noexcept, since 6.5] QUrlQuery::QUrlQuery(QUrlQuery &&other)

Déplace le contenu de l'objet other QUrlQuery, y compris les délimiteurs de la requête.

Cette fonction a été introduite dans Qt 6.5.

[noexcept] QUrlQuery::~QUrlQuery()

Détruit cet objet QUrlQuery.

void QUrlQuery::addQueryItem(const QString &key, const QString &value)

Ajoute la paire key = value à la fin de la chaîne de requête de l'URL. Cette méthode n'écrase pas les éléments existants qui pourraient avoir la même clé.

Voir aussi hasQueryItem() et queryItemValue().

QStringList QUrlQuery::allQueryItemValues(const QString &key, QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

Renvoie la liste des valeurs de la chaîne de requête dont la clé est égale à key à partir de l'URL, en utilisant les options spécifiées dans encoding pour encoder la valeur de retour. Si la clé key n'est pas trouvée, cette fonction renvoie une liste vide.

Voir aussi queryItemValue() et addQueryItem().

void QUrlQuery::clear()

Efface cet objet QUrlQuery en supprimant toutes les paires clé-valeur actuellement stockées. Si les délimiteurs de la requête ont été modifiés, cette fonction les laissera avec leurs valeurs modifiées.

Voir aussi isEmpty() et setQueryDelimiters().

[static constexpr noexcept] char16_t QUrlQuery::defaultQueryPairDelimiter()

Renvoie le caractère par défaut pour séparer les paires clé-valeur les unes des autres, une esperluette ("&").

Voir aussi setQueryDelimiters(), queryPairDelimiter() et defaultQueryValueDelimiter().

[static constexpr noexcept] char16_t QUrlQuery::defaultQueryValueDelimiter()

Renvoie le caractère par défaut pour séparer les clés des valeurs dans la requête, un signe égal ("=").

Voir aussi setQueryDelimiters(), queryValueDelimiter() et defaultQueryPairDelimiter().

bool QUrlQuery::hasQueryItem(const QString &key) const

Renvoie true s'il existe une paire de chaînes de requête dont la clé est égale à key dans l'URL.

Voir aussi addQueryItem() et queryItemValue().

bool QUrlQuery::isEmpty() const

Renvoie true si cet objet QUrlQuery ne contient aucune paire clé-valeur, par exemple après avoir été construit par défaut ou après avoir analysé une chaîne de requête vide.

Voir aussi setQuery() et clear().

QString QUrlQuery::query(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

Renvoie la chaîne de requête reconstruite, formée à partir des paires clé-valeur actuellement stockées dans cet objet QUrlQuery et séparées par les délimiteurs de requête choisis pour cet objet. Les clés et les valeurs sont encodées en utilisant les options données par le paramètre encoding.

Pour cette fonction, le seul délimiteur ambigu est le dièse ("#"), car dans les URL, il est utilisé pour séparer la chaîne de requête du fragment qui peut suivre.

L'ordre des paires clé-valeur dans la chaîne renvoyée est exactement le même que dans la requête originale.

Voir aussi setQuery(), QUrl::setQuery(), QUrl::fragment(), et Encodage.

QString QUrlQuery::queryItemValue(const QString &key, QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

Renvoie la valeur de la requête associée à la clé key à partir de l'URL, en utilisant les options spécifiées dans encoding pour encoder la valeur de retour. Si la clé key n'est pas trouvée, cette fonction renvoie une chaîne vide. Si vous devez faire la distinction entre une valeur vide et une clé inexistante, vous devez d'abord vérifier la présence de la clé à l'aide de hasQueryItem().

Si la clé key est multipliée, cette fonction renvoie la première clé trouvée, dans l'ordre où elle est présente dans la chaîne de requête ou ajoutée à l'aide de addQueryItem().

Voir aussi addQueryItem(), allQueryItemValues() et Encodage.

QList<std::pair<QString, QString>> QUrlQuery::queryItems(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

Renvoie la chaîne de requête de l'URL, sous la forme d'une carte de clés et de valeurs, en utilisant les options spécifiées dans encoding pour encoder les éléments. L'ordre des éléments est le même que celui trouvé dans la chaîne de requête ou défini avec setQueryItems().

Voir aussi setQueryItems() et Encodage.

QChar QUrlQuery::queryPairDelimiter() const

Renvoie le caractère utilisé pour délimiter les paires clé-valeur lors de la reconstruction de la chaîne de requête dans query() ou lors de l'analyse dans setQuery().

Voir aussi setQueryDelimiters() et queryValueDelimiter().

QChar QUrlQuery::queryValueDelimiter() const

Renvoie le caractère utilisé pour délimiter les clés et les valeurs lors de la reconstruction de la chaîne de requête dans query() ou lors de l'analyse dans setQuery().

Voir aussi setQueryDelimiters() et queryPairDelimiter().

void QUrlQuery::removeAllQueryItems(const QString &key)

Supprime de l'URL toutes les paires de chaînes de requête dont la clé est égale à key.

Voir aussi removeQueryItem().

void QUrlQuery::removeQueryItem(const QString &key)

Supprime de l'URL la paire de chaînes de requête dont la clé est égale à key. S'il existe plusieurs éléments dont la clé est égale à key, le premier élément est supprimé dans l'ordre où il était présent dans la chaîne de requête ou ajouté avec addQueryItem().

Voir aussi removeAllQueryItems().

void QUrlQuery::setQuery(const QString &queryString)

Analyse la chaîne de requête dans queryString et attribue aux éléments internes les valeurs trouvées dans cette chaîne. Si des délimiteurs ont été spécifiés avec setQueryDelimiters(), cette fonction les utilisera à la place des délimiteurs par défaut pour analyser la chaîne.

Voir aussi query().

void QUrlQuery::setQueryDelimiters(QChar valueDelimiter, QChar pairDelimiter)

Définit les caractères utilisés pour délimiter les clés et les valeurs, ainsi que les paires clé-valeur dans la chaîne de requête de l'URL. Le délimiteur de valeur par défaut est "=" et le délimiteur de paires par défaut est "&".

valueDelimiter est utilisé pour séparer les clés des valeurs, et pairDelimiter est utilisé pour séparer les paires clé-valeur. Toutes les occurrences de ces caractères de délimitation dans la représentation codée des clés et des valeurs de la chaîne de requête sont codées en pourcentage lorsqu'elles sont renvoyées dans query().

Si la valeur de valueDelimiter est ',' et celle de pairDelimiter ';', la chaîne de requête ci-dessus serait représentée comme suit :

 http://www.example.com/cgi-bin/drawgraph.cgi?type,pie;color,green

sub-delims    = "!" / "$" / "&" / "'" / "(" / ")"
              / "*" / "+" / "," / ";" / "="

L'utilisation d'autres caractères n'est pas prise en charge et peut entraîner un comportement inattendu. Cette méthode ne vérifie pas que vous avez passé un délimiteur valide.

Voir aussi queryValueDelimiter() et queryPairDelimiter().

void QUrlQuery::setQueryItems(const QList<std::pair<QString, QString>> &query)

Définit les éléments de l'objet QUrlQuery en query. L'ordre des éléments dans query est préservé.

Voir aussi queryItems() et isEmpty().

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

Remplace cette instance de requête URL par other. Cette opération est très rapide et n'échoue jamais.

QString QUrlQuery::toString(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

Renvoie cette QUrlQuery sous forme de QString. encoding peut être utilisé pour spécifier l'encodage de la chaîne URL de la valeur de retour.

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

Move-assigne other à cette instance QUrlQuery.

QUrlQuery &QUrlQuery::operator=(const QUrlQuery &other)

Copie le contenu de l'objet other QUrlQuery , y compris les délimiteurs de la requête.