• PySide 模块
  • PySide.QtCore
  • 内容表

    上一话题

    QByteArray

    下一话题

    QGenericArgument

    QUrl

    概要

    函数

    静态函数

    详细描述

    PySide.QtCore.QUrl class provides a convenient interface for working with URLs.

    It can parse and construct URLs in both encoded and unencoded form. PySide.QtCore.QUrl also has support for internationalized domain names (IDNs).

    The most common way to use PySide.QtCore.QUrl is to initialize it via the constructor by passing a PySide.QtCore.QString 。否则, PySide.QtCore.QUrl.setUrl() and PySide.QtCore.QUrl.setEncodedUrl() can also be used.

    URLs can be represented in two forms: encoded or unencoded. The unencoded representation is suitable for showing to users, but the encoded representation is typically what you would send to a web server. For example, the unencoded URL “ http:/ /bühler.example.com” would be sent to the server as “ http://xn–bhler-kva.example.com/List%20of%20applicants.xml ”.

    URL 也可以逐段构造通过调用 PySide.QtCore.QUrl.setScheme() , PySide.QtCore.QUrl.setUserName() , PySide.QtCore.QUrl.setPassword() , PySide.QtCore.QUrl.setHost() , PySide.QtCore.QUrl.setPort() , PySide.QtCore.QUrl.setPath() , PySide.QtCore.QUrl.setEncodedQuery() and PySide.QtCore.QUrl.setFragment() . Some convenience functions are also available: PySide.QtCore.QUrl.setAuthority() sets the user name, password, host and port. PySide.QtCore.QUrl.setUserInfo() sets the user name and password at once.

    调用 PySide.QtCore.QUrl.isValid() to check if the URL is valid. This can be done at any point during the constructing of a URL.

    Constructing a query is particularly convenient through the use of PySide.QtCore.QUrl.setQueryItems() , PySide.QtCore.QUrl.addQueryItem() and PySide.QtCore.QUrl.removeQueryItem() 。使用 PySide.QtCore.QUrl.setQueryDelimiters() to customize the delimiters used for generating the query string.

    为方便生成编码 URL 字符串或查询字符串,有 2 个静态函数称为 PySide.QtCore.QUrl.fromPercentEncoding() and PySide.QtCore.QUrl.toPercentEncoding() which deal with percent encoding and decoding of QStrings.

    调用 PySide.QtCore.QUrl.isRelative() will tell whether or not the URL is relative. A relative URL can be resolved by passing it as argument to PySide.QtCore.QUrl.resolved() , which returns an absolute URL. PySide.QtCore.QUrl.isParentOf() is used for determining whether one URL is a parent of another.

    PySide.QtCore.QUrl.fromLocalFile() constructs a PySide.QtCore.QUrl by parsing a local file path. PySide.QtCore.QUrl.toLocalFile() converts a URL to a local file path.

    人类可读 URL 表示的抓取是采用 PySide.QtCore.QUrl.toString() . This representation is appropriate for displaying a URL to a user in unencoded form. The encoded form however, as returned by PySide.QtCore.QUrl.toEncoded() , is for internal use, passing to web servers, mail clients and so on.

    PySide.QtCore.QUrl conforms to the URI specification from RFC 3986 (URI 统一资源标识符:通用句法),而包括的方案扩展来自 RFC 1738 (Uniform Resource Locators). Case folding rules in PySide.QtCore.QUrl conform to RFC 3491 (Nameprep: A Stringprep Profile for Internationalized Domain Names (IDN)).

    字符转换

    遵循这些规则以避免错误字符转换,当处理 URL 和字符串时:

    class PySide.QtCore. QUrl
    class PySide.QtCore. QUrl ( url )
    class PySide.QtCore. QUrl ( url , mode )
    class PySide.QtCore. QUrl ( copy )
    参数:
    PySide.QtCore.QUrl. ParsingMode
    PySide.QtCore.QUrl. FormattingOption
    PySide.QtCore.QUrl. __reduce__ ( )
    返回类型: PyObject
    PySide.QtCore.QUrl. __repr__ ( )
    返回类型: PyObject
    PySide.QtCore.QUrl. addEncodedQueryItem ( key , value )
    参数:
    PySide.QtCore.QUrl. addQueryItem ( key , value )
    参数:
    • key – unicode
    • value – unicode
    PySide.QtCore.QUrl. allEncodedQueryItemValues ( key )
    参数: key PySide.QtCore.QByteArray
    返回类型:
    PySide.QtCore.QUrl. allQueryItemValues ( key )
    参数: key – unicode
    返回类型: 字符串列表
    PySide.QtCore.QUrl. authority ( )
    返回类型: unicode
    PySide.QtCore.QUrl. clear ( )
    PySide.QtCore.QUrl. encodedFragment ( )
    返回类型: PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. encodedHost ( )
    返回类型: PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. encodedPassword ( )
    返回类型: PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. encodedPath ( )
    返回类型: PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. encodedQuery ( )
    返回类型: PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. encodedQueryItemValue ( key )
    参数: key PySide.QtCore.QByteArray
    返回类型: PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. encodedQueryItems ( )
    返回类型:
    PySide.QtCore.QUrl. encodedUserName ( )
    返回类型: PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. errorString ( )
    返回类型: unicode
    PySide.QtCore.QUrl. fragment ( )
    返回类型: unicode
    static PySide.QtCore.QUrl. fromAce ( arg__1 )
    参数: arg__1 PySide.QtCore.QByteArray
    返回类型: unicode
    static PySide.QtCore.QUrl. fromEncoded ( url , mode )
    参数:
    返回类型:

    PySide.QtCore.QUrl

    static PySide.QtCore.QUrl. fromEncoded ( url )
    参数: url PySide.QtCore.QByteArray
    返回类型: PySide.QtCore.QUrl
    static PySide.QtCore.QUrl. fromLocalFile ( localfile )
    参数: localfile – unicode
    返回类型: PySide.QtCore.QUrl
    static PySide.QtCore.QUrl. fromPercentEncoding ( arg__1 )
    参数: arg__1 PySide.QtCore.QByteArray
    返回类型: unicode
    static PySide.QtCore.QUrl. fromPunycode ( arg__1 )
    参数: arg__1 PySide.QtCore.QByteArray
    返回类型: unicode
    static PySide.QtCore.QUrl. fromUserInput ( userInput )
    参数: userInput – unicode
    返回类型: PySide.QtCore.QUrl
    PySide.QtCore.QUrl. hasEncodedQueryItem ( key )
    参数: key PySide.QtCore.QByteArray
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. hasFragment ( )
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. hasQuery ( )
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. hasQueryItem ( key )
    参数: key – unicode
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. host ( )
    返回类型: unicode
    static PySide.QtCore.QUrl. idnWhitelist ( )
    返回类型: 字符串列表
    PySide.QtCore.QUrl. isEmpty ( )
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. isLocalFile ( )
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. isParentOf ( url )
    参数: url PySide.QtCore.QUrl
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. isRelative ( )
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. isValid ( )
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. __ne__ ( url )
    参数: url PySide.QtCore.QUrl
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. __lt__ ( url )
    参数: url PySide.QtCore.QUrl
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. __eq__ ( url )
    参数: url PySide.QtCore.QUrl
    返回类型: PySide.QtCore.bool
    PySide.QtCore.QUrl. password ( )
    返回类型: unicode
    PySide.QtCore.QUrl. path ( )
    返回类型: unicode
    PySide.QtCore.QUrl. port ( )
    返回类型: PySide.QtCore.int
    PySide.QtCore.QUrl. port ( defaultPort )
    参数: defaultPort PySide.QtCore.int
    返回类型: PySide.QtCore.int
    PySide.QtCore.QUrl. queryItemValue ( key )
    参数: key – unicode
    返回类型: unicode
    PySide.QtCore.QUrl. queryItems ( )
    返回类型:
    PySide.QtCore.QUrl. queryPairDelimiter ( )
    返回类型: PySide.QtCore.char
    PySide.QtCore.QUrl. queryValueDelimiter ( )
    返回类型: PySide.QtCore.char
    PySide.QtCore.QUrl. removeAllEncodedQueryItems ( key )
    参数: key PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. removeAllQueryItems ( key )
    参数: key – unicode
    PySide.QtCore.QUrl. removeEncodedQueryItem ( key )
    参数: key PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. removeQueryItem ( key )
    参数: key – unicode
    PySide.QtCore.QUrl. resolved ( relative )
    参数: relative PySide.QtCore.QUrl
    返回类型: PySide.QtCore.QUrl
    PySide.QtCore.QUrl. scheme ( )
    返回类型: unicode
    PySide.QtCore.QUrl. setAuthority ( authority )
    参数: authority – unicode
    PySide.QtCore.QUrl. setEncodedFragment ( fragment )
    参数: fragment PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. setEncodedHost ( host )
    参数: host PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. setEncodedPassword ( password )
    参数: password PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. setEncodedPath ( path )
    参数: path PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. setEncodedQuery ( query )
    参数: query PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. setEncodedQueryItems ( query )
    参数: query
    PySide.QtCore.QUrl. setEncodedUrl ( url , mode )
    参数:
    PySide.QtCore.QUrl. setEncodedUrl ( url )
    参数: url PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. setEncodedUserName ( userName )
    参数: userName PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. setFragment ( fragment )
    参数: fragment – unicode
    PySide.QtCore.QUrl. setHost ( host )
    参数: host – unicode
    static PySide.QtCore.QUrl. setIdnWhitelist ( arg__1 )
    参数: arg__1 – list of strings
    PySide.QtCore.QUrl. setPassword ( password )
    参数: password – unicode
    PySide.QtCore.QUrl. setPath ( path )
    参数: path – unicode
    PySide.QtCore.QUrl. setPort ( port )
    参数: port PySide.QtCore.int
    PySide.QtCore.QUrl. setQueryDelimiters ( valueDelimiter , pairDelimiter )
    参数:
    • valueDelimiter PySide.QtCore.char
    • pairDelimiter PySide.QtCore.char
    PySide.QtCore.QUrl. setQueryItems ( query )
    参数: query
    PySide.QtCore.QUrl. setScheme ( scheme )
    参数: scheme – unicode
    PySide.QtCore.QUrl. setUrl ( url , mode )
    参数:
    PySide.QtCore.QUrl. setUrl ( url )
    参数: url – unicode
    PySide.QtCore.QUrl. setUserInfo ( userInfo )
    参数: userInfo – unicode
    PySide.QtCore.QUrl. setUserName ( userName )
    参数: userName – unicode
    PySide.QtCore.QUrl. swap ( other )
    参数: other PySide.QtCore.QUrl
    static PySide.QtCore.QUrl. toAce ( arg__1 )
    参数: arg__1 – unicode
    返回类型: PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. toEncoded ( [ options=QUrl.None ] )
    参数: options PySide.QtCore.QUrl.FormattingOptions
    返回类型: PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. toLocalFile ( )
    返回类型: unicode
    static PySide.QtCore.QUrl. toPercentEncoding ( arg__1 [ , exclude=QByteArray() [ , include=QByteArray() ] ] )
    参数:
    返回类型:

    PySide.QtCore.QByteArray

    static PySide.QtCore.QUrl. toPunycode ( arg__1 )
    参数: arg__1 – unicode
    返回类型: PySide.QtCore.QByteArray
    PySide.QtCore.QUrl. toString ( [ options=QUrl.None ] )
    参数: options PySide.QtCore.QUrl.FormattingOptions
    返回类型: unicode
    PySide.QtCore.QUrl. topLevelDomain ( )
    返回类型: unicode
    PySide.QtCore.QUrl. userInfo ( )
    返回类型: unicode
    PySide.QtCore.QUrl. userName ( )
    返回类型: unicode