QUrlQuery Class

Dokumentation der Mitgliedsfunktionen

QUrlQuery::QUrlQuery()

Erstellt ein leeres QUrlQuery-Objekt. Eine Abfrage kann anschließend durch Aufruf von ` setQuery()` festgelegt werden, oder es können Elemente mithilfe von ` addQueryItem()` hinzugefügt werden.

Siehe auch setQuery() und addQueryItem().

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

Erstellt ein `QUrlQuery`-Objekt und analysiert die Abfragezeichenfolge „ queryString “ unter Verwendung der Standard-Abgrenzzeichen. Um eine Abfragezeichenfolge mit anderen Abgrenzzeichen zu analysieren, sollten Sie diese zunächst mit ` setQueryDelimiters()` festlegen und anschließend die Abfrage mit ` setQuery()` setzen.

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

Erstellt ein QUrlQuery-Objekt und analysiert die in der URL „ url “ enthaltene Abfragezeichenfolge unter Verwendung der Standard-Abgrenzungszeichen. Um eine Abfragezeichenfolge mit anderen Abgrenzungszeichen zu analysieren, sollten Sie diese zunächst mit „ setQueryDelimiters()“ festlegen und anschließend die Abfrage mit „ setQuery()“ setzen.

Siehe auch QUrl::query().

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

Erstellt ein QUrlQuery-Objekt aus dem „ list “ mit Schlüssel-Wert-Paaren.

QUrlQuery::QUrlQuery(const QUrlQuery &other)

Kopiert den Inhalt des QUrlQuery-Objekts „ other “, einschließlich der Abfrage-Trennzeichen.

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

Verschiebt den Inhalt des QUrlQuery-Objekts „ other “, einschließlich der Abfrage-Trennzeichen.

Diese Funktion wurde in Qt 6.5 eingeführt.

[noexcept] QUrlQuery::~QUrlQuery()

Löscht dieses „ QUrlQuery “-Objekt.

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

Fügt das Paar „ key “ = „ value “ am Ende der Abfragezeichenfolge der URL an. Diese Methode überschreibt keine vorhandenen Einträge, die möglicherweise denselben Schlüssel haben.

Siehe auch hasQueryItem() und queryItemValue().

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

Gibt eine Liste von Query-String-Werten zurück, deren Schlüssel dem Wert „ key “ aus der URL entspricht, wobei die unter encoding angegebenen Optionen zur Kodierung des Rückgabewerts verwendet werden. Wird der Schlüssel „ key “ nicht gefunden, gibt diese Funktion eine leere Liste zurück.

Siehe auch queryItemValue() und addQueryItem().

void QUrlQuery::clear()

Löscht dieses QUrlQuery -Objekt, indem alle derzeit gespeicherten Schlüssel-Wert-Paare entfernt werden. Wenn die Abfrage-Trennzeichen geändert wurden, behält diese Funktion die geänderten Werte bei.

Siehe auch „ isEmpty()“ und „ setQueryDelimiters()“.

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

Gibt das Standardzeichen zur Trennung von Schlüssel-Wert-Paaren zurück, nämlich das Und-Zeichen („&“).

Siehe auch „ setQueryDelimiters()“, „ queryPairDelimiter()“ und „ defaultQueryValueDelimiter()“.

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

Gibt das Standardzeichen zur Trennung von Schlüsseln und Werten in der Abfrage zurück, nämlich das Gleichheitszeichen („=“).

Siehe auch setQueryDelimiters(), queryValueDelimiter() und defaultQueryPairDelimiter().

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

Gibt „ true “ zurück, wenn es ein Query-String-Paar gibt, dessen Schlüssel mit „ key “ aus der URL übereinstimmt.

Siehe auch addQueryItem() und queryItemValue().

bool QUrlQuery::isEmpty() const

Gibt „ true “ zurück, wenn dieses „ QUrlQuery “-Objekt keine Schlüssel-Wert-Paare enthält, beispielsweise nach der Initialisierung mit Standardwerten oder nach dem Parsen einer leeren Abfragezeichenfolge.

Siehe auch setQuery() und clear().

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

Gibt den rekonstruierten Abfrage-String zurück, der aus den derzeit in diesem ` QUrlQuery `-Objekt gespeicherten Schlüssel-Wert-Paaren gebildet und durch die für dieses Objekt gewählten Abfrage-Trennzeichen getrennt wird. Die Schlüssel und Werte werden unter Verwendung der durch den Parameter ` encoding ` angegebenen Optionen kodiert.

Das einzige mehrdeutige Trennzeichen für diese Funktion ist das Hash-Zeichen („#“), da es in URLs dazu dient, den Abfrage-String von dem möglicherweise darauf folgenden Fragment zu trennen.

Die Reihenfolge der Schlüssel-Wert-Paare in der zurückgegebenen Zeichenkette entspricht genau der Reihenfolge in der ursprünglichen Abfrage.

Siehe auch ` setQuery()`, ` QUrl::setQuery()`, ` QUrl::fragment()` und „Kodierung“.

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

Gibt den Abfragewert zurück, der dem Schlüssel „ key “ aus der URL zugeordnet ist, wobei die unter encoding angegebenen Optionen zur Kodierung des Rückgabewerts verwendet werden. Wenn der Schlüssel „ key “ nicht gefunden wird, gibt diese Funktion eine leere Zeichenkette zurück. Wenn Sie zwischen einem leeren Wert und einem nicht vorhandenen Schlüssel unterscheiden müssen, sollten Sie zunächst mit hasQueryItem() prüfen, ob der Schlüssel vorhanden ist.

Wenn der Schlüssel key mehrfach definiert ist, gibt diese Funktion den ersten gefundenen Wert zurück, und zwar in der Reihenfolge, in der er im Abfrage-String vorhanden war oder mit addQueryItem() hinzugefügt wurde.

Siehe auch addQueryItem(), allQueryItemValues() und „Kodierung“.

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

Gibt den Abfrage-String der URL als Map aus Schlüsseln und Werten zurück, wobei die unter encoding angegebenen Optionen zur Kodierung der Elemente verwendet werden. Die Reihenfolge der Elemente entspricht derjenigen im Abfrage-String oder der mit setQueryItems() festgelegten Reihenfolge.

Siehe auch setQueryItems() und „Kodierung“.

QChar QUrlQuery::queryPairDelimiter() const

Gibt das Zeichen zurück, das zur Trennung von Schlüssel-Wert-Paaren verwendet wird, wenn die Abfragezeichenfolge in query() rekonstruiert oder in setQuery() geparst wird.

Siehe auch setQueryDelimiters() und queryValueDelimiter().

QChar QUrlQuery::queryValueDelimiter() const

Gibt das Zeichen zurück, das zur Trennung von Schlüsseln und Werten verwendet wird, wenn die Abfragezeichenfolge in query() rekonstruiert oder in setQuery() geparst wird.

Siehe auch setQueryDelimiters() und queryPairDelimiter().

void QUrlQuery::removeAllQueryItems(const QString &key)

Entfernt alle Paare aus Abfragezeichenfolge und Schlüssel aus der URL, deren Schlüssel dem Wert „ key “ entspricht.

Siehe auch removeQueryItem().

void QUrlQuery::removeQueryItem(const QString &key)

Entfernt das Query-String-Paar, dessen Schlüssel „ key “ lautet, aus der URL. Wenn mehrere Einträge mit dem Schlüssel „ key “ vorhanden sind, wird der erste Eintrag in der Reihenfolge entfernt, in der sie im Query-String vorhanden waren oder mit addQueryItem() hinzugefügt wurden.

Siehe auch removeAllQueryItems().

void QUrlQuery::setQuery(const QString &queryString)

Analysiert die Abfragezeichenfolge in „ queryString “ und weist den internen Elementen die dort gefundenen Werte zu. Wenn mit „ setQueryDelimiters()“ Trennzeichen angegeben wurden, verwendet diese Funktion diese anstelle der Standardtrennzeichen, um die Zeichenfolge zu analysieren.

Siehe auch query().

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

Legt die Zeichen fest, die zur Trennung von Schlüsseln und Werten sowie von Schlüssel-Wert-Paaren in der Abfragezeichenfolge der URL verwendet werden. Das Standardtrennzeichen für Werte ist „=“ und das Standardtrennzeichen für Paare ist „&“.

valueDelimiter wird zur Trennung von Schlüsseln und Werten verwendet, und „ pairDelimiter “ dient zur Trennung von Schlüssel-Wert-Paaren. Alle Vorkommen dieser Trennzeichen in der kodierten Darstellung der Schlüssel und Werte der Abfragezeichenfolge werden bei der Rückgabe durch „ query()“ prozentkodiert.

Wenn „ valueDelimiter “ auf „,“ und „ pairDelimiter “ auf „;“ gesetzt ist, würde die obige Abfragezeichenfolge stattdessen wie folgt dargestellt werden:

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

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

Die Verwendung anderer Zeichen wird nicht unterstützt und kann zu unerwartetem Verhalten führen. Diese Methode überprüft nicht, ob Sie ein gültiges Trennzeichen übergeben haben.

Siehe auch queryValueDelimiter() und queryPairDelimiter().

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

Setzt die Elemente in diesem „ QUrlQuery “-Objekt auf „ query “. Die Reihenfolge der Elemente in „ query “ bleibt dabei erhalten.

Siehe auch queryItems() und isEmpty().

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

Ersetzt diese URL-Abfrageinstanz durch other. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

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

Gibt diese ` QUrlQuery ` als ` QString` zurück. Mit ` encoding ` kann die URL-Zeichenkette-Kodierung des Rückgabewerts festgelegt werden.

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

other Weist der Instanz „ QUrlQuery “ die Instanz „ “ zu.

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

Kopiert den Inhalt des Objekts „ other “ ( QUrlQuery ), einschließlich der Abfrage-Trennzeichen.