Qt QUrl讲解

最新推荐文章于 2024-04-30 16:48:07 发布
最新推荐文章于 2024-04-30 16:48:07 发布
阅读量4.2k 收藏 17
点赞数 3
分类专栏： QT开发 文章标签： qt ui qt教程 qt开发 qt6
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_73443478/article/details/128469184
版权

简述

QUrl 类提供了一个方便的接口使用 URLs。

它可以解析和构造编码和未编码形式的 URLs。QUrl 也支持国际化域名（IDNs）。

详细描述

最常见的使用QUrl 的方式是通过构造函数来初始化，传递一个 QString 参数。

QUrl url("https://github.com/");

然而，也可以使用 setUrl()。

1 QUrl url;
2 url.setUrl("https://github.com/");

也可以逐渐地构造 URL，通过调用 setScheme()、setUserName()、setPassword()、setHost()、setPort()、setPath()、setQuery() 和 setFragment()。一些方便的函数也可供使用：setAuthority() 设置用户名、密码、主机和端口。setUserInfo() 设置用户名和密码。

URLs 可以用两种形式表示：编码或未编码。未编码形式适用于显示给用户，编码形式通常会发送到一个 Web 服务器。例如，未编码的URL "http://bühler.example.com/List of applicants.xml" 将被发送到服务器为 "http://xn--bhler-kva.example.com/List%20of%20applicants.xml" 。

可以使用 toString() 来获取 URL 人类可读的表示。这种表示方法适合以未编码形式将 URL 显示给用户。然而，编码的形式由 toEncoded() 返回，仅供内部使用，传递给 Web 服务器、邮件客户等。两种形式在技术上正确、明确地表示相同的 URL - 事实上，传递任何一种形式给 QUrl 的构造函数或使用 setUrl() 都将产生相同的 QUrl 对象。

QUrl 符合 RFC 3986 （统一资源标识符：通用的语法）中的 URL 规范，包括 RFC 1738 （统一资源定位器）中方案的扩展。如果 QUrl 中的折叠规则符合 RFC 3491 ，它还兼容 file URI specification 来自 freedesktop.org，提供使用 UTF-8（IDN 要求） 本地编码编码的文件名。

RFC 3491 是“Nameprep: A Stringprep Profile for Internationalized Domain Names (IDN)”，描述了如何准备一个国际化域名，包括对一个域名字段进行映射、正规化以及禁止性过滤等等操作。

本文福利，莬费领取Qt开发学习资料包、技术视频，内容包括（C++语言基础，Qt编程入门，QT信号与槽机制，QT界面开发-图像绘制，QT网络，QT数据库编程，QT项目实战，QT嵌入式开发，Quick模块，面试题等等）↓↓↓↓↓↓见下面↓↓文章底部点击莬费领取↓↓

错误检查

在 URL 解析或使用单独的 setter 函数（例如：setScheme()、setHost() 或 setPath()）设置 URL 的组成部分时，QUrl 能够检测许多错误。如果解析或 setter 函数成功，任何先前记录的错误条件将被丢弃。

默认情况下, QUrl 的 setter 函数操作在 QUrl::TolerantMode 解析模式下，这意味着他们接受一些常见错误和不实数据。解析的另一种方式是 QUrl::StrictMode，这适用于进一步检查。详见 QUrl::ParsingMode 描述不同的解析模式。

QUrl 只检查符合规范的 URL。它并不试图验证被处理程序预期的高层协议的 URLs 格式。例如，下面的 URIs 都被 QUrl 认为是有效，即使在使用时他们不合理：

  • "http:/filename.html"
  • "mailto://example.com"

当解析器遇到错误时，它通过信号事件 isValid() 返回 false，并且 toString() / toEncoded() 返回一个空字符串。如果需要将 URL 未能解析的原因显示给用户，可以通过调用 QUrl 的 errorString() 来获得错误条件。注意：这个信息是高度技术性的，可能对于用户没有意义。

QUrl 仅能够记录一个错误条件。如果找到一个以上错误，没有定义报告哪个错误。

字符转换

遵循这些原则，以避免在处理 URL 和字符串时，出现错误的字符转换：

  • 当从一个 QByteArray 或一个char * 创建包含 URL 的 QString 时，记得要用 QString::fromUtf8()。

URL格式

scheme

scheme 指定使用的传输协议，它由 URL 起始部分的一个或多个 ASCII 字符表示。scheme 只能包含 ASCII 字符，对输入不做转换或解码，必须以 ASCII 字母开始。

scheme 严格兼容 RFC 3986：scheme = ALPHA *( ALPHA / DIGIT / “+” / “-” / “.” )

协议

描述

file

资源是本地计算机上的文件。格式：file:///，注意后边应是三个斜杠。

ftp

通过 FTP 访问资源。格式：FTP://

gopher

通过 Gopher 协议访问该资源。

http

通过 HTTP 访问该资源。格式：HTTP://

https

通过安全的 HTTPS 访问该资源。格式：HTTPS://

mailto

资源为电子邮件地址，通过 SMTP 访问。格式：mailto:

MMS

通过支持MMS（流媒体）协议的播放该资源（代表软件：Windows Media Player）。格式：MMS://

ed2k

通过 支持ed2k（专用下载链接）协议的P2P软件访问该资源（代表软件：电驴）。格式：ed2k://

Flashget

通过 支持Flashget:（专用下载链接）协议的P2P软件访问该资源（代表软件：快车）。格式： Flashget://

thunder

通过 支持thunder（专用下载链接）协议的 P2P 软件访问该资源（代表软件：迅雷）。格式： thunder://

news

通过 NNTP 访问该资源。

下图显示了一个 URL，其 scheme 是 ftp：

要设置 scheme，使用以下方式：

1 QUrl url;
2 url.setScheme("ftp");

Authority

URL 的 authority 由用户信息、主机名和端口组成。所有这些元素都是可选的，即使 authority 为空，也是有效的。

格式：username:password@hostname:port

用户信息和主机由'@' 分割，主机和端口由 ':'分割 。如果用户信息为空，'@' 必须被省略。尽管端口为空时，允许使用 ':'。

 

host：指存放资源的服务器的域名系统（DNS）主机名或 IP 地址。

port：整数，可选，省略时使用方案的默认端口，各种传输协议都有默认的端口号，如 HTTP 的默认端口为80。如果输入时省略，则使用默认端口号。有时候出于安全或其他考虑，可以在服务器上对端口进行重定义，即采用非标准端口号，此时，URL 中就不能省略端口号这一项。

user info

user info 指用户信息，是 URL 中 authority 可选的一部分。

用户信息包括：用户名和一个可选的密码，由 ':' 分割。 如果密码为空，':'必须被省略。

 

path

由零或多个 / 隔开的字符串，一般用来表示主机上的一个目录或文件地址。在 authority 之后，query 之前。

 对于没有层级的 schemes，路径将是 scheme 后的所有部分，像下面这样：

 

query

query 指查询字符串，可选，用于给动态网页（例如：使用 CGI、ISAPI、PHP/JSP/ASP/ASP、.NET 等技术制作的网页）传递参数，可有多个参数，用 & 隔开，每个参数的名和值用 = 隔开。

 

fragment

fragment 指定网络资源中的片断。是 URL 的最后一部分，由'#' 后面跟的字符串表示。通常指的是用于 HTTP 页面上的某个链接或点。

例如：一个网页中有多个名词解释，可使用 fragment 直接定位到某一名词解释。

 

fragment 有时也被称为 URL“引用”。

传递一个 QString()（null 字符串）将取消 fragment 的设置。传递一个参数 QString(“”)（空而非 null 字符串）将 fragment 设置为一个空字符串（和原始 URL 一样，只有一个 "#")。

深入使用

相对路径

调用 isRelative() 可以判断 URL 是否是相对的。一个相对的 URL 可以被转变通过将它作为参数传递给 resolved()，会返回一个绝对 URL。isParentOf() 用来确定一个 URL 是否是另一个的 parent。

QUrl resolved(const QUrl &relative) const

如果 relative 不是一个相对 URL，该函数会直接返回 relative。否则，这两个 URL 的路径会进行合并，返回的新 URL 会有 base URL 的 scheme 和 authority。

合并后的路径，就像下面这样：

1 QUrl baseUrl("http://qt.digia.com/Support/");
2 QUrl relativeUrl("../Product/Library/");
3 qDebug(baseUrl.resolved(relativeUrl).toString());
4 // 打印 "http://qt.digia.com/Product/Library/"

调用 resolved() 使用 ".."，返回原始目录的上级目录。同样，使用 "../.." 将返回上上一层目录。如果 relative 是 "/"，路径会变成 "/"。

用户输入

[static] QUrl fromUserInput(const QString &userInput)

可以被扣除，返回一个 userInput 指定的有效 URL；如果不能，则会返回一个空 QURL。

大多数应用程序，可以浏览网页，允许用户输入一个 URL 形式的简单字符串。此字符串可以手动输入到地址栏，从剪贴板中获得，或者通过命令行参数传递。

当没有一个有效的 URL 字符串时，执行最好的猜测，使各种web相关的假设。

当字符串对应系统上的一个有效文件路径时，会构造一个 file:// URL，使用 QUrl::fromLocalFile()。

如果不是这种情况，试图把字符串变成一个 http:// 或 ftp:// URL。这时，后者字符串从以 'ftp' 开始。结果然后通过 QUrl 的 tolerant 解析器传递，如果成功，则会返回一个有效的 QUrl；否则，返回 QUrl()。

例如：

  • qt-project.org -> http://qt-project.org
  • ftp.qt-project.org -> ftp://ftp.qt-project.org
  • hostname -> http://hostname
  • /home/user/test.html -> file:///home/user/test.html

文件名

QString fileName(ComponentFormattingOptions options = FullyDecoded) const

返回文件的名称，包括目录路径。

注意：如果这个 QUrl 对象路径以斜杠结束，文件的名称是空的。

如果路径不包含任何斜线，完全返回作为文件名。

示例：

QUrl url("http://qt-project.org/support/file.html");
// url.adjusted(RemoveFilename) == "http://qt-project.org/support/"
// url.fileName() == "file.html"

参数 options 控制如何格式化文件名称组成。所有值产生一个明确的结果。使用 QUrl::FullyDecoded，所有百分比编码序列被解码；否则，返回值可能包含在QString的编码形式不能表示的一些百分比编码序列。

主机、端口

例如，通过 socket 连接到一个指定 QUrl 包含的主机、端口：

1 QTcpSocket sock;
2 sock.connectToHost(url.host(), url.port(80));

本地文件

可以使用 fromLocalFile() 构造一个 QUrl，通过传递一个本地文件路径。toLocalFile() 将一个 URL 转换为本地文件路径。

QUrl url = QUrl::fromLocalFile("E:\\Qt.txt");
// QUrl("file:///E:/Qt.txt")

百分比编码

为方便生成编码 URL 字符串或查询字符串，有两个静态函数：fromPercentEncoding() 和 toPercentEncoding()，处理编码和解码的百分比 QString 对象。

[static] QByteArray toPercentEncoding(const QString &input, const QByteArray &exclude = QByteArray(), const QByteArray &include = QByteArray())

返回一个编码的输入副本 。输入首先转换为 UTF-8，没有在无限制组中的所有 ASCII 字符是百分比编码的。 为了防止字符变为百分比编码，可以将他们传递给 exclude，为了迫使字符变为百分比编码，将他们传递给 include。

无限制的定义是：ALPHA / DIGIT / “-” / “.” / “_” / “~”

1 QByteArray ba = QUrl::toPercentEncoding("{a fishy string?}", "{}", "s");
2 qDebug(ba.constData());
3 // 打印 "{a fi%73hy %73tring%3F}"

有效性

构建一个 URL 后，可以在任何时候调用 isValid()，来检查 URL 的有效性。如果返回 false，应该在继续之前 clear() URL，或通过为 setUrl() 传递一个新的 URL 重新开始。

bool isValid() const

URL 运行通过一致性测试。URL 的每一部分都必须符合 URI 标准的标准编码规则，URL 才是有效的。

1 bool checkUrl(const QUrl &url) {
2     if (!url.isValid()) {
3         qDebug(QString("Invalid URL: %1").arg(url.toString()));
4         return false;
5     }
6 
7     return true;
8 }

本文福利，莬费领取Qt开发学习资料包、技术视频，内容包括（C++语言基础，Qt编程入门，QT信号与槽机制，QT界面开发-图像绘制，QT网络，QT数据库编程，QT项目实战，QT嵌入式开发，Quick模块，面试题等等）↓↓↓↓↓↓见下面↓↓文章底部点击莬费领取↓↓

十年编程老舅
关注
  • 3
    点赞
  • 踩
  • 17
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
QT的QUrl类的使用
希望我的博客，能帮上你解决学习中工作中所遇到的问题
12-30 2830
详细说明 QUrl类提供了使用URL的便捷接口。 它可以解析和构造编码和未编码形式的URL。 QUrl还支持国际化域名（IDN）。 使用QUrl的最常见方法是通过构造函数通过传递QString对其进行初始化。否则，也可以使用setUrl（）。 URL可以两种形式表示：已编码或未编码。未编码的表示形式适合显示给用户，但是编码的表示形式通常是您要发送到Web服务器的形式。例如，未编码的URL“ http：//bühler.example.com/applicants.xml”将作为“ http://xn–bhl
QURL-crx插件
03-15
将网址转换为QR码。 将打开的标签页的网址转换为QR码。 GitHub：https：//github.com/oken1/qurl 支持语言:English,日本語
QT---QDesktopServices打开本地文件
路在脚下，Quick run!
05-08 1038
代码： QString urlPath = "file:///"+文件路径； QDesktopServices::openUrl(QUrl::fromLocalFile(urlPath)); QDesktopServices::openUrl(QUrl(urlPath, QUrl::TolerantMode)); 说明： （1）如果文件名或路径中包含有中文或空格，则使用QUrl::fromLocalFile； （2）QUrl(fileName)只能打开英文名称和没有空格路径的文件。 （3）最好不
【qt】windows下本地文件的标准url格式
qq_43248127的博客
09-16 4733
代码： QUrl url = QUrl::fromLocalFile(“c:/test.264”); QString temp = url.toString(); 结果： temp = **“file:///**c:/test.264”
Qt之QUrl
weixin_34357436的博客
09-13 1495
简述 QUrl 类提供了一个方便的接口使用 URLs。 它可以解析和构造编码和未编码形式的 URLs。QUrl 也支持国际化域名（IDNs）。 简述 详细描述 错误检查 字符转换 URL格式 scheme Authority user info path query fragment 深入使用 相对路径 用户输入 ...
Roson的Qt之旅#80 QUrl类
Allen Roson
02-14 997
QUrl类详细介绍，URL，统一资源定位符
QT QUrl
Allen Roson
07-10 2539
1.概述 QUrl类为使用url提供了一个方便的接口。 它可以以编码和未编码的形式解析和构造url。QUrl还支持国际化域名(idn)。 使用QUrl最常见的方法是通过传递一个QString来通过构造函数初始化它。否则，也可以使用setUrl()。 url可以用两种形式表示:编码的或未编码的。未编码的表示适合显示给用户，但编码的表示通常是您将发送给web服务器的内容。例如，application .xml的未编码的URL“http://bühler.example.com/List”将作为“http
QUrl中传入本地含中文名称文件问题
Moshangtinghua的博客
06-19 2705
在程序中直接使用Qt的QDesktopServices::openUrl()函数调用桌面应用打开本地的文件，文件名称没有中文没有问题。但文件名中含有中文时，QUrl解析出错，打开文件失败。 解决方法： （1）文件使用绝对路径 fileInfo.absoluteFilePath() （2）使用QUrl::fromLocalFile(），传入绝对路径 QDir dir("../"); QStringList nameFilters; nameFilters << "*...
Qt对本地文件的操作
qq_41639957的博客
02-24 1034
打开本地文件： QDesktopServices::openUrl(QUrl::fromLocalFile("文件路径")); 重命名： QFile file("C:xx.txt"); file.rename(C:xxx.txt); 删除文件： QFile::remove("文件路径"); 文件拷贝： QFile::copy("源路径", "目标路径"); 文件移动 QFile::rename("源路径", "目标路径"); 原文来自微信公众号"程序员成长日志",已经工作的程序员朋友.
QuRL-crx插件
04-05
语言:English 此扩展程序从当前页面的URL生成QR码。 使用它可以快速打开手机上的页面。 此扩展程序从当前页面的URL生成QR码。 使用它可以快速打开手机上的页面。
Qurl-crx插件
04-04
语言:English 从网址生成QRCode的工具！ 小型扩展程序，可生成访问网页的Qr Code并将其随身携带
交叉编译openssl，使arm设备的qt程序能支持https请求
06-16
对于设备的qt程序，应该在每次post请求时QUrl url(strurl); QNetworkRequest netRequest; QSslConfiguration config; QSslConfiguration conf = netRequest.sslConfiguration(); conf.setPeerVerifyMode...
Qt | 标准、复选、单选、工具、命令按钮大全
m0_45463480的博客
04-28 258
Qt | 标准、复选、单选、工具、命令按钮大全
Qt QLineEdit详解
希望能帮助大家，希望大家多多支持，你们的支持是我前进的动力。
04-29 862
QLineEdit是一个单行文本编辑器。行编辑允许用户使用一组有用的编辑功能输入和编辑单行纯文本，包括撤消和重做、剪切和粘贴以及拖放。通过更改行编辑的echoMode，它也可以用作“只写”字段，用于密码等输入。文本的长度可以限制为maxLength，文本可以使用validator或inputMask进行任意约束，也可以同时使用这两种方法。在同一行编辑的validator和inputMask之间切换时，最好清除validator或输入mask，以防止出现未定义的行为。
【Qt】信号与槽
最新发布
m0_66599463的博客
04-30 1172
1、信号和槽的概述 1.1 信号的本质 1.2 槽的本质 2、信号和槽的使用 2.1 连接信号的槽 click和clicked 2.2 第二种自定义创建槽函数的方式 3、自定义信号和槽 3.1 ⾃定义信号函数书写规范 3.2 带参数得槽和函数 4、信号与槽的连接方式 4.1 一对一 4.2 一对多 4.3 多对一 5、信号和槽的其他说明 5.1 信号与槽的断开 5.2 Qt4 版本信号与槽的连接 5.3 使⽤ Lambda 表达式定义槽函数 5.4 信号与槽的优缺点
Qt QThreadPool线程池
希望能帮助大家，希望大家多多支持，你们的支持是我前进的动力。
04-29 594
QThreadPool类管理一个QThread集合。QThreadPool管理和重新设计单个QThread对象，以帮助降低使用线程的程序中的线程创建成本。每个Qt应用程序都有一个全局QThreadPool对象，可以通过调用globalInstance来访问该对象。要使用其中一个QThreadPool线程，请子类化QRunnable并实现run虚拟函数。然后创建该类的一个对象，并将其传递给QThreadPool::start。线程复用：线程池中的线程可以重复使用，减少了线程创建和销毁的开销。
使用QT完成如图的游戏登录界面 使用信号和槽完成密文明文密码转换，重置账号和密码，登录校验 详细代码在主页下载
m0_67469586的博客
04-29 851
this->accline->setPlaceholderText("请输入账号...");this->pwdswitchbtn=new QPushButton("密文",this);//点击"密文"按钮时，按钮本身的文字变为“明文”，QLineEdit 中的内容也变为明文;this->pwdline->setPlaceholderText("请输入密码");this->pwdswitchbtn->setText("明文");this->pwdswitchbtn->setText("密文");
PyQt5：Qt Designer使用重载的自定义类提升控件
初见倾心
04-29 183
5，说明：自定义类的：__init__()方法，必须有parent参数，用于传递父对象。2，右击需要提升的控件，选择【提升为...】1，以QPushButton举例。3，添加自定义类，不用管。的后缀，不影响使用。
【Qt】Qt中设置窗口与屏幕大小一样
-凌凌漆-的博客
04-28 263
【代码】【Qt】Qt中设置窗口与屏幕大小一样。
Qt中QUrl详细用法
05-25
QUrl是Qt中用于处理URL的类。它可以解析和构建URL，支持各种协议（如http，ftp，file等），并提供了一些方便的方法来获取URL的各个部分。 下面是一些常见的QUrl使用方法： 1. 创建一个QUrl对象 ```cpp QUrl url("http://www.example.com/path/file.html"); ``` 2. 获取URL的各个部分 ```cpp QString scheme = url.scheme(); // 获取协议部分，如http QString host = url.host(); // 获取主机部分，如www.example.com int port = url.port(); // 获取端口号，如果没有指定则返回-1 QString path = url.path(); // 获取路径部分，如/path/file.html QString query = url.query(); // 获取查询字符串，如key=value&name=John QUrlFragment fragment = url.fragment(); // 获取片段标识符，如section1 ``` 3. 修改URL的各个部分 ```cpp url.setScheme("https"); // 修改协议部分为https url.setHost("example.com"); // 修改主机部分为example.com url.setPort(8080); // 修改端口号为8080 url.setPath("/newpath/file.html"); // 修改路径部分为/newpath/file.html url.setQuery("key=newvalue"); // 修改查询字符串为key=newvalue url.setFragment("section2"); // 修改片段标识符为section2 ``` 4. 判断URL是否合法 ```cpp bool isValid = url.isValid(); // 判断URL是否合法，如果合法则返回true ``` 5. 解析URL参数 ```cpp QUrlQuery query(url.query()); // 将查询字符串解析为QUrlQuery对象 QString value = query.queryItemValue("key"); // 获取查询参数key的值 ``` 6. 构建URL ```cpp QUrl url; url.setScheme("http"); url.setHost("www.example.com"); url.setPath("/path/file.html"); url.setQuery("key=value"); QString urlString = url.toString(); // 将QUrl对象转换为字符串，返回http://www.example.com/path/file.html?key=value ``` 以上是QUrl的一些常见用法，更多详细用法可以参考Qt官方文档。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值