Q3Url Class Reference
[Qt3Support module]

Detailed Description

The Q3Url class provides a URL parser and simplifies working with URLs.

The Q3Url class is provided for simple work with URLs. It can parse, decode, encode, etc.

Q3Url works with the decoded path and encoded query in turn.

Example:

<tt>http://example.com:80/cgi-bin/test%20me.pl?cmd=Hello%20you</tt>

Example:

<tt>http://qt.nokia.com/doc/qdockarea.html#lines</tt>

The individual parts of a URL can be set with setProtocol(), setHost(), setPort(), setPath(), setFileName(), setRef() and setQuery(). A URL could contain, for example, an ftp address which requires a user name and password; these can be set with setUser() and setPassword().

Because path is always encoded internally you must not use "%00" in the path, although this is okay (but not recommended) for the query.

Q3Url is normally used like this:

 Q3Url url( "http://qt.nokia.com" );
 // or
 Q3Url url( "file:///home/myself/Mail", "Inbox" );

You can then access and manipulate the various parts of the URL.

To make it easy to work with Q3Urls and QStrings, Q3Url implements the necessary cast and assignment operators so you can do following:

 Q3Url url( "http://qt.nokia.com" );
 QString s = url;
 // or
 QString s( "http://qt.nokia.com" );
 Q3Url url( s );

Use the static functions, encode() and decode() to encode or decode a URL in a string. (They operate on the string in-place.) The isRelativeUrl() static function returns true if the given string is a relative URL.

If you want to use a URL to work on a hierarchical structure (e.g. a local or remote filesystem), you might want to use the subclass Q3UrlOperator.

See also Q3UrlOperator.

Member Function Documentation

 Q3Url url( "ftp://ftp.qt.nokia.com/qt/source", "qt-2.1.0.tar.gz" );

 Q3Url url( "ftp://ftp.qt.nokia.com/qt/source", "/usr/local" );

 Q3Url url( "ftp://ftp.qt.nokia.com/qt/source", "file:///usr/local" );

 QString url = "http%3A//qt%20nokia%20com"
 Q3Url::decode( url );
 // url is now "http://qt.nokia.com"

 QString url = http://qt.nokia.com
 Q3Url::encode( url );
 // url is now "http%3A//qt%20nokia%20com"