Interface to RFC3986 Universal Resource Indicator.
class URI( [path], [decode] )
init | Interface to RFC3986 Universal Resource Indicator. |
fragment | Fragment string in the uri (following path and query after a '#') |
host | Host specificator |
path | Path specificator |
port | Optional port specificator (following the host after a ':') |
query | Query string in the URI |
scheme | URI scheme |
uri | Complete URI |
userInfo | User, password or account specification preceding '\@' host |
decode() | Decode a string to from URL encoding (static). |
encode() | Encode a string to URL encoding (static). |
getFields() | Returns fields contained in the query element into a dictionary. |
setFields() | Sets query fields for this uri. |
Interface to RFC3986 Universal Resource Indicator.
This class offers an object oriented interface to access URI elements.
Setting the properties in this class immediately reflects on the related fields; for example setting the value of the uri property causes a complete re-parse of the item; setting a field as the query string will cause the uri to change.
Each update is subject to RFC3986 compliance checks, and will raise a ParseError if conformance of the URI object is broken.
Interface to RFC3986 Universal Resource Indicator.
init URI( [path], [decode] )
path | The URI that will be used as initial data. | ||
decode | True if the path is URI encoded, and must be decoded (default). | ||
Raises: |
|
This class offers an object oriented interface to access URI elements.
Setting the properties in this class immediately reflects on the related fields; for example setting the value of the uri property causes a complete re-parse of the item; setting a field as the query string will cause the uri to change.
Each update is subject to RFC3986 compliance checks, and will raise a ParseError if conformance of the URI object is broken.
Fragment string in the uri (following path and query after a '#')
Host specificator
Path specificator
Optional port specificator (following the host after a ':')
Query string in the URI
URI scheme
Complete URI
User, password or account specification preceding '\@' host
Decode a string to from URL encoding (static).
URI.decode( enc_string )
enc_string | The URI/URL encoded string. | ||
Returns: | The decoded string. | ||
Raises: |
|
Encode a string to URL encoding (static).
URI.encode( string )
string | The string to be encoded. |
Returns: | the URL/URI encoded string. |
Returns fields contained in the query element into a dictionary.
URI.getFields( )
Returns: | The fields as a dictionary of nil if the query part contains no element. | ||
Raises: |
|
Sets query fields for this uri.
URI.setFields( fields )
fields | A dictionary of fields or nil to clear the query. | ||
Raises: |
|