QUrlQuery Class

成员函数文档

QUrlQuery::QUrlQuery()

构造一个空的 QUrlQuery 对象。之后可通过调用setQuery() 设置查询，或通过addQueryItem() 添加项目。

另请参阅 setQuery() 和addQueryItem()。

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

构造一个 QUrlQuery 对象，并使用默认的查询分隔符解析queryString 查询字符串。要使用其他分隔符解析查询字符串，应首先使用setQueryDelimiters() 设置分隔符，然后使用setQuery() 设置查询。

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

构造一个 QUrlQuery 对象，并使用默认查询分隔符解析url URL 中的查询字符串。要使用其他分隔符解析查询字符串，应首先使用setQueryDelimiters() 设置分隔符，然后使用setQuery() 设置查询。

另请参阅 QUrl::query()。

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

从list 的键/值对中构造一个 QUrlQuery 对象。

QUrlQuery::QUrlQuery(const QUrlQuery &other)

复制other QUrlQuery 对象的内容，包括查询分隔符。

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

移动other QUrlQuery 对象的内容，包括查询分隔符。

此函数在 Qt 6.5 中引入。

[noexcept] QUrlQuery::~QUrlQuery()

销毁QUrlQuery 对象。

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

将key =value 添加到 URL 查询字符串的末尾。此方法不会覆盖可能存在的具有相同密钥的项目。

另请参阅 hasQueryItem() 和queryItemValue()。

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

使用encoding 中指定的选项对返回值进行编码，返回 URL 中键等于key 的查询字符串值列表。如果未找到键key ，该函数将返回空列表。

另请参阅 queryItemValue() 和addQueryItem()。

void QUrlQuery::clear()

删除当前存储的所有键值对，从而清除QUrlQuery 对象。如果查询分隔符已更改，该函数将保留更改后的值。

另请参阅 isEmpty() 和setQueryDelimiters()。

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

返回用于分隔键值对的默认字符，即"&"。

另请参阅 setQueryDelimiters()、queryPairDelimiter() 和defaultQueryValueDelimiter()。

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

返回查询中用于分隔键和值的默认字符，即等号（"="）。

另请参阅 setQueryDelimiters()、queryValueDelimiter() 和defaultQueryPairDelimiter()。

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

如果存在键等于key 的查询字符串对，则返回true 。

另请参阅 addQueryItem() 和queryItemValue()。

bool QUrlQuery::isEmpty() const

如果QUrlQuery 对象不包含键值对，例如在默认构造或解析空查询字符串后，则返回true 。

另请参阅 setQuery() 和clear()。

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

返回重建的查询字符串，该字符串由当前存储在QUrlQuery 对象中的键值对组成，并用为该对象选择的查询分隔符分隔。键和值使用encoding 参数给出的选项进行编码。

在该函数中，唯一不明确的分隔符是散列（"#"），因为在 URL 中，它用于分隔查询字符串和后面的片段。

返回字符串中键值对的顺序与原始查询完全相同。

另请参阅 setQuery()、QUrl::setQuery()、QUrl::fragment() 和Encoding。

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

使用encoding 中指定的选项对返回值进行编码，从 URL 返回与关键字key 相关联的查询值。如果未找到键key ，该函数将返回空字符串。如果需要区分空值和不存在的键，应首先使用hasQueryItem() 检查键是否存在。

如果密钥key 是多重定义的，该函数将按照查询字符串中存在的顺序或使用addQueryItem() 添加的顺序，返回找到的第一个密钥。

另请参阅 addQueryItem(),allQueryItemValues() 和Encoding。

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

使用encoding 中指定的选项对项目进行编码，以键和值映射的形式返回 URL 的查询字符串。元素的顺序与查询字符串中的顺序或使用setQueryItems() 设置的顺序相同。

另请参阅 setQueryItems() 和编码。

QChar QUrlQuery::queryPairDelimiter() const

在query() 中重构查询字符串或在setQuery() 中进行解析时，返回键值对之间用于分隔的字符。

另请参阅 setQueryDelimiters() 和queryValueDelimiter()。

QChar QUrlQuery::queryValueDelimiter() const

在query() 中重构查询字符串或在setQuery() 中进行解析时，返回键和值之间的分界字符。

另请参阅 setQueryDelimiters() 和queryPairDelimiter()。

void QUrlQuery::removeAllQueryItems(const QString &key)

从 URL 中删除键等于key 的所有查询字符串对。

另请参阅 removeQueryItem().

void QUrlQuery::removeQueryItem(const QString &key)

从 URL 中删除键等于key 的查询字符串对。如果有多个项目的关键字等于key ，则会按照它们在查询字符串中出现的顺序或使用addQueryItem() 添加的顺序删除第一个项目。

另请参阅 removeAllQueryItems()。

void QUrlQuery::setQuery(const QString &queryString)

解析queryString 中的查询字符串，并将内部项设置为其中的值。如果使用setQueryDelimiters() 指定了分隔符，该函数将使用这些分隔符而不是默认分隔符来解析字符串。

另请参见 query()。

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

设置 URL 查询字符串中键和值之间以及键值对之间的分隔符。默认值分隔符为"="，默认键值对分隔符为"&"。

valueDelimiter 用于分隔键和值， 用于分隔键值对。在 () 中返回查询字符串的键和值的编码表示时，这些分隔符的任何出现都将按百分比编码。pairDelimiter query

如果valueDelimiter 设置为','，而pairDelimiter 设置为';'，则上述查询字符串的表示方法如下：

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

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

不支持使用其他字符，否则可能导致意外行为。此方法不会验证您是否传递了有效的分隔符。

另请参阅 queryValueDelimiter() 和queryPairDelimiter()。

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

将QUrlQuery 对象中的项目设置为query 。query 中元素的顺序保持不变。

另请参阅 queryItems() 和isEmpty()。

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

将此 URL 查询实例与other 互换。该操作速度非常快，而且从未出现过故障。

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

QUrlQuery QString encoding 可用于指定返回值的 URL 字符串编码。

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

Move-assignsother 到此QUrlQuery 实例。

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

复制other QUrlQuery 对象的内容，包括查询分隔符。