QUrl Class

成员函数文档

QUrl::QUrl()

构造一个空的 QUrl 对象。

QUrl::QUrl(const QString &url, QUrl::ParsingMode parsingMode = TolerantMode)

通过解析url 构造一个 URL。请注意，该构造函数需要一个正确的 URL 或 URL-Reference，而不会试图猜测其意图。例如，以下声明

QUrl url("example.com");

将构造一个有效的 URL，但可能与预期不同，因为缺少了输入的scheme() 部分。对于类似上述的字符串，应用程序可能希望使用fromUserInput().对于这个构造函数或setUrl() 而言，以下可能才是其本意：

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

QUrl 会自动对 URL 中不允许使用的所有字符进行百分比编码，并对代表未保留字符（字母、数字、连字符、下划线、点和斜线）的百分比编码序列进行解码。所有其他字符均保持原样。

使用解析器模式parsingMode 解析url 。在TolerantMode （默认）模式下，QUrl 会纠正某些错误，特别是出现未跟在两个十六进制数字后面的百分号字符（'%'），并接受任何位置的任何字符。在StrictMode 中，编码错误是不能容忍的，QUrl 还将检查某些禁止使用的字符是否以未编码形式存在。如果在StrictMode 中检测到错误，isValid() 将返回 false。在这种情况下，不允许使用解析模式DecodedMode 。

示例

QUrl url("http://www.example.com/List of holidays.xml");
// url.toEncoded() == "http://www.example.com/List%20of%20holidays.xml"

要从编码字符串构建 URL，也可以使用fromEncoded()：

QUrl url = QUrl::fromEncoded("http://qt-project.org/List%20of%20holidays.xml");

这两个函数是等价的，而且在 Qt 5 中，这两个函数都接受编码数据。通常，QUrl 构造函数或setUrl() 与fromEncoded() 的选择取决于源数据：构造函数和setUrl() 使用QString ，而fromEncoded 使用QByteArray 。

另请参见 setUrl()、fromEncoded() 和TolerantMode 。

[noexcept] QUrl::QUrl(const QUrl &other)

构造other 的副本。

[noexcept] QUrl::QUrl(QUrl &&other)

Move-创建一个 QUrl 实例，使其指向other 所指向的同一对象。

[noexcept] QUrl::~QUrl()

销毁器；在删除对象前立即调用。

QUrl QUrl::adjusted(QUrl::FormattingOptions options) const

返回调整后的 URL 版本。输出结果可通过options 中的标记进行自定义。

QUrl::ComponentFormattingOption 中的编码选项对该方法意义不大，QUrl::PreferLocalFile 也是如此。

该方法始终等同于QUrl(url.toString(options))。

另请参见 FormattingOptions,toEncoded() 和toString()。

QString QUrl::authority(QUrl::ComponentFormattingOptions options = PrettyDecoded) const

如果定义了 URL 的权限，则返回该权限；否则返回空字符串。

该函数返回一个无歧义的值，其中可能包含仍按百分比编码的字符，以及QString 中无法以解码形式表示的某些控制序列。

options 参数控制用户信息组件的格式。本函数不允许使用QUrl::FullyDecoded 的值。如果需要获取完全解码的数据，请分别调用userName(),password(),host() 和port() 。

另请参阅 setAuthority()、userInfo()、userName()、password()、host() 和port()。

void QUrl::clear()

重置QUrl 的内容。调用此函数后，QUrl 等于使用默认空构造函数构造的内容。

另请参见 isEmpty()。

QString QUrl::errorString() const

如果上次修改QUrl 对象的操作出现解析错误，则返回错误信息。如果没有检测到错误，则此函数返回空字符串，isValid() 返回true 。

此函数返回的错误信息属于技术性质，最终用户可能无法理解。对于试图了解QUrl 为何不接受某些输入的开发人员来说，它主要是有用的。

另请参见 QUrl::ParsingMode 。

QString QUrl::fileName(QUrl::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 中无法以解码形式表示。

另请参阅 path() 。

QString QUrl::fragment(QUrl::ComponentFormattingOptions options = PrettyDecoded) const

返回 URL 的片段。要确定解析后的 URL 是否包含片段，请使用hasFragment() 。

options 参数控制片段组件的格式。所有值都会产生一个明确的结果。使用QUrl::FullyDecoded 时，所有百分数编码序列都会被解码；否则，返回值可能包含某些控制序列的百分数编码序列，而这些控制序列在QString 中无法以解码形式表示。

请注意，如果存在这些不可表示的序列，QUrl::FullyDecoded 可能会导致数据丢失。建议在非 URL 上下文中使用结果时使用该值。

另请参阅 setFragment() 和hasFragment()。

[static, since 6.3] QString QUrl::fromAce(const QByteArray &domain, QUrl::AceProcessingOptions options = {})

返回给定域名domain 的 Unicode 格式，该格式采用 ASCII 兼容编码 (ACE) 进行编码。输出结果可通过options 传递标志进行自定义。此函数的结果等同于domain 。

如果domain 中的值无法编码，则将转换为QString 并返回。

ASCII 兼容编码（ACE）由 RFC 3490、RFC 3491 和 RFC 3492 定义，并由 Unicode 技术标准 #46 更新。它是应用程序中域名国际化（IDNA）规范的一部分，该规范允许使用非美国 ASCII 字符编写域名（如"example.com" ）。

该功能在 Qt 6.3 中引入。

[static] QUrl QUrl::fromCFURL(CFURLRef url)

构建一个QUrl ，其中包含 CFURLurl 的副本。

[static] QUrl QUrl::fromEncoded(QByteArrayView input, QUrl::ParsingMode mode = TolerantMode)

解析input 并返回相应的QUrl 。假定input 是编码形式，只包含 ASCII 字符。

使用mode 解析 URL。有关此参数的更多信息，请参阅setUrl() 。此处不允许使用QUrl::DecodedMode 。

另请参见 toEncoded() 和setUrl()。

[static] QUrl QUrl::fromLocalFile(const QString &localFile)

返回localFile 的QUrl 表示，解释为本地文件。该函数接受用斜线分隔的路径以及该平台的本地分隔符。

该函数还接受带有双斜线（或反斜线）的路径，以表示远程文件，如"//servername/path/to/file.txt"。请注意，只有某些平台可以使用QFile::open() 实际打开该文件。

空localFile 会导致空 URL（自 Qt XML 5.4 起）。

   qDebug()<<QUrl::fromLocalFile("file.txt");// QUrl("file:file.txt")    qDebug() << QUrl::fromLocalFile("/home/user/file.txt"); // QUrl("file:///home/user/file.txt")
    qDebug() << QUrl::fromLocalFile("file:file.txt");       // doesn't make sense; expects path, not url with scheme

在上面代码段的第一行中，文件 URL 是由本地相对路径构建的。使用相对路径的文件 URL 只有在有基本 URL 可以解析时才有意义。例如

    QUrlurl=QUrl::fromLocalFile("file.txt")；    QUrlbaseUrl=QUrl("file:/home/user/");// 错误：打印 QUrl("file:file.txt")，因为 url 已经有了一个方案    qDebug() << baseUrl.resolved(url);

要解决这样的 URL 问题，必须事先删除该方案：

   // correct: prints QUrl("file:///home/user/file.txt")url.setScheme(QString());    qDebug() << baseUrl.resolved(url);

因此，相对文件路径最好使用相对 URL（即无方案）：

    QUrlurl=QUrl("file.txt")；    QUrlbaseUrl=QUrl("file: /home/user/");// 打印 QUrl("file:///home/user/file.txt")    qDebug() << baseUrl.resolved(url);

另请参见 toLocalFile()、isLocalFile() 和QDir::toNativeSeparators()。

[static] QUrl QUrl::fromNSURL(const NSURL *url)

构建QUrl ，其中包含 NSURLurl 的副本。

[static] QString QUrl::fromPercentEncoding(const QByteArray &input)

返回input 的解码副本。首先对input 进行百分数编码解码，然后将其从 UTF-8 转换为 unicode。

[static] QList<QUrl> QUrl::fromStringList(const QStringList &urls, QUrl::ParsingMode mode = TolerantMode)

使用QUrl(str,mode) 将代表urls 的字符串列表转换为 url 列表。请注意，这意味着所有字符串都必须是 url，而不是本地路径。

[static] QUrl QUrl::fromUserInput(const QString &userInput, const QString &workingDirectory = QString(), QUrl::UserInputResolutionOptions options = DefaultResolution)

如果可以从用户提供的userInput 字符串中推导出一个有效的 URL，则返回该 URL。如果推导不出，则返回无效的QUrl()。

这允许用户以纯字符串形式输入 URL 或本地文件路径。该字符串可以手动输入位置栏、从剪贴板获取或通过命令行参数传递。

当字符串不是有效的 URL 时，系统会根据各种假设进行最佳猜测。

如果字符串对应的是系统中的有效文件路径，则会使用QUrl::fromLocalFile() 构建一个 file:// URL。

如果不是这种情况，则会尝试将字符串转换为 http:// 或 ftp:// URL。如果字符串以 "ftp "开头，则使用后者。然后将结果传递给QUrl 的容忍解析器，如果成功，则返回有效的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

为了能够处理相对路径，此方法需要一个可选的workingDirectory 路径。这在处理命令行参数时特别有用。如果workingDirectory 为空，则不会处理相对路径。

默认情况下，只有当文件确实存在于给定的工作目录中时，看起来像相对路径的输入字符串才会被视为相对路径。如果应用程序可以处理尚未存在的文件，则应在options 中传递标志AssumeLocalFile 。

bool QUrl::hasFragment() const

如果该 URL 包含片段（即在该 URL 上看到 #），则返回true 。

另请参阅 fragment() 和setFragment()。

bool QUrl::hasQuery() const

如果该 URL 包含查询（即在该 URL 上看到 ?），则返回true 。

另请参阅 setQuery()、query() 和hasFragment()。

QString QUrl::host(QUrl::ComponentFormattingOptions options = FullyDecoded) const

如果定义了 URL 的主机名，则返回主机名；否则返回空字符串。

options 参数控制主机名的格式。QUrl::EncodeUnicode 选项将使该函数以 ASCII 兼容编码（ACE）形式返回主机名，适合在非 8 位纯净或需要传统主机名的通道（如 DNS 请求或 HTTP 请求头）中使用。如果不存在该标志，该函数将根据允许的顶级域列表（参见idnWhitelist()) 以 Unicode 形式返回国际域名 (IDN)。

所有其他标志将被忽略。主机名不能包含控制字符或百分数字符，因此可以认为返回值已完全解码。

另请参阅 setHost()、idnWhitelist()、setIdnWhitelist() 和authority()。

[static] QStringList QUrl::idnWhitelist()

返回允许在组成中使用非 ASCII 字符的顶级域的当前白名单。

有关该列表的基本原理，请参见setIdnWhitelist() 。

另请参见 setIdnWhitelist() 和AceProcessingOption 。

bool QUrl::isEmpty() const

如果 URL 没有数据，则返回true ；否则返回false 。

另请参阅 clear() 。

bool QUrl::isLocalFile() const

如果 URL 指向本地文件路径，则返回true 。如果方案为 "file"，URL 就是本地文件路径。

请注意，即使最终文件路径无法用QFile::open() 打开，该函数也会将带有主机名的 URL 视为本地文件路径。

另请参阅 fromLocalFile() 和toLocalFile()。

bool QUrl::isParentOf(const QUrl &childUrl) const

如果此 URL 是childUrl 的父 URL，则返回true 。如果两个 URL 具有相同的方案和权限，且此 URL 的路径是childUrl 路径的父 URL，则childUrl 是此 URL 的子 URL。

bool QUrl::isRelative() const

如果 URL 是相对引用，则返回true ；否则返回false 。如果 URL 的方案未定义，则其为相对引用；因此，该函数等同于调用scheme().isEmpty().

RFC 3986 第 4.2 节定义了相对引用。

另请参见 Relative URLs vs Relative Paths 。

bool QUrl::isValid() const

如果 URL 是非空且有效，则返回true ；否则返回false 。

URL 将通过一致性测试。URL 的每个部分都必须符合 URI 标准的标准编码规则，URL 才能被报告为有效。

boolcheckUrl(constQUrl&url) {if(!url.isValid()) {        qDebug("Invalid URL: %s", qUtf8Printable(url.toString()));
       return false; }return true; }

bool QUrl::matches(const QUrl &url, QUrl::FormattingOptions options) const

将options 应用于两个 URL 后，如果此 URL 和给定的url 相等，则返回true ；否则返回false 。

这等同于在两个 URL 上调用adjusted(options)，然后比较结果 URL，但速度更快。

QString QUrl::password(QUrl::ComponentFormattingOptions options = FullyDecoded) const

如果定义了 URL 的密码，则返回该密码；否则返回空字符串。

options 参数控制用户名组件的格式。所有值都会产生一个无歧义的结果。使用QUrl::FullyDecoded 时，所有百分数编码序列都会被解码；否则，返回值可能包含某些控制序列的百分数编码序列，这些序列在QString 中无法以解码形式表示。

请注意，如果存在这些不可表示的序列，QUrl::FullyDecoded 可能会导致数据丢失。建议在非 URL 上下文中使用该值，如在QAuthenticator 中设置或协商登录。

另请参阅 setPassword() 。

QString QUrl::path(QUrl::ComponentFormattingOptions options = FullyDecoded) const

返回 URL 的路径。

   qDebug()<<QUrl("file:file.txt").path();// "file.txt".    qDebug() << QUrl("/home/user/file.txt").path();             // "/home/user/file.txt"
    qDebug() << QUrl("http://www.example.com/test/123").path(); // "/test/123"

options 参数控制路径组件的格式。所有值都会产生一个无歧义的结果。使用QUrl::FullyDecoded 时，所有百分数编码序列都会被解码；否则，返回值可能包含某些控制序列的百分数编码序列，这些序列在QString 中无法以解码形式表示。

请注意，如果存在这些不可表示的序列，QUrl::FullyDecoded 可能会导致数据丢失。当结果将用于非 URL 环境（如发送到 FTP 服务器）时，建议使用该值。

使用FullyDecoded （默认值）时，如果存在非 Unicode 百分比编码序列，就会造成数据丢失：

    qDebug() << QUrl("/foo%FFbar").path();

在这个例子中，由于%FF 无法转换，因此会有一定程度的数据丢失。

当路径包含子分隔符（如+ ）时，也会出现数据丢失：

    qDebug() << QUrl("/foo+bar%2B").path(); // "/foo+bar+"

其他解码示例：

   常量QUrlurl("/tmp/Mambo %235%3F.mp3")；    qDebug() << url.path(QUrl::FullyDecoded);  // "/tmp/Mambo #5?.mp3"
    qDebug() << url.path(QUrl::PrettyDecoded); // "/tmp/Mambo #5?.mp3"
    qDebug() << url.path(QUrl::FullyEncoded);  // "/tmp/Mambo%20%235%3F.mp3"

另见 setPath().

int QUrl::port(int defaultPort = -1) const

返回 URL 的端口，如果未指定端口，则返回defaultPort 。

示例

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

另请参阅 setPort().

QString QUrl::query(QUrl::ComponentFormattingOptions options = PrettyDecoded) const

如果有查询字符串，则返回 URL 的查询字符串；如果没有，则返回空结果。要确定解析后的 URL 是否包含查询字符串，请使用hasQuery() 。

options 参数控制查询组件的格式。所有值都会产生一个明确的结果。使用QUrl::FullyDecoded 时，所有百分数编码序列都会被解码；否则，返回值可能包含某些控制序列的百分数编码序列，而这些控制序列在QString 中无法以解码形式表示。

请注意，不鼓励在查询中使用QUrl::FullyDecoded ，因为查询通常包含应保持百分数编码的数据，包括使用"%2B "序列表示加号字符（'+'）。

另请参阅 setQuery() 和hasQuery()。

QUrl QUrl::resolved(const QUrl &relative) const

返回此 URL 与relative 的合并结果。此 URL 可作为将relative 转换为绝对 URL 的基础。

如果relative 不是相对 URL，该函数将直接返回relative 。否则，将合并两个 URL 的路径，返回的新 URL 具有基本 URL 的方案和权限，但路径是合并后的，如下例所示：

QUrlbaseUrl("http://qt.digia.com/Support/")；QUrlrelativeUrl("../Product/Library/")；qDebug(baseUrl.resolved(relativeUrl).toString());
// 打印 "http://qt.digia.com/Product/Library/"

使用"... "调用 resolved() 会返回一个QUrl ，其目录比原始目录高一级。同样，使用".../... "调用 resolved() 会从路径中移除两级。如果relative 为"/"，则路径变为"/"。

另请参见 isRelative()。

QString QUrl::scheme() const

返回 URL 的方案。如果返回空字符串，则表示方案未定义，URL 是相对的。

方案只能包含 US-ASCII 字母或数字，即不能包含任何需要编码的字符。此外，方案总是以小写形式返回。

另请参阅 setScheme() 和isRelative()。

void QUrl::setAuthority(const QString &authority, QUrl::ParsingMode mode = TolerantMode)

将 URL 的权限设置为authority 。

URL 的权限是用户信息、主机名和端口的组合。所有这些元素都是可选的，因此空的授权也是有效的。

用户信息和主机之间用"@"分隔，主机和端口之间用": "分隔。如果用户信息为空，则必须省略"@"；但如果端口为空，则允许使用杂散的":"。

下面的示例显示了一个有效的授权字符串：

authority 数据的解释与mode 相同：在StrictMode 中，任何"%"字符后面必须跟两个十六进制字符，某些字符（包括空格）不允许以未解码形式出现。在TolerantMode （默认设置）中，所有字符都接受未解码形式，容忍解析器将纠正未跟两个十六进制字符的游离'%'字符。

该函数不允许mode 成为QUrl::DecodedMode 。要设置完全解码的数据，请分别调用setUserName()、setPassword()、setHost() 和setPort() 。

另请参阅 authority()、setUserInfo()、setHost() 和setPort()。

void QUrl::setFragment(const QString &fragment, QUrl::ParsingMode mode = TolerantMode)

将 URL 的片段设置为fragment 。片段是 URL 的最后一部分，用 "#"表示，后面跟着一串字符。在 HTTP 中，它通常用于指向页面上的某个链接或点：

片段有时也被称为 URL "引用"。

传递 QString() 的参数（空QString ）将取消设置片段。如果传递QString("") 的参数（空但非空的QString ），则会将片段设置为空字符串（就像原始 URL 有一个孤独的 "#"）。

fragment 数据根据mode 进行解释：在StrictMode 中，任何"%"字符后面必须跟两个十六进制字符，某些字符（包括空格）不允许以未解码形式出现。在TolerantMode 中，接受所有未解码字符，容许解析器会纠正未跟两个十六进制字符的'%'字符。在DecodedMode 中，"%"代表字符本身，不允许使用编码字符。

QUrl::DecodedMode 在设置来自非 URL 数据源的片段或通过调用 () 和 格式化选项获得的片段时，应使用"......"。fragment QUrl::FullyDecoded

另请参阅 fragment() 和hasFragment()。

void QUrl::setHost(const QString &host, QUrl::ParsingMode mode = DecodedMode)

将 URL 的主机设置为host 。主机是权限的一部分。

host 数据根据mode 进行解释：在StrictMode 中，任何'%'字符后面必须跟两个十六进制字符，某些字符（包括空格）不允许以未解码形式出现。在TolerantMode 中，接受所有未解码字符，容许解析器会纠正未跟两个十六进制字符的'%'字符。在DecodedMode 中，"%"代表字符本身，不能使用编码字符。

请注意，在任何情况下，解析结果都必须是符合 STD 3 规则的有效主机名，并经国际化资源标识符规范（RFC 3987）修改。不允许使用无效主机名，无效主机名将导致isValid() 变为 false。

另请参阅 host() 和setAuthority()。

[static] void QUrl::setIdnWhitelist(const QStringList &list)

将允许在域中使用非 ASCII 字符的顶级域 (TLD) 白名单设置为list 。

请注意，如果调用此函数，需要在启动任何可能访问idnWhitelist() 的线程之前进行。

Qt XML 自带了一个默认列表，其中包含已公布支持国际化域名 (IDN) 的互联网顶级域，以及保证外观相似的字符（如拉丁语小写字母'a' 和西里尔字母等同，在大多数字体中视觉上完全相同）之间不会发生欺骗的规则。

该列表会随着注册商发布新规则而定期维护。

该功能是为需要操作列表以添加或删除 TLD 的用户提供的。不建议出于测试以外的目的更改其值，因为这样做可能会使用户面临安全风险。

另请参见 idnWhitelist()。

void QUrl::setPassword(const QString &password, QUrl::ParsingMode mode = DecodedMode)

将 URL 的密码设置为password 。如setUserInfo() 所述，password 是 URL 权限中用户信息元素的一部分。

password 数据根据mode 进行解释：在StrictMode 中，任何"%"字符后面必须跟两个十六进制字符，某些字符（包括空格）不允许以未解码形式出现。在TolerantMode 中，接受所有未解码字符，容许解析器会纠正未跟两个十六进制字符的'%'字符。在DecodedMode 中，"%"代表其本身，不能使用编码字符。

QUrl::DecodedMode 应在通过非 URL 数据源设置密码时使用，例如向用户显示的密码对话框，或通过调用 () 并使用 格式化选项获取的密码。password QUrl::FullyDecoded

另请参阅 password() 和setUserInfo()。

void QUrl::setPath(const QString &path, QUrl::ParsingMode mode = DecodedMode)

将 URL 的路径设置为path 。路径是 URL 中权限之后、查询字符串之前的部分。

对于非层次结构方案，路径将是方案声明之后的所有内容，如下例所示：

path 数据根据mode 进行解释：在StrictMode 中，任何"%"字符后面必须跟两个十六进制字符，某些字符（包括空格）不允许以未解码形式出现。在TolerantMode 中，接受所有未解码字符，容许解析器会纠正未跟两个十六进制字符的'%'字符。在DecodedMode 中，"%"代表字符本身，不能使用编码字符。

QUrl::DecodedMode 应在设置来自非 URL 数据源的路径时使用，如显示给用户的对话框或通过调用 () 并使用 格式化选项获得的路径。path QUrl::FullyDecoded

另请参阅 path() 。

void QUrl::setPort(int port)

将 URL 的端口设置为port 。如setAuthority() 所述，端口是 URL 授权的一部分。

port 必须在 0 至 65535 之间（含 65535）。端口设置为-1 表示端口未指定。

另请参阅 port()。

void QUrl::setQuery(const QString &query, QUrl::ParsingMode mode = TolerantMode)

将 URL 的查询字符串设置为query 。

如果需要传递不符合键值模式的查询字符串，或使用的特殊字符编码方案与QUrl 建议的不同，该函数将非常有用。

向query 传递 QString() 的值（空QString ）会完全取消设置查询。但是，如果传递QString("") 的值，则会将查询设置为空值，就好像原始 URL 有一个孤零零的"? "一样。

query 数据的解释与mode 相同：在StrictMode 中，任何"%"字符后面必须跟两个十六进制字符，某些字符（包括空格）不允许以未解码形式出现。在TolerantMode 中，接受所有未解码字符，容许解析器会纠正未跟两个十六进制字符的'%'字符。在DecodedMode 中，"%"代表其本身，不能使用编码字符。

查询字符串通常包含百分比编码序列，因此不鼓励使用DecodedMode 。需要注意的一个特殊序列是加号字符（'+'）。QUrl 不会将空格转换为加号字符，尽管网页浏览器发布的 HTML 表单会将空格转换为加号字符。为了在查询中表示实际的加号字符，通常使用"%2B "序列。在TolerantMode 或StrictMode 中，该函数将不处理"%2B "序列。

另请参阅 query() 和hasQuery()。

void QUrl::setQuery(const QUrlQuery &query)

这是一个重载函数。

将 URL 的查询字符串设置为query 。

该函数从QUrlQuery 对象中重建查询字符串，并将其设置到QUrl 对象上。该函数没有解析参数，因为QUrlQuery 包含已解析的数据。

另请参见 query() 和hasQuery()。

void QUrl::setScheme(const QString &scheme)

将 URL 的方案设置为scheme 。由于方案只能包含 ASCII 字符，因此不会对输入进行转换或解码。它还必须以 ASCII 字母开头。

方案描述了 URL 的类型（或协议）。它由 URL 开头的一个或多个 ASCII 字符表示。

方案严格遵守 RFC 3986 标准：scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )

下面的示例显示了一个方案为 "ftp "的 URL：

要设置方案，需要使用以下调用：

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

方案也可以为空，在这种情况下，URL 将被解释为相对 URL。

另请参阅 scheme() 和isRelative()。

void QUrl::setUrl(const QString &url, QUrl::ParsingMode parsingMode = TolerantMode)

url QUrl 将自动对 URL 中不允许使用的所有字符进行百分比编码，并解码代表未保留字符（字母、数字、连字符、下划线、点和斜线）的百分比编码序列。所有其他字符均保持原样。

使用解析器模式parsingMode 解析url 。在TolerantMode （默认设置）中，QUrl 会纠正某些错误，特别是出现后面没有两个十六进制数字的百分号字符（'%'），而且会接受任何位置的任何字符。在StrictMode 中，编码错误是不能容忍的，QUrl 也会检查某些禁止使用的字符是否以未编码的形式存在。如果在StrictMode 中检测到错误，isValid() 将返回 false。在这种情况下，解析模式DecodedMode 是不允许的，并会在运行时发出警告。

另请参阅 url() 和toString()。

void QUrl::setUserInfo(const QString &userInfo, QUrl::ParsingMode mode = TolerantMode)

将 URL 的用户信息设置为userInfo 。如setAuthority() 所述，用户信息是 URL 权限的可选部分。

用户信息由用户名和密码（可选）组成，以": "分隔。如果密码为空，则必须省略冒号。下面的示例显示了一个有效的用户信息字符串：

userInfo 数据根据mode 进行解释：在StrictMode 中，任何"%"字符后面必须跟两个十六进制字符，某些字符（包括空格）不允许以未解码形式出现。在TolerantMode （默认设置）中，所有字符都接受未解码形式，容忍解析器将纠正未跟两个十六进制字符的游离'%'字符。

该函数不允许mode 成为QUrl::DecodedMode 。要设置完全解码的数据，请分别调用setUserName() 和setPassword() 。

另请参阅 userInfo()、setUserName()、setPassword() 和setAuthority()。

void QUrl::setUserName(const QString &userName, QUrl::ParsingMode mode = DecodedMode)

将 URL 的用户名设置为userName 。如setUserInfo() 所述，userName 是 URL 权限中用户信息元素的一部分。

userName 数据根据mode 进行解释：在StrictMode 中，任何"%"字符后面必须跟两个十六进制字符，某些字符（包括空格）不允许以未解码形式出现。在TolerantMode （默认设置）中，所有字符都以未解码形式被接受，容许解析器将纠正未跟两个十六进制字符的游离'%'字符。在DecodedMode 中，"%"代表字符本身，不能使用编码字符。

QUrl::DecodedMode 应在设置来自非 URL 数据源的用户名时使用，如显示给用户的密码对话框或通过调用 () 并使用 格式化选项获得的用户名。userName QUrl::FullyDecoded

另请参阅 userName() 和setUserInfo()。

[noexcept] void QUrl::swap(QUrl &other)

将此 URL 与other 互换。该操作速度非常快，从未出现过故障。

[static, since 6.3] QByteArray QUrl::toAce(const QString &domain, QUrl::AceProcessingOptions options = {})

返回给定域名的 ASCII 兼容编码domain 。输出结果可通过options 传递标志进行自定义。此函数的结果等同于domain 。

ASCII 兼容编码 (ACE) 由 RFC 3490、RFC 3491 和 RFC 3492 定义，并由 Unicode 技术标准 #46 更新。它是应用程序中域名国际化 (IDNA) 规范的一部分，允许使用非美国 ASCII 字符编写域名（如"example.com" ）。

如果domain 不是有效的主机名，该函数将返回空QByteArray 。特别要注意的是，IPv6 文字不是有效的域名。

此函数在 Qt 6.3 中引入。

CFURLRef QUrl::toCFURL() const

从QUrl 创建 CFURL。

调用者拥有 CFURL 并负责释放它。

QString QUrl::toDisplayString(QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded)) const

返回 URL 的可显示字符串。输出结果可通过options 的标志进行自定义。选项RemovePassword 始终处于启用状态，因为密码不应显示给用户。

在默认选项下，生成的QString 可在稍后传回QUrl ，但最初存在的任何密码都将丢失。

另请参阅 FormattingOptions 、toEncoded() 和toString()。

QByteArray QUrl::toEncoded(QUrl::FormattingOptions options = FullyEncoded) const

如果 URL 有效，则返回 URL 的编码表示；否则返回空QByteArray 。可通过options 传递标志对输出进行自定义。

用户信息、路径和片段均转换为 UTF-8，然后对所有非 ASCII 字符进行百分数编码。主机名使用 Punycode 编码。

QString QUrl::toLocalFile() const

返回本地文件路径格式化的 URL 路径。返回的路径将使用正斜线，即使该路径最初是由带反斜线的路径创建的。

如果 URL 包含一个非空的主机名，返回值中将以 SMB 网络中的形式进行编码（例如，"//servername/path/to/file.txt"）。

   qDebug()<<QUrl("file:file.txt").toLocalFile();// "file.txt".    qDebug() << QUrl("file:/home/user/file.txt").toLocalFile(); // "/home/user/file.txt"
    qDebug() << QUrl("file.txt").toLocalFile();                 // ""; wasn't a local file as it had no scheme

注意：如果 URL 的路径组件包含非 UTF-8 二进制序列（如 %80），则此函数的行为未定义。

另请参阅 fromLocalFile() 和isLocalFile()。

NSURL *QUrl::toNSURL() const

从QUrl 创建一个 NSURL。

NSURL 会自动释放。

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

返回input 的编码副本。首先将input 转换为 UTF-8，然后对不在非保留组中的所有 ASCII 字符进行百分比编码。要防止字符被百分数编码，可将其发送至exclude 。要强制字符被百分数编码，可将其发送至include 。

未保留定义为ALPHA / DIGIT / "-" / "." / "_" / "~"

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

QString QUrl::toString(QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded)) const

返回 URL 的字符串表示。输出结果可通过options 传递标志进行定制。本函数不允许使用QUrl::FullyDecoded 选项，因为它会产生含糊不清的数据。

默认格式化选项是PrettyDecoded 。

另请参见 FormattingOptions,url() 和setUrl()。

[static] QStringList QUrl::toStringList(const QList<QUrl> &urls, QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded))

使用toString(options) 将urls 列表转换为QString 对象列表。

QString QUrl::url(QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded)) const

返回 URL 的字符串表示。输出结果可通过options 传递标志进行定制。该函数不允许使用QUrl::FullyDecoded 选项，因为它会产生含糊不清的数据。

生成的QString 可在以后传回QUrl 。

与toString （选项）同义。

另请参阅 setUrl(),FormattingOptions,toEncoded() 和toString() 。

QString QUrl::userInfo(QUrl::ComponentFormattingOptions options = PrettyDecoded) const

返回 URL 的用户信息，如果用户信息未定义，则返回空字符串。

该函数返回一个明确的值，其中可能包含仍按百分比编码的字符，以及一些在QString 中无法以解码形式表示的控制序列。

options 参数控制用户信息组件的格式。本函数不允许使用QUrl::FullyDecoded 的值。如果需要获取完全解码的数据，请分别调用userName() 和password() 。

另请参阅 setUserInfo()、userName()、password() 和authority()。

QString QUrl::userName(QUrl::ComponentFormattingOptions options = FullyDecoded) const

如果已定义用户名，则返回 URL 的用户名；否则返回空字符串。

options 参数控制用户名组件的格式。所有值都会产生一个无歧义的结果。使用QUrl::FullyDecoded 时，所有百分数编码序列都会被解码；否则，返回值可能包含某些控制序列的百分数编码序列，这些序列在QString 中无法以解码形式表示。

请注意，如果存在这些不可表示的序列，QUrl::FullyDecoded 可能会导致数据丢失。建议在非 URL 上下文中使用该值，如在QAuthenticator 中设置或协商登录。

另请参阅 setUserName() 和userInfo()。

[noexcept] QUrl &QUrl::operator=(QUrl &&other)

Move-assignsother 到此QUrl 实例。

QUrl &QUrl::operator=(const QString &url)

为该对象指定url 。

[noexcept] QUrl &QUrl::operator=(const QUrl &url)

将指定的url 指派给此对象。