QUrlQuery Class

Dokumentation der Mitgliedsfunktionen

QUrlQuery::QUrlQuery()

Konstruiert ein leeres QUrlQuery-Objekt. Eine Abfrage kann anschließend durch den Aufruf von setQuery() gesetzt werden, oder Elemente können mit addQueryItem() hinzugefügt werden.

Siehe auch setQuery() und addQueryItem().

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

Konstruiert ein QUrlQuery-Objekt und analysiert den Abfrage-String queryString unter Verwendung der Standard-Abfragebegrenzer. Um einen Abfrage-String mit anderen Begrenzungszeichen zu analysieren, sollten Sie diese zuerst mit setQueryDelimiters() und dann die Abfrage mit setQuery() setzen.

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

Konstruiert ein QUrlQuery-Objekt und analysiert den in der URL url gefundenen Abfrage-String unter Verwendung der Standard-Abfragebegrenzer. Um einen Abfrage-String mit anderen Begrenzungszeichen zu analysieren, sollten Sie diese zuerst mit setQueryDelimiters() und dann die Abfrage mit setQuery() setzen.

Siehe auch QUrl::query().

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

Konstruiert ein QUrlQuery-Objekt aus dem list von Schlüssel/Wert-Paar.

QUrlQuery::QUrlQuery(const QUrlQuery &other)

Kopiert den Inhalt des Objekts other QUrlQuery, einschließlich der Abfragebegrenzer.

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

Verschiebt den Inhalt des other QUrlQuery-Objekts, einschließlich der Abfragebegrenzer.

Diese Funktion wurde in Qt 6.5 eingeführt.

[noexcept] QUrlQuery::~QUrlQuery()

Zerstört dieses QUrlQuery Objekt.

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

Hängt das Paar key = value an das Ende des Abfrage-Strings der URL an. Diese Methode überschreibt keine vorhandenen Elemente, die möglicherweise mit demselben Schlüssel vorhanden sind.

Siehe auch hasQueryItem() und queryItemValue().

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

Gibt eine Liste von Abfrage-Stringwerten zurück, deren Schlüssel gleich key aus der URL ist, wobei die in encoding angegebenen Optionen zur Kodierung des Rückgabewerts verwendet werden. Wenn der Schlüssel key nicht gefunden wird, 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 Abfragebegrenzer geändert wurden, belässt diese Funktion sie mit ihren geänderten Werten.

Siehe auch isEmpty() und setQueryDelimiters().

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

Gibt das Standardzeichen zum Trennen von Schlüssel-Wert-Paaren zurück, ein kaufmännisches Und ("&").

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

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

Gibt das Standardzeichen zum Trennen von Schlüsseln und Werten in der Abfrage zurück, ein 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, z. B. nach einer Standardkonstruktion oder nach dem Parsen einer leeren Abfragezeichenfolge.

Siehe auch setQuery() und clear().

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

Gibt die rekonstruierte Abfragezeichenfolge zurück, die aus den derzeit in diesem QUrlQuery Objekt gespeicherten Schlüssel-Wert-Paaren gebildet und durch die für dieses Objekt gewählten Abfragebegrenzer getrennt wurde. Die Schlüssel und Werte werden mit den im Parameter encoding angegebenen Optionen kodiert.

Bei dieser Funktion ist das einzige mehrdeutige Trennzeichen die Raute ("#"), da sie in URLs verwendet wird, um den Abfrage-String von dem eventuell folgenden Fragment zu trennen.

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

Siehe auch setQuery(), QUrl::setQuery(), QUrl::fragment(), und Encoding.

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

Gibt den mit dem Schlüssel key verbundenen Abfragewert aus der URL zurück, wobei die in 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 existierenden Schlüssel unterscheiden müssen, sollten Sie das Vorhandensein des Schlüssels zuerst mit hasQueryItem() überprüfen.

Wenn der Schlüssel key mehrfach definiert ist, gibt diese Funktion den ersten gefundenen Schlüssel zurück, und zwar in der Reihenfolge, in der sie in der Abfragezeichenfolge vorhanden waren oder mit addQueryItem() hinzugefügt wurden.

Siehe auch addQueryItem(), allQueryItemValues(), und Encoding.

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

Gibt die Abfragezeichenkette der URL als Karte von Schlüsseln und Werten zurück, wobei die in encoding angegebenen Optionen zur Kodierung der Elemente verwendet werden. Die Reihenfolge der Elemente entspricht derjenigen, die in der Abfragezeichenfolge gefunden oder mit setQueryItems() festgelegt wurde.

Siehe auch setQueryItems() und Encoding.

QChar QUrlQuery::queryPairDelimiter() const

Gibt das Zeichen zurück, das zur Abgrenzung zwischen Schlüssel-Wert-Paaren bei der Rekonstruktion der Abfragezeichenfolge in query() oder beim Parsen in setQuery() verwendet wird.

Siehe auch setQueryDelimiters() und queryValueDelimiter().

QChar QUrlQuery::queryValueDelimiter() const

Gibt das Zeichen zurück, das zur Abgrenzung zwischen Schlüsseln und Werten bei der Rekonstruktion der Abfragezeichenfolge in query() oder beim Parsen in setQuery() verwendet wird.

Siehe auch setQueryDelimiters() und queryPairDelimiter().

void QUrlQuery::removeAllQueryItems(const QString &key)

Entfernt alle Abfrage-String-Paare, deren Schlüssel gleich key ist, aus der URL.

Siehe auch removeQueryItem().

void QUrlQuery::removeQueryItem(const QString &key)

Entfernt das Abfragezeichenfolgenpaar, dessen Schlüssel gleich key ist, aus der URL. Wenn es mehrere Elemente mit einem Schlüssel gleich key gibt, wird das erste Element in der Reihenfolge entfernt, in der sie in der Abfragezeichenfolge vorhanden waren oder mit addQueryItem() hinzugefügt wurden.

Siehe auch removeAllQueryItems().

void QUrlQuery::setQuery(const QString &queryString)

Analysiert die Abfragezeichenfolge in queryString und setzt die internen Elemente auf die dort gefundenen Werte. Wenn mit setQueryDelimiters() Begrenzungszeichen angegeben wurden, verwendet diese Funktion diese anstelle der Standardbegrenzungszeichen zum Parsen der Zeichenkette.

Siehe auch query().

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

Legt die Zeichen fest, die zur Abgrenzung zwischen Schlüsseln und Werten sowie zwischen Schlüssel-Wert-Paaren im Abfrage-String der URL verwendet werden. Das Standard-Wert-Trennzeichen ist '=' und das Standard-Paar-Trennzeichen ist '&'.

valueDelimiter wird verwendet, um Schlüssel von Werten zu trennen, und pairDelimiter wird verwendet, um Schlüssel-Wert-Paare zu trennen. Alle Vorkommen dieser Begrenzungszeichen in der kodierten Darstellung der Schlüssel und Werte der Abfragezeichenfolge werden in Prozent kodiert, wenn sie in query() zurückgegeben werden.

Wenn valueDelimiter auf ',' gesetzt ist und pairDelimiter ';' 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 von anderen Zeichen wird nicht unterstützt und kann zu unerwartetem Verhalten führen. Diese Methode überprüft nicht, ob Sie ein gültiges Begrenzungszeichen ü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 erhalten.

Siehe auch queryItems() und isEmpty().

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

Tauscht diese URL-Abfrageinstanz mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

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

Gibt diese QUrlQuery als QString zurück. encoding kann verwendet werden, um die URL-String-Kodierung des Rückgabewerts anzugeben.

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

Verschieben - weist other dieser QUrlQuery Instanz zu.

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

Kopiert den Inhalt des Objekts other QUrlQuery , einschließlich der Abfragebegrenzer.