QUrlQuery Class

Documentation des fonctions membres

QUrlQuery::QUrlQuery()

Crée un objet QUrlQuery vide. Une requête peut être définie par la suite en appelant la méthode setQuery() ou des éléments peuvent être ajoutés à l'aide de la méthode addQueryItem().

Voir également setQuery() et addQueryItem().

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

Crée 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 à l'aide d'autres délimiteurs, vous devez d'abord les définir à l'aide de ` setQueryDelimiters()` puis définir la requête avec ` setQuery()`.

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

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

Voir également QUrl::query().

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

Crée un objet QUrlQuery à partir de l'list e de paires clé/valeur.

QUrlQuery::QUrlQuery(const QUrlQuery &other)

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

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

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

Cette fonction a été introduite dans Qt 6.5.

[noexcept] QUrlQuery::~QUrlQuery()

Supprime cet objet de type « 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 ne remplace pas les éléments existants qui pourraient porter la même clé.

Voir également hasQueryItem() et queryItemValue().

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

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

Voir également 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 requête ont été modifiés, cette fonction conservera les nouvelles valeurs attribuées à ces délimiteurs.

Voir également isEmpty() et setQueryDelimiters().

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

Renvoie le caractère par défaut utilisé pour séparer les paires clé-valeur les unes des autres, à savoir l'esperluette (« & »).

Voir également setQueryDelimiters(), queryPairDelimiter() et defaultQueryValueDelimiter().

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

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

Voir également setQueryDelimiters(), queryValueDelimiter() et defaultQueryPairDelimiter().

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

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

Voir également addQueryItem() et queryItemValue().

bool QUrlQuery::isEmpty() const

Renvoie ` true ` si cet objet ` QUrlQuery ` ne contient aucune paire clé-valeur, par exemple après une construction par défaut ou après l'analyse d'une chaîne de requête vide.

Voir également 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 à l'aide des options fournies par le paramètre ` encoding `.

Pour cette fonction, le seul délimiteur ambigu est le signe 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 d’origine.

Voir également setQuery(), QUrl::setQuery(), QUrl::fragment() et Encodage.

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

Renvoie la valeur de requête associée à la clé key issue de l'URL, en utilisant les options spécifiées dans encoding pour encoder la valeur renvoyée. 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 définie plusieurs fois, cette fonction renvoie la première trouvée, dans l’ordre où elles figuraient dans la chaîne de requête ou ont été ajoutées à l’aide de addQueryItem().

Voir également 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 de la chaîne de requête ou que celui défini avec setQueryItems().

Voir également 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 également 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 la fonction query() ou lors de son analyse dans la fonction setQuery().

Voir également 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 également removeQueryItem().

void QUrlQuery::removeQueryItem(const QString &key)

Supprime de l’URL la paire de chaîne de requête dont la clé est égale à key. S’il existe plusieurs éléments dont la clé est égale à key, la fonction supprime le premier élément dans l’ordre où ils apparaissent dans la chaîne de requête ou ont été ajoutés via addQueryItem().

Voir également removeAllQueryItems().

void QUrlQuery::setQuery(const QString &queryString)

Analyse la chaîne de requête contenue dans ` queryString ` et attribue aux éléments internes les valeurs qui y sont trouvées. Si des délimiteurs ont été spécifiés à l'aide de la fonction ` setQueryDelimiters()`, celle-ci les utilisera à la place des délimiteurs par défaut pour analyser la chaîne.

Voir également 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. Par défaut, le délimiteur de valeur est « = » et le délimiteur de paire est « & ».

valueDelimiter sera utilisé pour séparer les clés des valeurs, et pairDelimiter sera utilisé pour séparer les paires clé-valeur. Toute occurrence de ces caractères de délimitation dans la représentation encodée des clés et des valeurs de la chaîne de requête est encodée en pourcentage lorsqu’elle est renvoyée par la fonction query().

Si ` valueDelimiter ` est défini sur « , » et ` pairDelimiter ` sur « ; », la chaîne de requête ci-dessus serait alors 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 fourni un délimiteur valide.

Voir également queryValueDelimiter() et queryPairDelimiter().

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

Définit les éléments de cet objet ` QUrlQuery ` sur ` query`. L'ordre des éléments dans ` query ` est conservé.

Voir également queryItems() et isEmpty().

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

Remplace cette instance de requête d'URL par other. Cette opération est très rapide et ne rencontre jamais d'échec.

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

Renvoie cette chaîne « QUrlQuery » sous la forme « QString ». L'argument « encoding » permet de spécifier l'encodage de la chaîne URL de la valeur renvoyée.

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

Cette commande affecte l'other à cette instance QUrlQuery.

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

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