QUrlQuery 类

成员函数文档

QUrlQuery::QUrlQuery()

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

也请参阅setQuery()和addQueryItem。

[显式] QUrlQuery::QUrlQuery(const QUrl &url)

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

也请参阅QUrl::query。

[显式] QUrlQuery::QUrlQuery(const QString &queryString)

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

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

从一个键值对列表list构建一个QUrlQuery对象。

QUrlQuery::QUrlQuery(const QUrlQuery &other)

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

[异常，自6.5版起] QUrlQuery::QUrlQuery(QUrlQuery &&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

返回从 URL 中键等于 key 的查询字符串值的列表，使用 encoding 中指定的选项来编码返回值。如果找不到 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

如果从 URL 中存在查询字符串对，其键等于 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() 和 Encoding.

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()。

[无异常] void QUrlQuery::swap(QUrlQuery &other)

交换此 URL 查询实例与 other。此函数非常快，永远不会失败。

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

将此 QUrlQuery 转换为 QString。可以使用 encoding 指定返回的 URL 字符串编码。

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

如果 other 不等于此 QUrlQuery，则返回 true。否则返回 false。

另请参阅operator==()。

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

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

[无异常] QUrlQuery &QUrlQuery::operator=(QUrlQuery &&other)

将 other 移动分配到此 QUrlQuery 实例。

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

如果此对象和 other 对象包含相同的内容、相同的顺序，并使用相同的查询分隔符，则返回 true。