Qt之QUrlQuery

本文涉及的产品
公共DNS(含HTTPDNS解析),每月1000万次HTTP解析
全局流量管理 GTM,标准版 1个月
云解析 DNS,旗舰版 1个月
简介: 简述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();
目录
相关文章
|
7月前
|
前端开发 编译器 开发工具
Qt
Qt
348 0
|
网络协议 Java PHP
|
Linux Android开发 C++
Qt资料大全
简述 发福利了、发福利了、发福利了,重要的事情说三遍。。。 为了方便更多Qter了解、学习Qt,现将相关资源进行整理,主要内容包括:Qt官网、编码风格、GitHub &amp; Third-Party、社区论坛、博客、书籍等。 满满的都是干货,独乐乐不如众乐乐。。。 简述 Qt官网 编码风格 GitHub Third-Party 社区论坛 博客 书籍 更多
2920 0
|
算法
Qt之QTimeLine
简述 QTimeLine 类提供了用于控制动画的时间轴,通常用于通过定期调用一个槽函数来动画一个 GUI 控件。 相信了解动画的人对帧应该不陌生,可以把一个动画想象成由很多张静态画面组成,而每一个画面就是一帧图像。每隔一定时间间隔就显示一帧图像,当该间隔较短时,人眼就感觉不出来了,觉得看到的是连续的影像。 简述 详细说明 状态 方向 曲线形状 详细
2286 0
|
安全 并行计算
Qt之QFutureWatcher
简述 QFuture 表示异步计算的结果,QFutureWatcher 则允许使用信号和槽监视 QFuture,也就是说,QFutureWatcher 是为 QFuture 而生的。 简述 详细描述 基本使用 更多参考 详细描述 QFutureWatcher 提供了有关 QFuture 的信息和通知,使用 setFuture() 函数开始监视一个特
3724 0
|
Java C++
Qt之QFuture
简述 QFuture 类代表一个异步计算的结果。 要启动一个计算,使用 Qt之Concurrent框架 中的 APIs 之一。 QFuture 允许线程与一个或多个结果同步,这些结果将在稍后的时间点准备就绪,该结果可以是具有默认构造函数和拷贝构造函数的任何类型。如果一个结果在调用 result()、resultAt() 或 results() 函数时不可用,QFutur
2053 0
|
安全 Java
Qt之QThreadPool和QRunnable
简述 QRunnable 是所有 runnable 对象的基类,而 QThreadPool 类用于管理 QThreads 集合。 QRunnable 类是一个接口,用于表示一个任务或要执行的代码,需要重新实现 run() 函数。 QThreadPool 管理和循环使用单独的 QThread 对象,以帮助程序减少创建线程的成本。每个 Qt 应用程序都有一个全局 QThre
3597 0
Qt之QScrollArea
简述 QScrollArea提供了一个滚动视图到另一个部件。 滚动区域用于显示一个画面中的子部件的内容。如果部件超过画面的大小,视图可以提供滚动条,这样就都可以看到部件的整个区域。 简述 基本使用 对齐方式 调整部件大小 手动调整 自动调整 获取与移除部件 获取 移除 基本使用 子部件必须使用setWidget()指定,例如: QLab
3253 0
Qt之QDateTimeEdit
简述 QDateTime类提供了一个部件,用于编辑日期和时间。 QDateTimeEdit允许用户编辑日期,通过使用键盘或箭头键来增加和减少日期和时间值。箭头键可以在QDateTimeEdit内进行部分移动,日期和时间的格式按照setDisplayFormat()设置的显示。 简述 基本使用 效果 源码 日期时间格式 效果 源码 日期时间范围 效果
2727 0