Qt:QUrl
1、说明
概述
一个代表URL的类,此外还支持国际域名(IDNs)。
通常在初始化时传入QString构造QUrl,除此之外还能用setUrl()。
URL有两种表示格式:编码、未编码。未编码URL常用于显示,编码URL常用于发送给一个网络服务器进行处理,例如,未编码的URL"http://bühler.example.com/List of applicants.xml"发给服务器时就是"http://xn--bhler-kva.example.com/List%20of%20applicants.xml"。
分块构造URL是如何实现呢?可以通过setScheme()、setUserName()、setPassword()、setHost()、setPort()、setPath()、setQuery()、setFragment()分别构造一个URL每个分部。也可以使用一些综合的函数,比如setAuthority()可以同时设置Username、Password、Host、Port。setUserInfo()可以设置Username、Password。
如果要检查URL是否合法,可以调用isValid()方法。该方法可以用于构造一个URL的任何时期(这些时期就是上一段所说构造那些分块的时期)。如果isValid()返回false,那么在运行前就需要先调用clear()重置这个URL,之后通过setUrl()构造一个新的URL。
通过QUrlQuery类和它的相关方法可以构造一个Query。
调用static方法fromPercentEncoding()和toPercentEncoding()可以很方便的对URL和Query String进行编码和解码,返回值是QString类型。
fromLocalFile()方法通过解析一个本地文件构造一个QUrl,toLocalFile()则能将一个URL输出到一个本地文件中。
我们能够立刻辨识的URL可以通过toString()方法得到。这个方法可以很方便地用于展示一个非编码URL。如果想得到一个编码URL,可以用toEncoded(),编码URL常用于网络传输给Web服务器、邮箱客户端等等。URL不管编码与否都能无歧义且正确地代表同一个URL,也可以传入QUrl的构造方法或者setUrl()来产生一个相同的QUrl对象。
URL与Path
调用isRelative()可以判断URL是不是相对URL。相对URL没有scheme(暂时不知道咋翻译,就先用英文代替),一个scheme是指URL对应的Path中类似 xxx: 的前缀:
qDebug() << QUrl("main.qml").isRelative(); // true: no scheme qDebug() << QUrl("qml/main.qml").isRelative(); // true: no scheme qDebug() << QUrl("file:main.qml").isRelative(); // false: has "file" scheme qDebug() << QUrl("file:qml/main.qml").isRelative(); // false: has "file" scheme
不过要注意,URL的绝对/相对与Path的绝对/相对无关,Path的绝对相对是看Path是否从根目录开始;URL则是看是否有scheme:
// 相对URL, 绝对path url = QUrl("/home/user/file.txt"); // 绝对URL, 相对path QUrl url("file:file.txt");
一个相对URL可以通过resolved()转化为绝对URL。isParentOf()方法用于判断URL是否是另一个URL的Parent。
2、模块和加载项
Header | #include<QUrl> |
qmake | QT + = core |
3、构造
QUrl( QUrl other ) |
QUrl( QString url , QUrl::ParsingMode = TolerantMode ) |
QUrl() |
4、静态方法
返回值类型 |
方法 |
说明 |
QString | fromAce(QByteArray domain) | |
QUrl | fromCFURL(CFURLRef url) | |
QUrl | fromEncoded(QByteArray input, QUrl::ParsingMode parsingMode = TolerantMode) | |
QUrl | fromLocalFile(QString localFile) | |
QUrl | fromNSURL(NSURL *url) | |
QString | fromPercentEncoding(QByteArray input) | |
QList<QUrl> | fromStringList(QStringList urls, QUrl::ParsingMode mode = TolerantMode) | |
QUrl |
fromUserInput(QString userInput) fromUserInput(QString userInput,QString workingDirectory, QUrl::UserInputResolutionOptions options = DefaultResolution) |
|
QStringList | idnWhitelist() | |
void | setIdnWhitelist(QStringList list) | |
QByteArray | toAce(QString domain) | |
QByteArray | toPercentEncoding(QString input,QByteArray exclude = QByteArray(),QByteArray include = QByteArray()) | |
QStringList | toStringList(QList<QUrl> urls, QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded)) |
5、实例方法
返回值类型 |
方法 |
说明 |
QURL & |
operator=(QUrl other) operator=(QString & url) operator!=(QUrl url) operator==(QUrl url) |
|
QUrl | adjusted(QUrl::FormattingOptions options) const | |
QString | authority(QUrl::ComponentFormattingOptions options = PrettyDecoded) | |
void | clear() | |
QString | errorString() | |
QString | fileName(QUrl::ComponentFormattingOptions options = FullyDecoded) | |
QString | fragment(QUrl::ComponentFormattingOptions options = PrettyDecoded) | |
bool | hasFragment() | |
bool | hasQuery() | |
QString | host(QUrl::ComponentFormattingOptions options = FullyDecoded) | |
bool | isEmpty() | |
bool | isLocalFile() | |
bool | isParentOf(QUrl childUrl) | |
bool | isRelative() | |
bool | isValid() | |
bool | matches(QUrl url, QUrl::FormattingOptions options) | |
QString | password(QUrl::ComponentFormattingOptions options = FullyDecoded) | |
QString | path(QUrl::ComponentFormattingOptions options = FullyDecoded) | |
int | port(int defaultPort = -1) |
QString | query(QUrl::ComponentFormattingOptions options = PrettyDecoded) | |
QUrl | resolved(QUrl relative) | |
QString | scheme() | |
void |
setAuthority(QString authority, QUrl::ParsingMode mode = TolerantMode) setFragment(QString fragment, QUrl::ParsingMode mode = TolerantMode) setHost(QString host, QUrl::ParsingMode mode = DecodedMode) setPassword(QString password, QUrl::ParsingMode mode = DecodedMode) setPath(QString path, QUrl::ParsingMode mode = DecodedMode) setPort(int port) setQuery(QString query, QUrl::ParsingMode mode = TolerantMode) setQuery(QUrlQuery query) setScheme(QString scheme) setUrl(QString url, QUrl::ParsingMode parsingMode = TolerantMode) setUserInfo(QString userInfo, QUrl::ParsingMode mode = TolerantMode) setUserName(QString userName, QUrl::ParsingMode mode = DecodedMode) |
|
void | swap(QUrl &other) | |
CFURLRef | toCFURL() | |
QString | toDisplayString(QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded)) | |
QByteArray | toEncoded(QUrl::FormattingOptions options = FullyEncoded) | |
QString | toLocalFile() | |
NSURL * | toNSURL() | |
QString | toString(QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded)) | |
QString | url(QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded)) const | |
QString | userInfo(QUrl::ComponentFormattingOptions options = PrettyDecoded) | |
QString | userName(QUrl::ComponentFormattingOptions options = FullyDecoded) |
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 浏览器原生「磁吸」效果!Anchor Positioning 锚点定位神器解析
· 没有源码,如何修改代码逻辑?
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· PowerShell开发游戏 · 打蜜蜂
· 在鹅厂做java开发是什么体验
· 百万级群聊的设计实践
· WPF到Web的无缝过渡:英雄联盟客户端的OpenSilver迁移实战
· 永远不要相信用户的输入:从 SQL 注入攻防看输入验证的重要性