# QUrl Class Reference ## [[QtCore](index.htm) module] 該QUrl類提供了一個方便的接口，用于處理URL 。[More...](#details) ### Types * `enum FormattingOption { None, RemoveScheme, RemovePassword, RemoveUserInfo, ..., StripTrailingSlash }` * `class **[FormattingOptions](index.htm)**` * `enum ParsingMode { TolerantMode, StrictMode }` ### Methods * `__init__ (self)` * `__init__ (self, QString?url)` * `__init__ (self, QString?url, ParsingMode?mode)` * `__init__ (self, QUrl?copy)` * `addEncodedQueryItem (self, QByteArray?key, QByteArray?value)` * `addQueryItem (self, QString?key, QString?value)` * `list-of-QByteArray allEncodedQueryItemValues (self, QByteArray?key)` * `QStringList allQueryItemValues (self, QString?key)` * `QString authority (self)` * `clear (self)` * `detach (self)` * `QByteArray encodedFragment (self)` * `QByteArray encodedHost (self)` * `QByteArray encodedPassword (self)` * `QByteArray encodedPath (self)` * `QByteArray encodedQuery (self)` * `list-of-tuple-of-QByteArray-QByteArray encodedQueryItems (self)` * `QByteArray encodedQueryItemValue (self, QByteArray?key)` * `QByteArray encodedUserName (self)` * `QString errorString (self)` * `QString fragment (self)` * `bool hasEncodedQueryItem (self, QByteArray?key)` * `bool hasFragment (self)` * `bool hasQuery (self)` * `bool hasQueryItem (self, QString?key)` * `QString host (self)` * `bool isDetached (self)` * `bool isEmpty (self)` * `bool isLocalFile (self)` * `bool isParentOf (self, QUrl?url)` * `bool isRelative (self)` * `bool isValid (self)` * `QString password (self)` * `QString path (self)` * `int port (self)` * `int port (self, int?defaultPort)` * `list-of-tuple-of-QString-QString queryItems (self)` * `QString queryItemValue (self, QString?key)` * `str queryPairDelimiter (self)` * `str queryValueDelimiter (self)` * `removeAllEncodedQueryItems (self, QByteArray?key)` * `removeAllQueryItems (self, QString?key)` * `removeEncodedQueryItem (self, QByteArray?key)` * `removeQueryItem (self, QString?key)` * `QUrl resolved (self, QUrl?relative)` * `QString scheme (self)` * `setAuthority (self, QString?authority)` * `setEncodedFragment (self, QByteArray?fragment)` * `setEncodedHost (self, QByteArray?host)` * `setEncodedPassword (self, QByteArray?password)` * `setEncodedPath (self, QByteArray?path)` * `setEncodedQuery (self, QByteArray?query)` * `setEncodedQueryItems (self, list-of-tuple-of-QByteArray-QByteArray?query)` * `setEncodedUrl (self, QByteArray?url)` * `setEncodedUrl (self, QByteArray?url, ParsingMode?mode)` * `setEncodedUserName (self, QByteArray?userName)` * `setFragment (self, QString?fragment)` * `setHost (self, QString?host)` * `setPassword (self, QString?password)` * `setPath (self, QString?path)` * `setPort (self, int?port)` * `setQueryDelimiters (self, str?valueDelimiter, str?pairDelimiter)` * `setQueryItems (self, list-of-tuple-of-QString-QString?query)` * `setScheme (self, QString?scheme)` * `setUrl (self, QString?url)` * `setUrl (self, QString?url, ParsingMode?mode)` * `setUserInfo (self, QString?userInfo)` * `setUserName (self, QString?userName)` * `swap (self, QUrl?other)` * `QByteArray toEncoded (self, FormattingOptions?options?=?QUrl.None)` * `QString toLocalFile (self)` * `QString topLevelDomain (self)` * `QString toString (self, FormattingOptions?options?=?QUrl.None)` * `QString userInfo (self)` * `QString userName (self)` ### Static Methods * `QString fromAce (QByteArray)` * `QUrl fromEncoded (QByteArray?url)` * `QUrl fromEncoded (QByteArray?url, ParsingMode?mode)` * `QUrl fromLocalFile (QString?localfile)` * `QString fromPercentEncoding (QByteArray)` * `QString fromPunycode (QByteArray)` * `QUrl fromUserInput (QString?userInput)` * `QStringList idnWhitelist ()` * `setIdnWhitelist (QStringList)` * `QByteArray toAce (QString)` * `QByteArray toPercentEncoding (QString?input, QByteArray?exclude?=?QByteArray(), QByteArray?include?=?QByteArray())` * `QByteArray toPunycode (QString)` ### Special Methods * `bool __eq__ (self, QUrl?url)` * `bool __ge__ (self, QUrl?url)` * `int __hash__ (self)` * `bool __lt__ (self, QUrl?url)` * `bool __ne__ (self, QUrl?url)` * `str __repr__ (self)` * * * ## Detailed Description 該QUrl類提供了一個方便的接口，用于處理URL 。 它可以解析和構造的URL在這兩個編碼和非編碼形式。 QUrl還擁有國際化域名（IDN ）的支持。 使用QUrl最常用的方法是通過構造函數傳遞給它初始化一個[QString](qstring.html)。否則，[setUrl](qurl.html#setUrl)（）和[setEncodedUrl](qurl.html#setEncodedUrl)（）也可以使用。 URL可以有兩種形式來表示：編碼和非編碼。未編碼的表示法是適于顯示給用戶，而是編碼表示通常你會發送到Web服務器什么。例如，未編碼的URL “ http://bühler.example.com/List applicants.xml的”將被發送到服務器的“ http://xn--bhler-kva.example.com/List ％ 20of ％ 20applicants.xml “ ，這可以通過調用驗證[toEncoded](qurl.html#toEncoded)（）函數。 一個URL ，也可以通過調用構造一塊一塊[setScheme](qurl.html#setScheme)（ ）[setUserName](qurl.html#setUserName)（ ）[setPassword](qurl.html#setPassword)（ ）[setHost](qurl.html#setHost)（ ）[setPort](qurl.html#setPort)（ ）[setPath](qurl.html#setPath)（ ）[setEncodedQuery](qurl.html#setEncodedQuery)（）和[setFragment](qurl.html#setFragment)（ ） 。一些方便的功能也可以：[setAuthority](qurl.html#setAuthority)（ ）設置用戶名，密碼，主機和端口。[setUserInfo](qurl.html#setUserInfo)（）設置用戶名和密碼一次。 Call [isValid](qurl.html#isValid)（ ）來檢查URL是否有效。這可以在任何一點的URL的構建過程中來完成。 構造查詢是通過使用特別方便[setQueryItems](qurl.html#setQueryItems)（ ）[addQueryItem](qurl.html#addQueryItem)（）和[removeQueryItem](qurl.html#removeQueryItem)（ ） 。使用[setQueryDelimiters](qurl.html#setQueryDelimiters)（ ）來定制用于生成查詢字符串分隔符。 為了生成編碼的URL字符串或查詢字符串的方便，有兩個靜態函數調用[fromPercentEncoding](qurl.html#fromPercentEncoding)（）和[toPercentEncoding](qurl.html#toPercentEncoding)（ ）涉及％的編碼和將QString解碼。 調用[isRelative](qurl.html#isRelative)（ ）會告訴的URL是否是相對的。相對URL可以通過將它作為參數傳遞給解決[resolved](qurl.html#resolved)（ ） ，它返回一個絕對URL 。[isParentOf](qurl.html#isParentOf)（ ）是用于確定一個URL是否是另一個的父代。 [fromLocalFile](qurl.html#fromLocalFile)（ ）通過解析本地文件路徑構造一個QUrl 。[toLocalFile](qurl.html#toLocalFile)（ ）轉換成一個URL到本地文件路徑。 URL的人類可讀的表示是牽強[toString](qurl.html#toString)（ ） 。這種表示是適合顯示的URL中未編碼形式的用戶。然而的編碼形式，所返回的[toEncoded](qurl.html#toEncoded)（ ） ，是供內部使用，傳遞給Web服務器，郵件客戶端等。 QUrl符合URI規范從[RFC 3986](http://www.rfc-editor.org/rfc/rfc3986.txt)（統一資源標識符：通用語法） ，并且包括從計劃擴展[RFC 1738](http://www.rfc-editor.org/rfc/rfc1738.txt)（統一資源定位器） 。在QUrl情況下折疊規則符合[RFC 3491](http://www.rfc-editor.org/rfc/rfc3491.txt)（ NAMEPREP ：一個STRINGPREP簡介國際化域名（ IDN ） ） 。 #### Character Conversions 遵循這些規則，以避免錯誤的字符轉換時用的URL和字符串處理： * When creating an [QString](qstring.html) to contain a URL from a [QByteArray](qbytearray.html) or a char*, always use [QString.fromUtf8](qstring.html#fromUtf8)(). * Favor the use of [QUrl.fromEncoded](qurl.html#fromEncoded)() and [QUrl.toEncoded](qurl.html#toEncoded)() instead of QUrl(string) and [QUrl.toString](qurl.html#toString)() when converting a QUrl to or from a string. * * * ## Type Documentation ``` QUrl.FormattingOption ``` 格式選項定義了如何當寫出來的文字的URL格式。 | Constant | Value | Description | | --- | --- | --- | | `QUrl.None` | `0x0` | URL的格式不變。 | | `QUrl.RemoveScheme` | `0x1` | 該計劃從URL中移除。 | | `QUrl.RemovePassword` | `0x2` | 任何密碼在URL中移除。 | | `QUrl.RemoveUserInfo` | `RemovePassword | 0x4` | URL中的任何用戶信息被刪除。 | | `QUrl.RemovePort` | `0x8` | 任何指定的端口是從URL中移除。 | | `QUrl.RemoveAuthority` | `RemoveUserInfo | RemovePort | 0x10` | ? | | `QUrl.RemovePath` | `0x20` | 在URL的路徑被刪除，只留下了方案，主機地址和端口（如果有的話） 。 | | `QUrl.RemoveQuery` | `0x40` | 網址（以下一個' ？ '字符）的查詢部分被刪除。 | | `QUrl.RemoveFragment` | `0x80` | ? | | `QUrl.StripTrailingSlash` | `0x10000` | 如果存在的斜線被刪除。 | 請注意，在折疊的規則的情況下[Nameprep](http://www.rfc-editor.org/rfc/rfc3491.txt)，這[QUrl](qurl.html)符合，需要總是被轉換為小寫的主機名，而不管使用的Qt.FormattingOptions的。 該FormattingOptions類型是一個typedef為[QFlags](index.htm)\u003cFormattingOption\u003e 。它存儲FormattingOption值的或組合。 ``` QUrl.ParsingMode ``` 解析模式控制方式[QUrl](qurl.html)解析字符串。 | Constant | Value | Description | | --- | --- | --- | | `QUrl.TolerantMode` | `0` | [QUrl](qurl.html)將設法糾正URL中一些常見的錯誤。處理用戶輸入的URL時，這種模式十分有用。 | | `QUrl.StrictMode` | `1` | 只有有效的URL被接受。此模式適用于一般的URL驗證有用。 | 在TolerantMode ，解析器修正了以下無效輸入： * Spaces and "%20": If an encoded URL contains a space, this will be replaced with "%20". If a decoded URL contains "%20", this will be replaced with a single space before the URL is parsed. * Single "%" characters: Any occurrences of a percent character "%" not followed by exactly two hexadecimal characters (e.g., "13% coverage.html") will be replaced by "%25". * Reserved and unreserved characters: An encoded URL should only contain a few characters as literals; all other characters should be percent-encoded. In TolerantMode, these characters will be automatically percent-encoded where they are not allowed: space / double-quote / "<" / ">" / "[" / "" / "]" / "^" / "`" / "{" / "|" / "}" * * * ## Method Documentation ``` QUrl.__init__ (self) ``` 構造一個空[QUrl](qurl.html)對象。 ``` QUrl.__init__ (self, QString?url) ``` 通過解析構造一個URL_url_。_url_被假定為在人類可讀表示，沒有百分之編碼。[QUrl](qurl.html)會自動％的編碼，但在URL中允許的所有字符。默認的解析模式是[TolerantMode](qurl.html#ParsingMode-enum)。 例如： ``` [QUrl](qurl.html) url("http://www.example.com/List of holidays.xml"); // url.toEncoded() == "http://www.example.com/List%20of%20holidays.xml" ``` 從一個編碼的字符串，調用構造一個URL[fromEncoded](qurl.html#fromEncoded)（）： ``` [QUrl](qurl.html) url = [QUrl](qurl.html).fromEncoded("http://qt.nokia.com/List%20of%20holidays.xml"); ``` **See also** [setUrl](qurl.html#setUrl)（ ）[setEncodedUrl](qurl.html#setEncodedUrl)（ ）[fromEncoded](qurl.html#fromEncoded)（）和[TolerantMode](qurl.html#ParsingMode-enum)。 ``` QUrl.__init__ (self, QString?url, ParsingMode?mode) ``` 構造的副本_other_。 ``` QUrl.__init__ (self, QUrl?copy) ``` 這是一個重載函數。 解析_url_使用分析器模式_parsingMode_。默認的解析模式是[TolerantMode](qurl.html#ParsingMode-enum)。 **See also** [setUrl](qurl.html#setUrl)（ ） 。 ``` QUrl.addEncodedQueryItem (self, QByteArray?key, QByteArray?value) ``` 插入對_key_=_value_到URL的查詢字符串。 注：此功能不驗證，要么_key_ or _value_被正確編碼。它是調用者的責任，以確保查詢的分隔符的編碼正確，如果有的話。 此功能被引入Qt的4.4 。 **See also** [addQueryItem](qurl.html#addQueryItem)（）和[setQueryDelimiters](qurl.html#setQueryDelimiters)（ ） 。 ``` QUrl.addQueryItem (self, QString?key, QString?value) ``` 插入對_key_=_value_到URL的查詢字符串。 之前它被添加到查詢的鍵/值對被編碼。兩人在內部轉換成單獨的字符串。該_key_和_value_首先編碼成UTF -8 ，然后由valueDelimiter （返回的字符分隔） 。每個鍵/值對是通過pairDelimiter （返回的字符分隔） 。 **Note:**此方法不編碼空格（ ASCII碼0X20 ）為加號（+ ）標志，就像HTML表單做。如果你需要這種編碼方式，你必須自己編碼值，并使用QUrl.addEncodedQueryItem 。 **See also** [addEncodedQueryItem](qurl.html#addEncodedQueryItem)（ ） 。 ``` list-of-QByteArray QUrl.allEncodedQueryItemValues (self, QByteArray?key) ``` 返回的查詢字符串值的一個列表，其關鍵是等于_key_從URL中。 注意：如果該編碼_key_不匹配查詢的編碼版本，此功能將無法正常工作。也就是說，如果該URL的編碼查詢“的搜索= Qt的％ 20Rules ” ，調用這個函數_key_= “ ％ 73earch ”將返回一個空列表。 此功能被引入Qt的4.4 。 **See also** [allQueryItemValues](qurl.html#allQueryItemValues)（ ）[queryItemValue](qurl.html#queryItemValue)（）和[encodedQueryItemValue](qurl.html#encodedQueryItemValue)（ ） 。 ``` QStringList QUrl.allQueryItemValues (self, QString?key) ``` 返回的查詢字符串值的一個列表，其關鍵是等于_key_從URL中。 **Note:**此方法不解碼的空間加號（+ ）符號空格（ ASCII碼0X20 ） ，如HTML表單做。如果你需要這種解碼，則必須使用QUrl.allEncodedQueryItemValues??和自己解碼數據。 **See also** [queryItemValue](qurl.html#queryItemValue)（ ） 。 ``` QString QUrl.authority (self) ``` 返回如果它被定義URL的權限，否則為空字符串返回。 **See also** [setAuthority](qurl.html#setAuthority)（ ） 。 ``` QUrl.clear (self) ``` 重置的內容[QUrl](qurl.html)。調用該函數后，[QUrl](qurl.html)等于一個已經構建了默認的空構造函數。 ``` QUrl.detach (self) ``` ``` QByteArray QUrl.encodedFragment (self) ``` [](qbytearray.html) [返回如果它被定義URL的片段;否則返回空字符串。返回的值將擁有非ASCII和其他控制字符百分比編碼，如](qbytearray.html)[toEncoded](qurl.html#toEncoded)（ ） 。 此功能被引入Qt的4.4 。 **See also** [setEncodedFragment](qurl.html#setEncodedFragment)（）和[toEncoded](qurl.html#toEncoded)（ ） 。 ``` QByteArray QUrl.encodedHost (self) ``` [ 返回URL的主機部分，如果它被定義，否則返回空字符串。 注： encodedHost （ ）不返回百分比編碼的主機名。取而代之的是， ACE編碼（ ASCII裸以Punycode編碼）的形式將任何非ASCII主機名返回。 ](qbytearray.html) [此功能相當于調用](qbytearray.html)[QUrl.toAce](qurl.html#toAce)（ ）上的返回值[host](qurl.html#host)（ ） 。 此功能被引入Qt的4.4 。 **See also** [setEncodedHost](qurl.html#setEncodedHost)（ ） 。 ``` QByteArray QUrl.encodedPassword (self) ``` [](qbytearray.html) [返回如果它被定義URL的密碼，否則一個空字符串返回。返回的值將擁有非ASCII和其他控制字符百分比編碼，如](qbytearray.html)[toEncoded](qurl.html#toEncoded)（ ） 。 此功能被引入Qt的4.4 。 **See also** [setEncodedPassword](qurl.html#setEncodedPassword)（）和[toEncoded](qurl.html#toEncoded)（ ） 。 ``` QByteArray QUrl.encodedPath (self) ``` [](qbytearray.html) [返回如果它被定義URL的路徑，否則返回空字符串。返回的值將擁有非ASCII和其他控制字符百分比編碼，如](qbytearray.html)[toEncoded](qurl.html#toEncoded)（ ） 。 此功能被引入Qt的4.4 。 **See also** [setEncodedPath](qurl.html#setEncodedPath)（）和[toEncoded](qurl.html#toEncoded)（ ） 。 ``` QByteArray QUrl.encodedQuery (self) ``` [ 返回百分比編碼形式的URL查詢字符串。 ](qbytearray.html) [**See also**](qbytearray.html) [setEncodedQuery](qurl.html#setEncodedQuery)（ ） 。 ``` list-of-tuple-of-QByteArray-QByteArray QUrl.encodedQueryItems (self) ``` 返回URL的查詢字符串，如編碼鍵和值的映射。 此功能被引入Qt的4.4 。 **See also** [setEncodedQueryItems](qurl.html#setEncodedQueryItems)（ ）[setQueryItems](qurl.html#setQueryItems)（）和[setEncodedQuery](qurl.html#setEncodedQuery)（ ） 。 ``` QByteArray QUrl.encodedQueryItemValue (self, QByteArray?key) ``` [ 返回第一個查詢字符串值，其關鍵是等于_key_從URL中。 注意：如果該編碼_key_不匹配查詢的編碼版本，此功能將無法正常工作。也就是說，如果該URL的編碼查詢“的搜索= Qt的％ 20Rules ” ，調用這個函數_key_= “ ％ 73earch ”將返回一個空字符串。 此功能被引入Qt的4.4 。 ](qbytearray.html) [**See also**](qbytearray.html) [queryItemValue](qurl.html#queryItemValue)（）和[allQueryItemValues](qurl.html#allQueryItemValues)（ ） 。 ``` QByteArray QUrl.encodedUserName (self) ``` [](qbytearray.html) [返回如果它被定義URL的用戶名;否則返回空字符串。返回的值將擁有非ASCII和其他控制字符百分比編碼，如](qbytearray.html)[toEncoded](qurl.html#toEncoded)（ ） 。 此功能被引入Qt的4.4 。 **See also** [setEncodedUserName](qurl.html#setEncodedUserName)（ ） 。 ``` QString QUrl.errorString (self) ``` 返回解釋了為什么一個URL是在這樣的情況下無效的文本字符串，否則返回一個空字符串。 這個函數中引入了Qt 4.2中。 ``` QString QUrl.fragment (self) ``` 返回URL的片段。 **See also** [setFragment](qurl.html#setFragment)（ ） 。 ``` QString QUrl.fromAce (QByteArray) ``` 返回Unicode形式給定的域名_domain_，它被編碼為ASCII兼容性編碼（ACE）。此函數的結果被認為是等同于_domain_。 如果該值在_domain_可以不進行編碼，它會被轉換為[QString](qstring.html)并返回。 該ASCII兼容性編碼（ACE ）是由RFC 3490 ， RFC 3491和RFC 3492中定義。它是國際化域名的應用（ IDNA ）規范，它允許域名（如部分`"example.com"`）使用國際字符寫入。 這個函數中引入了Qt 4.2中。 ``` QUrl QUrl.fromEncoded (QByteArray?url) ``` [](qurl.html) [解析_input_并返回相應的](qurl.html)[QUrl](qurl.html)。_input_被假定為以編碼形式，只包含ASCII字符。 URL是使用分析[TolerantMode](qurl.html#ParsingMode-enum)。 **See also** [toEncoded](qurl.html#toEncoded)（）和[setUrl](qurl.html#setUrl)（ ） 。 ``` QUrl QUrl.fromEncoded (QByteArray?url, ParsingMode?mode) ``` [ 這是一個重載函數。 解析使用URL_parsingMode_。 ](qurl.html) [**See also**](qurl.html) [toEncoded](qurl.html#toEncoded)（）和[setUrl](qurl.html#setUrl)（ ） 。 ``` QUrl QUrl.fromLocalFile (QString?localfile) ``` [](qurl.html) [返回](qurl.html)[QUrl](qurl.html)代表性_localFile_，解釋為一個本地文件。這個函數接受由斜線以及本地分隔這個平臺分隔的路徑。 這個函數還接受了一倍，領先的斜杠（或反斜杠）的路徑來表示一個遠程文件，如“ / /服務器名/路徑/到/ file.txt的” 。請注意，只有某些平臺上可以使用實際打開該文件[QFile.open](qfile.html#open)（ ） 。 **See also** [toLocalFile](qurl.html#toLocalFile)（ ）[isLocalFile](qurl.html#isLocalFile)（）和[QDir.toNativeSeparators](qdir.html#toNativeSeparators)（ ） 。 ``` QString QUrl.fromPercentEncoding (QByteArray) ``` 返回一個解碼副本_input_。_input_首先從百分之編碼解碼，然后轉換從UTF-8轉換為Unicode 。 ``` QString QUrl.fromPunycode (QByteArray) ``` ``` QUrl QUrl.fromUserInput (QString?userInput) ``` [](qurl.html) [從提供的用戶返回一個有效的URL_userInput_字符串如果一個人可以扣除。在這是不可能的，無效的情況下](qurl.html)[QUrl](qurl.html#QUrl)（ ）返回。 最能夠瀏覽Web應用程序，允許用戶輸入在一個普通的字符串形式的URL。這個字符串可以手動輸入到地址欄，從剪貼板獲得，或通過命令行參數傳遞。 當該字符串是不是已經是一個有效的URL ，一個最好的猜測是執行，使各種網絡相關的假設。 在該情況下，字符串對應于該系統上的一個有效的文件路徑，文件:/ / URL構造，使用[QUrl.fromLocalFile](qurl.html#fromLocalFile)（ ） 。 如果不是這種情況，試圖把串入一個http://或ftp:// URL協議。在該情況下，后者的字符串開頭是'ftp ' 。結果，然后通過傳遞[QUrl](qurl.html)的寬容解析器，并在案件或成功，有效的[QUrl](qurl.html)返回，否則一[QUrl](qurl.html#QUrl)（ ） 。 #### Examples: * qt.nokia.com becomes http://qt.nokia.com * ftp.qt.nokia.com becomes ftp://ftp.qt.nokia.com * hostname becomes http://hostname * /home/user/test.html becomes file:///home/user/test.html 此功能被引入Qt的4.6 。 ``` bool QUrl.hasEncodedQueryItem (self, QByteArray?key) ``` 返回True如果有一個查詢字符串對，其關鍵是等于_key_從URL中。 注意：如果該編碼_key_不匹配查詢的編碼版本，這個函數將返回False 。也就是說，如果該URL的編碼查詢“的搜索= Qt的％ 20Rules ” ，調用這個函數_key_= “ ％ 73earch ”將返回False 。 此功能被引入Qt的4.4 。 **See also** [hasQueryItem](qurl.html#hasQueryItem)（ ） 。 ``` bool QUrl.hasFragment (self) ``` 返回True如果該URL包含一個片段（例如，如果＃ ，看到就可以了） 。 這個函數中引入了Qt 4.2中。 **See also** [fragment](qurl.html#fragment)（）和[setFragment](qurl.html#setFragment)（ ） 。 ``` bool QUrl.hasQuery (self) ``` 返回True如果該URL包含查詢（即，如果？被認為就可以了） 。 這個函數中引入了Qt 4.2中。 **See also** [hasQueryItem](qurl.html#hasQueryItem)（）和[encodedQuery](qurl.html#encodedQuery)（ ） 。 ``` bool QUrl.hasQueryItem (self, QString?key) ``` 返回True如果有一個查詢字符串對，其關鍵是等于_key_從URL中。 **See also** [hasEncodedQueryItem](qurl.html#hasEncodedQueryItem)（ ） 。 ``` QString QUrl.host (self) ``` 返回如果它被定義URL的主機;否則返回空字符串。 **See also** [setHost](qurl.html#setHost)（ ） 。 ``` QStringList QUrl.idnWhitelist () ``` 返回被允許有非ASCII字符在他們的作文頂級域的當前白名單。 See [setIdnWhitelist](qurl.html#setIdnWhitelist)（ ）就本列表的理由。 這個函數中引入了Qt 4.2中。 **See also** [setIdnWhitelist](qurl.html#setIdnWhitelist)（ ） 。 ``` bool QUrl.isDetached (self) ``` ``` bool QUrl.isEmpty (self) ``` 返回True如果URL中沒有數據，否則返回False 。 ``` bool QUrl.isLocalFile (self) ``` 返回True如果這個URL是指向一個本地文件路徑。 URL是本地文件路徑，如果該計劃是“文件” 。 注意，這個函數考慮的URL與主機名是本地文件路徑，即使最終的文件路徑不能打開[QFile.open](qfile.html#open)（ ） 。 此功能被引入Qt的4.8 。 **See also** [fromLocalFile](qurl.html#fromLocalFile)（）和[toLocalFile](qurl.html#toLocalFile)（ ） 。 ``` bool QUrl.isParentOf (self, QUrl?url) ``` 返回True如果這個URL是父_childUrl_。_childUrl_這是URL的孩子，如果兩個URL共享相同的方案和權威，這個URL的路徑是路徑的父_childUrl_。 ``` bool QUrl.isRelative (self) ``` 返回True如果該URL是相對的，否則返回False 。 URL是相對的，如果它的方案是不確定的，因此這個函數相當于調用[scheme](qurl.html#scheme)（ ） 。[isEmpty](qurl.html#isEmpty)（ ） 。 ``` bool QUrl.isValid (self) ``` 返回True如果該URL是有效的，否則返回False 。 該URL通過一致性測試運行。 URL的每一個部分都必須符合報告為有效的URL的URI標準的標準編碼規則。 ``` bool checkUrl(const [QUrl](qurl.html) &url) { if (!url.isValid()) { qDebug([QString](qstring.html)("Invalid URL: %1").arg(url.toString())); return false; } return true; } ``` ``` QString QUrl.password (self) ``` 返回如果它被定義URL的密碼，否則一個空字符串返回。 **See also** [setPassword](qurl.html#setPassword)（ ） 。 ``` QString QUrl.path (self) ``` ``` int QUrl.port (self) ``` 返回URL的端口，或-1，如果該端口是不確定的。 **See also** [setPort](qurl.html#setPort)（ ） 。 ``` int QUrl.port (self, int?defaultPort) ``` 這是一個重載函數。 返回URL的端口，或_defaultPort_如果端口是不確定的。 例如： ``` [QFtp](qftp.html) ftp; ftp.connectToHost(url.host(), url.port(21)); ``` 這個函數是Qt 4.1中引入。 ``` list-of-tuple-of-QString-QString QUrl.queryItems (self) ``` 返回URL的查詢字符串作為鍵和值的映射。 **Note:**此方法不解碼的空間加號（+ ）符號空格（ ASCII碼0X20 ） ，如HTML表單做。如果你需要這種解碼，則必須使用QUrl.encodedQueryItems和自己解碼數據。 **See also** [setQueryItems](qurl.html#setQueryItems)（）和[setEncodedQuery](qurl.html#setEncodedQuery)（ ） 。 ``` QString QUrl.queryItemValue (self, QString?key) ``` 返回第一個查詢字符串值，其關鍵是等于_key_從URL中。 **Note:**此方法不解碼的空間加號（+ ）符號空格（ ASCII碼0X20 ） ，如HTML表單做。如果你需要這種解碼，則必須使用QUrl.encodedQueryItemValue和自己解碼數據。 **See also** [allQueryItemValues](qurl.html#allQueryItemValues)（ ） 。 ``` str QUrl.queryPairDelimiter (self) ``` 返回用于在URL中的查詢字符串鍵值對之間的分隔字符。 ``` str QUrl.queryValueDelimiter (self) ``` 返回用于在URL中的查詢字符串鍵和值之間的分隔字符。 ``` QUrl.removeAllEncodedQueryItems (self, QByteArray?key) ``` 刪除所有的查詢字符串對的關鍵是等于_key_從URL中。 注意：如果該編碼_key_不匹配查詢的編碼版本，此功能將無法正常工作。也就是說，如果該URL的編碼查詢“的搜索= Qt的％ 20Rules ” ，調用這個函數_key_= “ ％ 73earch ”不會做任何事。 此功能被引入Qt的4.4 。 **See also** [removeQueryItem](qurl.html#removeQueryItem)（ ） 。 ``` QUrl.removeAllQueryItems (self, QString?key) ``` 刪除所有的查詢字符串對的關鍵是等于_key_從URL中。 **See also** [removeQueryItem](qurl.html#removeQueryItem)（ ） 。 ``` QUrl.removeEncodedQueryItem (self, QByteArray?key) ``` 刪除第一個查詢字符串對，其關鍵是等于_key_從URL中。 注意：如果該編碼_key_不匹配查詢的編碼版本，此功能將無法正常工作。也就是說，如果該URL的編碼查詢“的搜索= Qt的％ 20Rules ” ，調用這個函數_key_= “ ％ 73earch ”不會做任何事。 此功能被引入Qt的4.4 。 **See also** [removeQueryItem](qurl.html#removeQueryItem)（）和[removeAllQueryItems](qurl.html#removeAllQueryItems)（ ） 。 ``` QUrl.removeQueryItem (self, QString?key) ``` 刪除第一個查詢字符串對，其關鍵是等于_key_從URL中。 **See also** [removeAllQueryItems](qurl.html#removeAllQueryItems)（ ） 。 ``` QUrl QUrl.resolved (self, QUrl?relative) ``` [ 返回此URL的合并的結果與_relative_。這個URL被用作基礎來轉換_relative_一個絕對URL 。 If _relative_是不是一個相對的URL ，這個函數將返回_relative_直接。否則，這兩個URL的路徑被合并，并返回該新URL的基URL的方案和權威，但合并后的路徑，如下面的例子： ](qurl.html) ``` QUrl baseUrl("http://qt.nokia.com/support"); [QUrl](qurl.html) relativeUrl("../products/solutions"); qDebug(baseUrl.resolved(relativeUrl).toString()); // prints "http://qt.nokia.com/products/solutions" ``` 呼叫解決（ ）與“..”返回[QUrl](qurl.html)其目錄是比原來更高一層。同樣，調用解析（ ）用“ .. / .. ”從路徑中移除兩個層次。如果_relative_是“/” ，路徑變為“/”。 **See also** [isRelative](qurl.html#isRelative)（ ） 。 ``` QString QUrl.scheme (self) ``` 返回URL的方案。如果返回一個空字符串，這意味著該計劃是不確定的，網址是那么相對的。 **See also** [setScheme](qurl.html#setScheme)（）和[isRelative](qurl.html#isRelative)（ ） 。 ``` QUrl.setAuthority (self, QString?authority) ``` 設置URL的權限_authority_。 URL的權限是用戶信息，主機名和端口的組合。所有這些元素都是可選的，因此一個空的權力是有效的。 用戶信息和主機是通過一個“分開[@](index.html)“：” ，并在主機和端口通過一個分離“ 。如果用戶信息是空的，則'[@](index.html)“必須省略，雖然流浪'：'是允許的，如果該端口為空。 下面的例子顯示了一個有效的權威字符串：  **See also** [authority](qurl.html#authority)（ ） 。 ``` QUrl.setEncodedFragment (self, QByteArray?fragment) ``` 設定URL的片段的百分比編碼_fragment_。該片段是URL的最后部分，通過一個“＃”后面字符的字符串來表示。它通常用于在HTTP進行指的是頁面上的某條鏈路或點：  的片段，有時也被稱為URL為“參考” 。 通過QByteArray中（的說法） （空[QByteArray](qbytearray.html)）將取消設置的片段。傳遞的參數[QByteArray](qbytearray.html)（ “”） （空但不為空[QByteArray](qbytearray.html)）將設置片段為空字符串（就像原始的URL了一個孤獨的“＃” ） 。 此功能被引入Qt的4.4 。 **See also** [setFragment](qurl.html#setFragment)（）和[encodedFragment](qurl.html#encodedFragment)（ ） 。 ``` QUrl.setEncodedHost (self, QByteArray?host) ``` 設定URL的主機與ACE -或百分比編碼_host_。該_host_是在URL的權限的用戶信息元素的一部分，如描述[setAuthority](qurl.html#setAuthority)（ ） 。 此功能被引入Qt的4.4 。 **See also** [setHost](qurl.html#setHost)（ ）[encodedHost](qurl.html#encodedHost)（ ）[setAuthority](qurl.html#setAuthority)（）和[fromAce](qurl.html#fromAce)（ ） 。 ``` QUrl.setEncodedPassword (self, QByteArray?password) ``` 設定URL的密碼，以百分比編碼_password_。該_password_是在URL的權限的用戶信息元素的一部分，如描述[setUserInfo](qurl.html#setUserInfo)（ ） 。 注：此功能不會驗證_password_被正確編碼。它是調用者的責任，以確保任何分隔符（如冒號或斜線）被正確編碼。 此功能被引入Qt的4.4 。 **See also** [setPassword](qurl.html#setPassword)（ ）[encodedPassword](qurl.html#encodedPassword)（）和[setUserInfo](qurl.html#setUserInfo)（ ） 。 ``` QUrl.setEncodedPath (self, QByteArray?path) ``` 設定URL的路徑百分比編碼_path_。該路徑是自帶的權威之后，但在查詢字符串之前的URL的一部分。  對于非分層方案，路徑將是一切按照計劃的聲明，如下面的示例所示：  注：此功能不會驗證_path_被正確編碼。它是調用者的責任，以確保任何分隔符（如'？'和'＃' ）被正確編碼。 此功能被引入Qt的4.4 。 **See also** [setPath](qurl.html#setPath)（ ）[encodedPath](qurl.html#encodedPath)（）和[setUserInfo](qurl.html#setUserInfo)（ ） 。 ``` QUrl.setEncodedQuery (self, QByteArray?query) ``` URL的查詢字符串設置為_query_。該字符串被插入原樣，并且打電話時不進行任何進一步的編碼[toEncoded](qurl.html#toEncoded)（ ） 。 如果你需要傳遞一個不適合的鍵 - 值模式的查詢字符串，此功能非常有用，或者使用不同的方案進行編碼特殊字符，比什么建議由[QUrl](qurl.html)。 通過QByteArray中的（值）至_query_（空[QByteArray](qbytearray.html)）完全取消設置的查詢。然而，路過的值[QByteArray](qbytearray.html)（ “”）將查詢設置為空值，因為如果原始URL有一個孤獨的“ ？ ” 。 **See also** [encodedQuery](qurl.html#encodedQuery)（）和[hasQuery](qurl.html#hasQuery)（ ） 。 ``` QUrl.setEncodedQueryItems (self, list-of-tuple-of-QByteArray-QByteArray?query) ``` URL的查詢字符串設置為的編碼版本_query_。的內容_query_被轉換為字符串內部，每對由pairDelimiter （ ）返回的字符，鍵和值分隔由valueDelimiter （分隔） 。 注：此功能不確認鍵 - 值對的編碼正確。它是調用者的責任，以確保查詢的分隔符的編碼正確，如果有的話。 此功能被引入Qt的4.4 。 **See also** [setQueryDelimiters](qurl.html#setQueryDelimiters)（ ）[encodedQueryItems](qurl.html#encodedQueryItems)（）和[setQueryItems](qurl.html#setQueryItems)（ ） 。 ``` QUrl.setEncodedUrl (self, QByteArray?url) ``` 通過解析的內容構造一個URL_encodedUrl_。 _encodedUrl_被假定為一個URL字符串的百分比編碼形式，只包含ASCII字符。 使用[isValid](qurl.html#isValid)（ ） ，以確定是否一個有效的URL構建。 **See also** [setUrl](qurl.html#setUrl)（ ） 。 ``` QUrl.setEncodedUrl (self, QByteArray?url, ParsingMode?mode) ``` 通過解析的內容構造一個URL_encodedUrl_使用給定的_parsingMode_。 ``` QUrl.setEncodedUserName (self, QByteArray?userName) ``` 設定URL的用戶名的百分比編碼_userName_。該_userName_是在URL的權限的用戶信息元素的一部分，如描述[setUserInfo](qurl.html#setUserInfo)（ ） 。 注：此功能不會驗證_userName_被正確編碼。它是調用者的責任，以確保任何分隔符（如冒號或斜線）被正確編碼。 此功能被引入Qt的4.4 。 **See also** [setUserName](qurl.html#setUserName)（ ）[encodedUserName](qurl.html#encodedUserName)（）和[setUserInfo](qurl.html#setUserInfo)（ ） 。 ``` QUrl.setFragment (self, QString?fragment) ``` 設置URL的片段_fragment_。該片段是URL的最后部分，通過一個“＃”后面字符的字符串來表示。它通常用于在HTTP進行指的是頁面上的某條鏈路或點：  的片段，有時也被稱為URL為“參考” 。 路過的QString （的說法） （空[QString](qstring.html)）將取消設置的片段。傳遞的參數[QString](qstring.html)（ “”） （空但不為空[QString](qstring.html)）將設置片段為空字符串（就像原始的URL了一個孤獨的“＃” ） 。 **See also** [fragment](qurl.html#fragment)（）和[hasFragment](qurl.html#hasFragment)（ ） 。 ``` QUrl.setHost (self, QString?host) ``` 設置URL的主機_host_。主機是權威的一部分。 **See also** [host](qurl.html#host)（）和[setAuthority](qurl.html#setAuthority)（ ） 。 ``` QUrl.setIdnWhitelist (QStringList) ``` 集頂級域名（TLD ）中被允許有非ASCII字符的域值的白名單_list_。 請注意，如果你調用這個函數，你需要做這樣**`\em`**你開始可能訪問任何線程之前[idnWhitelist](qurl.html#idnWhitelist)（ ） 。 Qt擁有自帶包含已發布國際化域名（IDN ）和規則的支持，以保證沒有欺騙同樣可以看的字符（如拉丁小寫字母之間發生的互聯網頂級域的默認列表`'a'`和西里爾當量，這在大多數字體是視覺上相同） 。 這份清單會定期維護，如登記發布新規則。 這個功能是為那些誰需要操作的列表，以添加或刪除頂級域名。這是不建議改變其用途以外的其他測試值，因為它可能會暴露用戶的安全風險。 這個函數中引入了Qt 4.2中。 **See also** [idnWhitelist](qurl.html#idnWhitelist)（ ） 。 ``` QUrl.setPassword (self, QString?password) ``` 設定URL的密碼_password_。該_password_是在URL的權限的用戶信息元素的一部分，如描述[setUserInfo](qurl.html#setUserInfo)（ ） 。 **See also** [password](qurl.html#password)（）和[setUserInfo](qurl.html#setUserInfo)（ ） 。 ``` QUrl.setPath (self, QString?path) ``` 設置的URL的路徑_path_。該路徑是自帶的權威之后，但在查詢字符串之前的URL的一部分。  對于非分層方案，路徑將是一切按照計劃的聲明，如下面的示例所示：  **See also** [path](qurl.html#pathx)（ ） 。 ``` QUrl.setPort (self, int?port) ``` 設置URL的端口_port_。該港口是URL的權威的一部分，如描述[setAuthority](qurl.html#setAuthority)（ ） 。 _port_必須在0到65535之間的包容性。端口設置為-1表示該端口是不確定的。 **See also** [port](qurl.html#port)（ ） 。 ``` QUrl.setQueryDelimiters (self, str?valueDelimiter, str?pairDelimiter) ``` 設置用于鍵和值之間的分隔字符，并在URL的查詢字符串鍵值對之間。默認值為分隔符是“=” ，默認對分隔符是“＆” 。  _valueDelimiter_將用于從值分離鍵和_pairDelimiter_將用于單獨的鍵 - 值對。在查詢字符串中的鍵和值的編碼表示這些分隔字符出現的所有百分比編碼。 If _valueDelimiter_被設置為“ - ”和_pairDelimiter_是'/' ，上面的查詢字符串將代替來表示是這樣的： ``` http://www.example.com/cgi-bin/drawgraph.cgi?type-pie/color-green ``` 調用此函數不改變目前的查詢字符串的分隔符。它只會影響[queryItems](qurl.html#queryItems)（ ）[setQueryItems](qurl.html#setQueryItems)（）和addQueryItems （） 。 ``` QUrl.setQueryItems (self, list-of-tuple-of-QString-QString?query) ``` URL的查詢字符串設置為的編碼版本_query_。的內容_query_被轉換為字符串內部，每對由pairDelimiter （ ）返回的字符，鍵和值分隔由valueDelimiter （分隔） 。 **Note:**此方法不編碼空格（ ASCII碼0X20 ）為加號（+ ）標志，就像HTML表單做。如果你需要這種編碼方式，你必須自己編碼值，并使用QUrl.setEncodedQueryItems 。 **See also** [setQueryDelimiters](qurl.html#setQueryDelimiters)（ ）[queryItems](qurl.html#queryItems)（）和[setEncodedQueryItems](qurl.html#setEncodedQueryItems)（ ） 。 ``` QUrl.setScheme (self, QString?scheme) ``` 設置URL的計劃_scheme_。作為一個方案只能包含ASCII字符，沒有轉換或編碼完成對輸入。 該計劃描述了URL的類型（或協議） 。 “：”它是由一個或多個ASCII字符，在開始的URL ，并且后跟一個表示。下面的例子顯示了一個URL如該計劃是“ ftp”的：  該方案還可以是空的，在這種情況下該URL被解釋為相。 **See also** [scheme](qurl.html#scheme)（）和[isRelative](qurl.html#isRelative)（ ） 。 ``` QUrl.setUrl (self, QString?url) ``` 通過解析的內容構造一個URL_url_。 _url_被假定為Unicode格式，不帶％的編碼。 調用[isValid](qurl.html#isValid)（ ）會告訴一個有效的URL是否被建造。 **See also** [setEncodedUrl](qurl.html#setEncodedUrl)（ ） 。 ``` QUrl.setUrl (self, QString?url, ParsingMode?mode) ``` 這是一個重載函數。 解析_url_使用該模式解析_parsingMode_。 **See also** [setEncodedUrl](qurl.html#setEncodedUrl)（ ） 。 ``` QUrl.setUserInfo (self, QString?userInfo) ``` 設置URL的用戶信息來_userInfo_。用戶信息是URL的權威的可選部分，如第[setAuthority](qurl.html#setAuthority)(). 用戶信息包括用戶名和任選的密碼，由一個分離的“：” 。如果密碼是空的，結腸必須被省略。下面的例子顯示了一個有效的用戶信息字符串：  **See also** [userInfo](qurl.html#userInfo)（ ）[setUserName](qurl.html#setUserName)（ ）[setPassword](qurl.html#setPassword)（）和[setAuthority](qurl.html#setAuthority)（ ） 。 ``` QUrl.setUserName (self, QString?userName) ``` 設定URL的用戶名_userName_。該_userName_是在URL的權限的用戶信息元素的一部分，如描述[setUserInfo](qurl.html#setUserInfo)（ ） 。 **See also** [setEncodedUserName](qurl.html#setEncodedUserName)（ ）[userName](qurl.html#userName)（）和[setUserInfo](qurl.html#setUserInfo)（ ） 。 ``` QUrl.swap (self, QUrl?other) ``` 交換鏈接_other_與此URL 。這個操作是非常快的，而且永遠不會。 此功能被引入Qt的4.8 。 ``` QByteArray QUrl.toAce (QString) ``` [ 返回給定域名的ASCII兼容編碼_domain_。此函數的結果被認為是等同于_domain_。 將ASCII兼容編碼（ACE ）是由RFC 3490 ， RFC 3491和RFC 3492中定義。它是國際化域名的應用（ IDNA ）規范，它允許域名（如部分`"example.com"`）使用國際字符寫入。 這個函數返回一個空QByteArra如果_domain_是不是一個有效的主機名。請注意，特別是IPv6文本不是有效的域名。 這個函數中引入了Qt 4.2中。 ](qbytearray.html) ``` QByteArray QUrl.toEncoded (self, FormattingOptions?options?=?QUrl.None) ``` [](qbytearray.html) [返回URL的編碼表示，如果是有效的，否則空](qbytearray.html)[QByteArray](qbytearray.html)返回。該輸出可以通過傳遞標志與定制_options_。 用戶信息，路徑和片段都轉換為UTF- 8 ，而所有非ASCII字符，然后％的編碼。主機名是使用Punycode的編碼。 ``` QString QUrl.toLocalFile (self) ``` 返回URL格式化為一個本地文件路徑的路徑。返回的路徑將使用正斜杠，即使它最初是從一個與反斜杠創建。 如果這個URL中包含一個非空主機名，它會被編碼的返回值在中小企業網絡（例如， “ / /服務器名/路徑/到/ file.txt的” ）發現的形式。 如果這是一個相對URL ，在Qt 4.x的這個函數返回的路徑，以保持向后兼容性。這將改變從5.0起。那么路徑是唯一的網址如該計劃是“文件”返回，并為所有其他URL的返回空字符串。 **See also** [fromLocalFile](qurl.html#fromLocalFile)（）和[isLocalFile](qurl.html#isLocalFile)（ ） 。 ``` QByteArray QUrl.toPercentEncoding (QString?input, QByteArray?exclude?=?QByteArray(), QByteArray?include?=?QByteArray()) ``` [ 返回的編碼副本_input_。_input_首先被轉化為UTF -8 ，和所有的ASCII字符是不是在毫無保留的組是百分之編碼。為了防止字符被編碼的百分之通過他們來_exclude_。要強制字符是百分比編碼傳遞給他們_include_。 ](qbytearray.html) [未保留的定義是： ALPHA / DIGIT /“ - ”/“。 ” / “](qbytearray.html)[_](index.html)“/” ?“ ``` [QByteArray](qbytearray.html) ba = [QUrl](qurl.html).toPercentEncoding("{a fishy string?}", "{}", "s"); qDebug(ba.constData()); // prints "{a fi%73hy %73tring%3F}" ``` ``` QString QUrl.topLevelDomain (self) ``` 返回URL的TLD （頂級域名） ， （如。 co.uk ， 。凈額） 。請注意，返回值前面帶一個“。”除非該網址沒有包含有效的頂級域名，在這種情況下，函數返回一個空字符串。 此功能被引入Qt的4.8 。 ``` QByteArray QUrl.toPunycode (QString) ``` [ ``` QString QUrl.toString (self, FormattingOptions?options?=?QUrl.None) ``` 返回URL的人顯示的字符串表示形式。該輸出可以通過傳遞標志與定制_options_。 ](qbytearray.html) [**See also**](qbytearray.html) [FormattingOptions](qurl.html#FormattingOption-enum)和[toEncoded](qurl.html#toEncoded)（ ） 。 ``` QString QUrl.userInfo (self) ``` 返回URL的用戶信息，或空字符串，如果用戶信息是不確定的。 **See also** [setUserInfo](qurl.html#setUserInfo)（ ） 。 ``` QString QUrl.userName (self) ``` 返回如果它被定義URL的用戶名;否則返回空字符串。 **See also** [setUserName](qurl.html#setUserName)（）和[encodedUserName](qurl.html#encodedUserName)（ ） 。 ``` bool QUrl.__eq__ (self, QUrl?url) ``` ``` bool QUrl.__ge__ (self, QUrl?url) ``` ``` int QUrl.__hash__ (self) ``` ``` bool QUrl.__lt__ (self, QUrl?url) ``` ``` bool QUrl.__ne__ (self, QUrl?url) ``` ``` str QUrl.__repr__ (self) ```