Qt之QUrlQuery

本文涉及的产品
云解析 DNS,旗舰版 1个月
全局流量管理 GTM,标准版 1个月
公共DNS(含HTTPDNS解析),每月1000万次HTTP解析
简介: 简述QUrlQuery 类提供了一种方法来操纵 URL 查询中的 key-value 对。简述详细描述编码处理空格和加号 全解码非标准分隔符使用QUrlQuery分隔符查询删除是否为空详细描述QUrlQuery 用来解析 URL 中的查询字符串,像下面这样:上述的查询字符串在 URL 中 被用来传输

简述

QUrlQuery 类提供了一种方法来操纵 URL 查询中的 key-value 对。

详细描述

QUrlQuery 用来解析 URL 中的查询字符串,像下面这样:

这里写图片描述

上述的查询字符串在 URL 中 被用来传输选项,通常解码为多个 key-value 对。其列表包含了的两个条目,键为“type”和 “color”。QUrlQuery 也适用于从查询的各个组成部分创建一个查询字符串,为了 在 QUrl::setQuery() 中使用。

解析一个查询字符串最常见的方式是在构造函数中始化它,通过传递一个查询字符串。否则,可以使用 setQuery() 函数来设置要解析的查询。该函数也可用于解析具有非标准分割符的查询,在设置它们之后使用 setQueryDelimiters() 函数。

编码的查询字符串可以再次使用 query() 获得,这需要所有的内部存储项,并使用分隔符编码字符串。

编码

QUrlQuery 中的所有 getter 函数均支持一个可选参数QUrl::ComponentFormattingOptions 类型,包括 query(),它决定如何编码数据。除了 QUrl::FullyDecoded,返回值必须被视为一个百分比编码字符串。由于某些值不能在解码形式(如控制字符,字节序列不能被解码为 UTF-8)来表达。出于这个原因,百分比字符总是由字符串“%25”表示。

处理空格和加号 (“+”)

空格应该被编码成加号 ("+"),而如果字符本身就是加号 ("+"),则应该被编码成百分比编码格式 (%2B)然而,互联网规范管理 URL 不认为空格和加号字符等价。

由于这样,QUrlQuery 不会将空格字符编码为 "+",也不会将 "+" 解码为一个空格字符。相反,空格字符将在编码形式中呈现 "%20"

为了支持这样的 HTML 表单编码,QUrlQuery 既不会将 "%2B" 序列解码为一个加号,也不会编码一个加号。事实上,任何键、值、查询字符串中的 "%2B""+" 序列完全像写的一样 (除了 "%2b""%2B" 大写转换)。

全解码

使用 QUrl:: FullyDecoded 格式化,所有百分比编码序列将被完全解码,并且 '%' 字符用于表示本身。应小心使用 QUrl::FullyDecoded,因为可能会导致数据丢失。

这种格式化模式应该只在这种情况下使用:当在不期望百分比编码的上下文中处理呈献给用户的文本时。

注意: QUrlQuery setters 和 query 函数不支持对应 QUrl::DecodedMode 解析,所以使用 QUrl::FullyDecoded 获得 keys 列表可能导致在对象不能找到 keys 。

非标准分隔符

默认情况下,QUrlQuery 使用等号 ("=") 来分隔 key 和 value,符号 ("&") 分割彼此的 key-value 对 。通过调用 setQueryDelimiters(),可以改变 QUrlQuery 用于解析和重构查询的分隔符。

非标准分隔符在 RFC 3986 的“sub-delimiters”中:

sub-delims = “!” / “$” / “&” / “’” / “(” / “)”
/ “*” / “+” / “,” / “;” / “=”

不支持使用其他字符,可能会导致意外的行为。QUrlQuery 不验证是否传递了一个有效的分隔符。

使用

想必大家对知乎都很熟悉了,假如我们要搜索关于“Qt”的相关内容,通常会在搜索栏中输入关键字“Qt”,然后点击【搜索】按钮进行查找。

这里写图片描述

这时,观察浏览器中的网址,URL 如下:

http://www.zhihu.com/search?type=content&q=Qt

如果要构造一个这样的 URL,按照传统方式,一般是手动拼接字符串:

// 基本 URL
QString baseUrl = "http://www.zhihu.com/search?";

// 设置发送的数据
QByteArray bytes;
bytes.append("type=content&");
bytes.append(QString("q=%1").arg("Qt"));  // Qt 作为变量输入

// 组合 URL
baseUrl += bytes;

QUrl url(baseUrl);

qDebug() << url;

显然可以实现,但相比之下,QUrlQuery 更为简单、方便。而且QUrlQuery 还提供了很多其他便利的接口。

QUrlQuery

使用 addQueryItem:

// 基本 URL
QString baseUrl = "http://www.zhihu.com/search";
QUrl url(baseUrl);

// key-value 对
QUrlQuery query;
query.addQueryItem("type", "content");
query.addQueryItem("q", "Qt");

url.setQuery(query);

qDebug() << url;

使用 setQueryItems:

// 基本 URL
QString baseUrl = "http://www.zhihu.com/search";
QUrl url(baseUrl);

QUrlQuery query;

// key-value 对
QPair<QString, QString> pair;
pair.first = "type";
pair.second = "content";

QPair<QString, QString> pair2;
pair2.first = "q";
pair2.second = "Qt";

QList<QPair<QString, QString> > items;
items << pair << pair2;

query.setQueryItems(items);
url.setQuery(query);

qDebug() << url;

使用 setQuery:

// 基本 URL
QString baseUrl = "http://www.zhihu.com/search";
QUrl url(baseUrl);

// 查询字符串
QUrlQuery query;
query.setQuery("type=content&q=Qt");

url.setQuery(query);

qDebug() << url;

分隔符

默认情况下,各个 key-value 对之间的分隔符为 '&',而 key-value 之间的分隔符为 '='

QChar pair = query.queryPairDelimiter();  // '&'
QChar value = query.queryValueDelimiter();  // '='

如果要改变默认的分隔符,使用 setQueryDelimiters():

query.setQueryDelimiters('(', ')');

这时,URL 就会变为这样:

QUrl(“http://www.zhihu.com/search?type(content)q(Qt“)

查询

查询所有的 key-value 对:

QList<QPair<QString, QString> > list = query.queryItems();
// (QPair("type","content"), QPair("q","Qt"))

查询指定 key 对应的 value:

QString value = query.queryItemValue("q");
// "Qt"

查询 key-value 对合并的字符串:

QString queryString = url.query();
// "type=content&q=Qt"

查询指定 key 是否存在:

bool exist = query.hasQueryItem("q");
// true

如果存在返回 true, 否则返回 false.

删除

删除指定 key 对应的 key-value 对:

query.removeQueryItem("q");

清空当前存储的所有 key-value 对:

query.clear();

是否为空

如果 QUrlQuery 对象不包含 key-value 对,则返回 true;否则,返回 false。

query.isEmpty();
目录
相关文章
|
开发框架 Linux API
2023-6-1-Qt是什么
2023-6-1-Qt是什么
109 0
|
存储
Qt之QLCDNumber
Qt之QLCDNumber
366 0
|
Linux Android开发 C++
Qt资料大全
简述 发福利了、发福利了、发福利了,重要的事情说三遍。。。 为了方便更多Qter了解、学习Qt,现将相关资源进行整理,主要内容包括:Qt官网、编码风格、GitHub &amp; Third-Party、社区论坛、博客、书籍等。 满满的都是干货,独乐乐不如众乐乐。。。 简述 Qt官网 编码风格 GitHub Third-Party 社区论坛 博客 书籍 更多
2893 0
|
Java C++
Qt之QFuture
简述 QFuture 类代表一个异步计算的结果。 要启动一个计算,使用 Qt之Concurrent框架 中的 APIs 之一。 QFuture 允许线程与一个或多个结果同步,这些结果将在稍后的时间点准备就绪,该结果可以是具有默认构造函数和拷贝构造函数的任何类型。如果一个结果在调用 result()、resultAt() 或 results() 函数时不可用,QFutur
2041 0
|
索引
Qt之QToolBox
简述 QToolBox类提供了一个列(选项卡式的)部件条目。 QToolBox可以在一个tab列上显示另外一个,并且当前的item显示在当前的tab下面。每个tab都在tab列中有一个索引位置。tab的item是一个QWidget 。 简述 详细描述 使用 效果 源码 详细描述 每个item都有一个itemText()、一个可选的itemI
2514 0
Qt之QDateEdit和QTimeEdit
简述 QDateEdit类提供了一个部件,用于编辑日期。QTimeEdit类提供了一个部件,用于编辑时间。 简述 详细描述 基本使用 各司其职 莫强求 更多参考 详细描述 QDateEdit和QTimeEdit均继承自QDateTimeEdit,许多特性和功能都有QDateTimeEdit提供。这些都是相关属性: QDateEdit da
2923 0
|
Windows
Qt之QProgressBar
简述 QProgressBar部件提供了一个水平或垂直进度条。 进度条用于给用户操作一个进度指示,并向它们说明应用程序仍在运行。 简述 详细描述 读取方向 进度方向 效果 源码 文本显示 效果 源码 繁忙指示 效果 源码 QSS 详细描述 可以通过setRange()来设置进度的最小值和最大值(取值范围),也可使用setMinimum(
2754 0
|
网络协议 存储
Qt之QNetworkAddressEntry
简述 QNetworkAddressEntry类由网络接口支持,存储了一个IP地址,子网掩码和广播地址。 每个网络接口可以包含零个或多个IP地址,进而可以关联到一个子网掩码和/或一个广播地址(取决于操作系统的支持)。 这个类代表一个这样的组。 简述 常用接口 使用 更多参考 常用接口 QHostAddress broadcast() co
1793 0
|
Windows
Qt之QSystemTrayIcon
简述 QSystemTrayIcon类为应用程序在系统托盘中提供一个图标。 现代操作系统通常在桌面上提供一个特殊的区域,称为系统托盘或通知区域,长时间运行的应用程序可以显示图标和短消息。 简述 内容 详细描述 共有类型 共有函数 公有槽函数 信号 静态共有函数 示例 效果 源码 内容 详细描述 要检查系统托盘是否存在在用户的桌面
2024 0