diff options
Diffstat (limited to 'doc/man/man3/tqurl.3qt')
| -rw-r--r-- | doc/man/man3/tqurl.3qt | 158 |
1 files changed, 79 insertions, 79 deletions
diff --git a/doc/man/man3/tqurl.3qt b/doc/man/man3/tqurl.3qt index 44f0be0ee..fb465a0f8 100644 --- a/doc/man/man3/tqurl.3qt +++ b/doc/man/man3/tqurl.3qt @@ -1,5 +1,5 @@ '\" t -.TH QUrl 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQUrl 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,28 +7,28 @@ .ad l .nh .SH NAME -QUrl \- URL parser and simplifies working with URLs +TQUrl \- URL parser and simplifies working with URLs .SH SYNOPSIS -\fC#include <ntqurl.h>\fR +\fC#include <tqurl.h>\fR .PP -Inherited by QUrlOperator. +Inherited by TQUrlOperator. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQUrl\fR ()" +.BI "\fBTQUrl\fR ()" .br .ti -1c -.BI "\fBQUrl\fR ( const TQString & url )" +.BI "\fBTQUrl\fR ( const TQString & url )" .br .ti -1c -.BI "\fBQUrl\fR ( const QUrl & url )" +.BI "\fBTQUrl\fR ( const TQUrl & url )" .br .ti -1c -.BI "\fBQUrl\fR ( const QUrl & url, const TQString & relUrl, bool checkSlash = FALSE )" +.BI "\fBTQUrl\fR ( const TQUrl & url, const TQString & relUrl, bool checkSlash = FALSE )" .br .ti -1c -.BI "virtual \fB~QUrl\fR ()" +.BI "virtual \fB~TQUrl\fR ()" .br .ti -1c .BI "TQString \fBprotocol\fR () const" @@ -121,13 +121,13 @@ Inherited by QUrlOperator. .BI "TQString \fBdirPath\fR () const" .br .ti -1c -.BI "QUrl & \fBoperator=\fR ( const QUrl & url )" +.BI "TQUrl & \fBoperator=\fR ( const TQUrl & url )" .br .ti -1c -.BI "QUrl & \fBoperator=\fR ( const TQString & url )" +.BI "TQUrl & \fBoperator=\fR ( const TQString & url )" .br .ti -1c -.BI "bool \fBoperator==\fR ( const QUrl & url ) const" +.BI "bool \fBoperator==\fR ( const TQUrl & url ) const" .br .ti -1c .BI "bool \fBoperator==\fR ( const TQString & url ) const" @@ -164,11 +164,11 @@ Inherited by QUrlOperator. .br .in -1c .SH DESCRIPTION -The QUrl class provides a URL parser and simplifies working with URLs. +The TQUrl class provides a URL parser and simplifies working with URLs. .PP -The QUrl class is provided for simple work with URLs. It can parse, decode, encode, etc. +The TQUrl class is provided for simple work with URLs. It can parse, decode, encode, etc. .PP -QUrl works with the decoded path and encoded query in turn. +TQUrl works with the decoded path and encoded query in turn. .PP Example: .PP @@ -196,25 +196,25 @@ The individual parts of a URL can be set with setProtocol(), setHost(), setPort( .PP Because path is always encoded internally you must not use "%00" in the path, although this is okay (but not recommended) for the query. .PP -QUrl is normally used like this: +TQUrl is normally used like this: .PP .nf .br - QUrl url( "http://www.trolltech.com" ); + TQUrl url( "http://www.trolltech.com" ); .br // or .br - QUrl url( "file:/home/myself/Mail", "Inbox" ); + TQUrl url( "file:/home/myself/Mail", "Inbox" ); .br .fi .PP You can then access and manipulate the various parts of the URL. .PP -To make it easy to work with QUrls and TQStrings, QUrl implements the necessary cast and assignment operators so you can do following: +To make it easy to work with TQUrls and TQStrings, TQUrl implements the necessary cast and assignment operators so you can do following: .PP .nf .br - QUrl url( "http://www.trolltech.com" ); + TQUrl url( "http://www.trolltech.com" ); .br TQString s = url; .br @@ -222,32 +222,32 @@ To make it easy to work with QUrls and TQStrings, QUrl implements the necessary .br TQString s( "http://www.trolltech.com" ); .br - QUrl url( s ); + TQUrl url( s ); .br .fi .PP 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. .PP -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 QUrlOperator. +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. .PP -See also QUrlOperator, Input/Output and Networking, and Miscellaneous Classes. +See also TQUrlOperator, Input/Output and Networking, and Miscellaneous Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QUrl::QUrl ()" +.SH "TQUrl::TQUrl ()" Constructs an empty URL that is invalid. -.SH "QUrl::QUrl ( const TQString & url )" +.SH "TQUrl::TQUrl ( const TQString & url )" Constructs a URL by parsing the string \fIurl\fR. .PP If you pass a string like "/home/qt", the "file" protocol is assumed. -.SH "QUrl::QUrl ( const QUrl & url )" +.SH "TQUrl::TQUrl ( const TQUrl & url )" Copy constructor. Copies the data of \fIurl\fR. -.SH "QUrl::QUrl ( const QUrl & url, const TQString & relUrl, bool checkSlash = FALSE )" +.SH "TQUrl::TQUrl ( const TQUrl & url, const TQString & relUrl, bool checkSlash = FALSE )" Constructs an URL taking \fIurl\fR as the base (context) and \fIrelUrl\fR as a relative URL to \fIurl\fR. If \fIrelUrl\fR is not relative, \fIrelUrl\fR is taken as the new URL. .PP For example, the path of .PP .nf .br - QUrl url( "ftp://ftp.trolltech.com/qt/source", "qt-2.1.0.tar.gz" ); + TQUrl url( "ftp://ftp.trolltech.com/qt/source", "qt-2.1.0.tar.gz" ); .br .fi will be "/qt/srource/qt-2.1.0.tar.gz". @@ -256,7 +256,7 @@ On the other hand, .PP .nf .br - QUrl url( "ftp://ftp.trolltech.com/qt/source", "/usr/local" ); + TQUrl url( "ftp://ftp.trolltech.com/qt/source", "/usr/local" ); .br .fi will result in a new URL, "ftp://ftp.trolltech.com/usr/local", because "/usr/local" isn't relative. @@ -265,50 +265,50 @@ Similarly, .PP .nf .br - QUrl url( "ftp://ftp.trolltech.com/qt/source", "file:/usr/local" ); + TQUrl url( "ftp://ftp.trolltech.com/qt/source", "file:/usr/local" ); .br .fi will result in a new URL, with "/usr/local" as the path and "file" as the protocol. .PP Normally it is expected that the path of \fIurl\fR 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 \fIrelUrl\fR (if it contains one), set \fIcheckSlash\fR to TRUE. -.SH "QUrl::~QUrl ()\fC [virtual]\fR" +.SH "TQUrl::~TQUrl ()\fC [virtual]\fR" Destructor. -.SH "void QUrl::addPath ( const TQString & pa )\fC [virtual]\fR" +.SH "void TQUrl::addPath ( const TQString & pa )\fC [virtual]\fR" Adds the path \fIpa\fR to the path of the URL. .PP See also setPath() and hasPath(). -.SH "bool QUrl::cdUp ()\fC [virtual]\fR" +.SH "bool TQUrl::cdUp ()\fC [virtual]\fR" Changes the directory to one directory up. .PP See also setPath(). -.SH "void QUrl::decode ( TQString & url )\fC [static]\fR" +.SH "void TQUrl::decode ( TQString & url )\fC [static]\fR" Decodes the \fIurl\fR in-place into UTF-8. For example .PP .nf .br TQString url = "http%3A//www%20trolltech%20com" .br - QUrl::decode( url ); + TQUrl::decode( url ); .br // url is now "http://www.trolltech.com" .br .fi .PP See also encode(). -.SH "TQString QUrl::dirPath () const" +.SH "TQString TQUrl::dirPath () const" Returns the directory path of the URL. This is the part of the path of the URL without the fileName(). See the documentation of fileName() for a discussion of what is handled as file name and what is handled as directory path. .PP See also setPath() and hasPath(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "void QUrl::encode ( TQString & url )\fC [static]\fR" +.SH "void TQUrl::encode ( TQString & url )\fC [static]\fR" Encodes the \fIurl\fR in-place into UTF-8. For example .PP .nf .br TQString url = http://www.trolltech.com .br - QUrl::encode( url ); + TQUrl::encode( url ); .br // url is now "http%3A//www%20trolltech%20com" .br @@ -317,161 +317,161 @@ Encodes the \fIurl\fR in-place into UTF-8. For example See also decode(). .PP Example: network/archivesearch/archivedialog.ui.h. -.SH "TQString QUrl::encodedPathAndQuery ()" +.SH "TQString TQUrl::encodedPathAndQuery ()" Returns the encoded path and query. .PP See also decode(). -.SH "TQString QUrl::fileName () const" +.SH "TQString TQUrl::fileName () const" Returns the file name of the URL. If the path of the URL doesn't have a slash at the end, the part between the last slash and the end of the path string is considered to be the file name. If the path has a slash at the end, an empty string is returned here. .PP See also setFileName(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "bool QUrl::hasHost () const" +.SH "bool TQUrl::hasHost () const" Returns TRUE if the URL contains a hostname; otherwise returns FALSE. .PP See also setHost(). -.SH "bool QUrl::hasPassword () const" +.SH "bool TQUrl::hasPassword () const" Returns TRUE if the URL contains a password; otherwise returns FALSE. .PP \fBWarning:\fR Passwords passed in URLs are normally \fIinsecure\fR; this is due to the mechanism, not because of Qt. .PP See also setPassword() and setUser(). -.SH "bool QUrl::hasPath () const" +.SH "bool TQUrl::hasPath () const" Returns TRUE if the URL contains a path; otherwise returns FALSE. .PP See also path() and setPath(). -.SH "bool QUrl::hasPort () const" +.SH "bool TQUrl::hasPort () const" Returns TRUE if the URL contains a port; otherwise returns FALSE. .PP See also setPort(). -.SH "bool QUrl::hasRef () const" +.SH "bool TQUrl::hasRef () const" Returns TRUE if the URL has a reference; otherwise returns FALSE. .PP See also setRef(). -.SH "bool QUrl::hasUser () const" +.SH "bool TQUrl::hasUser () const" Returns TRUE if the URL contains a username; otherwise returns FALSE. .PP See also setUser() and setPassword(). -.SH "TQString QUrl::host () const" +.SH "TQString TQUrl::host () const" Returns the hostname of the URL. .PP See also setHost() and hasHost(). .PP Example: network/archivesearch/archivedialog.ui.h. -.SH "bool QUrl::isLocalFile () const" +.SH "bool TQUrl::isLocalFile () const" Returns TRUE if the URL is a local file; otherwise returns FALSE. .PP -Example: qdir/qdir.cpp. -.SH "bool QUrl::isRelativeUrl ( const TQString & url )\fC [static]\fR" +Example: tqdir/tqdir.cpp. +.SH "bool TQUrl::isRelativeUrl ( const TQString & url )\fC [static]\fR" Returns TRUE if \fIurl\fR is relative; otherwise returns FALSE. -.SH "bool QUrl::isValid () const" +.SH "bool TQUrl::isValid () const" Returns TRUE if the URL is valid; otherwise returns FALSE. A URL is invalid if it cannot be parsed, for example. -.SH "QUrl::operator TQString () const" +.SH "TQUrl::operator TQString () const" Composes a string version of the URL and returns it. .PP -See also QUrl::toString(). -.SH "QUrl & QUrl::operator= ( const QUrl & url )" +See also TQUrl::toString(). +.SH "TQUrl & TQUrl::operator= ( const TQUrl & url )" Assigns the data of \fIurl\fR to this class. -.SH "QUrl & QUrl::operator= ( const TQString & url )" +.SH "TQUrl & TQUrl::operator= ( const TQString & url )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Parses \fIurl\fR and assigns the resulting data to this class. .PP If you pass a string like "/home/qt" the "file" protocol will be assumed. -.SH "bool QUrl::operator== ( const QUrl & url ) const" +.SH "bool TQUrl::operator== ( const TQUrl & url ) const" Compares this URL with \fIurl\fR and returns TRUE if they are equal; otherwise returns FALSE. -.SH "bool QUrl::operator== ( const TQString & url ) const" +.SH "bool TQUrl::operator== ( const TQString & url ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Compares this URL with \fIurl\fR. \fIurl\fR is parsed first. Returns TRUE if \fIurl\fR is equal to this url; otherwise returns FALSE. -.SH "bool QUrl::parse ( const TQString & url )\fC [virtual protected]\fR" +.SH "bool TQUrl::parse ( const TQString & url )\fC [virtual protected]\fR" Parses the \fIurl\fR. -.SH "TQString QUrl::password () const" +.SH "TQString TQUrl::password () const" Returns the password of the URL. .PP \fBWarning:\fR Passwords passed in URLs are normally \fIinsecure\fR; this is due to the mechanism, not because of Qt. .PP See also setPassword() and setUser(). -.SH "TQString QUrl::path ( bool correct = TRUE ) const" +.SH "TQString TQUrl::path ( bool correct = TRUE ) const" Returns the path of the URL. If \fIcorrect\fR is TRUE, the path is cleaned (deals with too many or too few slashes, cleans things like "/../..", etc). Otherwise path() returns exactly the path that was parsed or set. .PP See also setPath() and hasPath(). .PP -Example: qdir/qdir.cpp. -.SH "int QUrl::port () const" +Example: tqdir/tqdir.cpp. +.SH "int TQUrl::port () const" Returns the port of the URL or -1 if no port has been set. .PP See also setPort(). -.SH "TQString QUrl::protocol () const" +.SH "TQString TQUrl::protocol () const" Returns the protocol of the URL. Typically, "file", "http", "ftp", etc. .PP See also setProtocol(). -.SH "TQString QUrl::query () const" +.SH "TQString TQUrl::query () const" Returns the (encoded) query of the URL. .PP See also setQuery() and decode(). -.SH "TQString QUrl::ref () const" +.SH "TQString TQUrl::ref () const" Returns the (encoded) reference of the URL. .PP See also setRef(), hasRef(), and decode(). -.SH "void QUrl::reset ()\fC [virtual protected]\fR" +.SH "void TQUrl::reset ()\fC [virtual protected]\fR" Resets all parts of the URL to their default values and invalidates it. -.SH "void QUrl::setEncodedPathAndQuery ( const TQString & pathAndQuery )\fC [virtual]\fR" +.SH "void TQUrl::setEncodedPathAndQuery ( const TQString & pathAndQuery )\fC [virtual]\fR" Parses \fIpathAndQuery\fR for a path and query and sets those values. The whole string must be encoded. .PP See also encode(). -.SH "void QUrl::setFileName ( const TQString & name )\fC [virtual]\fR" +.SH "void TQUrl::setFileName ( const TQString & name )\fC [virtual]\fR" Sets the file name of the URL to \fIname\fR. If this URL contains a fileName(), the original file name is replaced by \fIname\fR. .PP 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. .PP See also fileName(). -.SH "void QUrl::setHost ( const TQString & host )\fC [virtual]\fR" +.SH "void TQUrl::setHost ( const TQString & host )\fC [virtual]\fR" Sets the hostname of the URL to \fIhost\fR. .PP See also host() and hasHost(). -.SH "void QUrl::setPassword ( const TQString & pass )\fC [virtual]\fR" +.SH "void TQUrl::setPassword ( const TQString & pass )\fC [virtual]\fR" Sets the password of the URL to \fIpass\fR. .PP \fBWarning:\fR Passwords passed in URLs are normally \fIinsecure\fR; this is due to the mechanism, not because of Qt. .PP See also password() and setUser(). -.SH "void QUrl::setPath ( const TQString & path )\fC [virtual]\fR" +.SH "void TQUrl::setPath ( const TQString & path )\fC [virtual]\fR" Sets the path of the URL to \fIpath\fR. .PP See also path() and hasPath(). -.SH "void QUrl::setPort ( int port )\fC [virtual]\fR" +.SH "void TQUrl::setPort ( int port )\fC [virtual]\fR" Sets the port of the URL to \fIport\fR. .PP See also port(). -.SH "void QUrl::setProtocol ( const TQString & protocol )\fC [virtual]\fR" +.SH "void TQUrl::setProtocol ( const TQString & protocol )\fC [virtual]\fR" Sets the protocol of the URL to \fIprotocol\fR. Typically, "file"," http", "ftp", etc. .PP See also protocol(). -.SH "void QUrl::setQuery ( const TQString & txt )\fC [virtual]\fR" +.SH "void TQUrl::setQuery ( const TQString & txt )\fC [virtual]\fR" Sets the query of the URL to \fItxt\fR. \fItxt\fR must be encoded. .PP See also query() and encode(). -.SH "void QUrl::setRef ( const TQString & txt )\fC [virtual]\fR" +.SH "void TQUrl::setRef ( const TQString & txt )\fC [virtual]\fR" Sets the reference of the URL to \fItxt\fR. \fItxt\fR must be encoded. .PP See also ref(), hasRef(), and encode(). -.SH "void QUrl::setUser ( const TQString & user )\fC [virtual]\fR" +.SH "void TQUrl::setUser ( const TQString & user )\fC [virtual]\fR" Sets the username of the URL to \fIuser\fR. .PP See also user() and setPassword(). -.SH "TQString QUrl::toString ( bool encodedPath = FALSE, bool forcePrependProtocol = TRUE ) const\fC [virtual]\fR" +.SH "TQString TQUrl::toString ( bool encodedPath = FALSE, bool forcePrependProtocol = TRUE ) const\fC [virtual]\fR" Composes a string version of the URL and returns it. If \fIencodedPath\fR is TRUE the path in the returned string is encoded. If \fIforcePrependProtocol\fR is TRUE and \fIencodedPath\fR looks like a local filename, the "file:/" protocol is also prepended. .PP See also encode() and decode(). -.SH "TQString QUrl::user () const" +.SH "TQString TQUrl::user () const" Returns the username of the URL. .PP See also setUser() and setPassword(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqurl.html +.BR http://doc.trolltech.com/tqurl.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the |