| Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions | |
The TQUrl class provides a URL parser and simplifies working with URLs. More...
#include <tqurl.h>
Inherited by TQUrlOperator.
The TQUrl class provides a URL parser and simplifies working with URLs.
The TQUrl class is provided for simple work with URLs. It can parse, decode, encode, etc.
TQUrl works with the decoded path and encoded query in turn.
Example:
http://www.trolltech.com:80/cgi-bin/test%20me.pl?cmd=Hello%20you
| Function | Returns |
|---|---|
| protocol() | "http" |
| host() | "www.trolltech.com" |
| port() | 80 |
| path() | "/cgi-bin/test me.pl" |
| fileName() | "test me.pl" |
| query() | "cmd=Hello%20you" |
Example:
http://doc.trolltech.com/ntqdockarea.html#lines
| Function | Returns |
|---|---|
| protocol() | "http" |
| host() | "doc.trolltech.com" |
| fileName() | "ntqdockarea.html" |
| ref() | "lines" |
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.
TQUrl is normally used like this:
TQUrl url( "http://www.trolltech.com" );
// or
TQUrl 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 TQUrls and TQStrings, TQUrl implements the necessary cast and assignment operators so you can do following:
TQUrl url( "http://www.trolltech.com" );
TQString s = url;
// or
TQString s( "http://www.trolltech.com" );
TQUrl 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 TQUrlOperator.
See also TQUrlOperator, Input/Output and Networking, and Miscellaneous Classes.
If you pass a string like "/home/qt", the "file" protocol is assumed.
For example, the path of
TQUrl url( "ftp://ftp.trolltech.com/qt/source", "qt-2.1.0.tar.gz" );
will be "/qt/srource/qt-2.1.0.tar.gz".
On the other hand,
TQUrl url( "ftp://ftp.trolltech.com/qt/source", "/usr/local" );
will result in a new URL, "ftp://ftp.trolltech.com/usr/local",
because "/usr/local" isn't relative.
Similarly,
TQUrl url( "ftp://ftp.trolltech.com/qt/source", "file:/usr/local" );
will result in a new URL, with "/usr/local" as the path
and "file" as the protocol.
Normally it is expected that the path of url points to a directory, even if the path has no slash at the end. But if you want the constructor to handle the last part of the path as a file name if there is no slash at the end, and to let it be replaced by the file name of relUrl (if it contains one), set checkSlash to TRUE.
See also setPath() and hasPath().
See also setPath().
TQString url = "http%3A//www%20trolltech%20com"
TQUrl::decode( url );
// url is now "http://www.trolltech.com"
See also encode().
See also setPath() and hasPath().
Example: network/networkprotocol/nntp.cpp.
TQString url = http://www.trolltech.com
TQUrl::encode( url );
// url is now "http%3A//www%20trolltech%20com"
See also decode().
Example: network/archivesearch/archivedialog.ui.h.
See also decode().
See also setFileName().
Example: network/networkprotocol/nntp.cpp.
See also setHost().
Warning: Passwords passed in URLs are normally insecure; this is due to the mechanism, not because of TQt.
See also setPassword() and setUser().
See also path() and setPath().
See also setPort().
See also setRef().
See also setUser() and setPassword().
See also setHost() and hasHost().
Example: network/archivesearch/archivedialog.ui.h.
Example: tqdir/tqdir.cpp.
See also TQUrl::toString().
Parses url and assigns the resulting data to this class.
If you pass a string like "/home/qt" the "file" protocol will be assumed.
Compares this URL with url. url is parsed first. Returns TRUE if url is equal to this url; otherwise returns FALSE.
Warning: Passwords passed in URLs are normally insecure; this is due to the mechanism, not because of TQt.
See also setPassword() and setUser().
See also setPath() and hasPath().
Example: tqdir/tqdir.cpp.
See also setPort().
See also setProtocol().
See also setQuery() and decode().
See also setRef(), hasRef(), and decode().
See also encode().
See the documentation of fileName() for a more detailed discussion of what is handled as file name and what is handled as a directory path.
See also fileName().
See also host() and hasHost().
Warning: Passwords passed in URLs are normally insecure; this is due to the mechanism, not because of TQt.
See also password() and setUser().
See also path() and hasPath().
See also port().
See also protocol().
See also query() and encode().
See also ref(), hasRef(), and encode().
See also user() and setPassword().
See also encode() and decode().
See also setUser() and setPassword().
This file is part of the TQt toolkit. Copyright © 1995-2007 Trolltech. All Rights Reserved.
| Copyright © 2007 Trolltech | Trademarks | TQt 3.3.8
|