diff options
Diffstat (limited to 'doc/html/qurl.html')
| -rw-r--r-- | doc/html/qurl.html | 478 |
1 files changed, 478 insertions, 0 deletions
diff --git a/doc/html/qurl.html b/doc/html/qurl.html new file mode 100644 index 00000000..8464f882 --- /dev/null +++ b/doc/html/qurl.html @@ -0,0 +1,478 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/kernel/qurl.cpp:91 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>TQUrl Class</title> +<style type="text/css"><!-- +fn { margin-left: 1cm; text-indent: -1cm; } +a:link { color: #004faf; text-decoration: none } +a:visited { color: #672967; text-decoration: none } +body { background: #ffffff; color: black; } +--></style> +</head> +<body> + +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr bgcolor="#E5E5E5"> +<td valign=center> + <a href="index.html"> +<font color="#004faf">Home</font></a> + | <a href="classes.html"> +<font color="#004faf">All Classes</font></a> + | <a href="mainclasses.html"> +<font color="#004faf">Main Classes</font></a> + | <a href="annotated.html"> +<font color="#004faf">Annotated</font></a> + | <a href="groups.html"> +<font color="#004faf">Grouped Classes</font></a> + | <a href="functions.html"> +<font color="#004faf">Functions</font></a> +</td> +<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQUrl Class Reference<br><small>[<a href="network.html">network module</a>]</small></h1> + +<p>The TQUrl class provides a URL parser and simplifies working with URLs. +<a href="#details">More...</a> +<p><tt>#include <<a href="qurl-h.html">qurl.h</a>></tt> +<p>Inherited by <a href="qurloperator.html">TQUrlOperator</a>. +<p><a href="qurl-members.html">List of all member functions.</a> +<h2>Public Members</h2> +<ul> +<li class=fn><a href="#TQUrl"><b>TQUrl</b></a> ()</li> +<li class=fn><a href="#TQUrl-2"><b>TQUrl</b></a> ( const TQString & url )</li> +<li class=fn><a href="#TQUrl-3"><b>TQUrl</b></a> ( const TQUrl & url )</li> +<li class=fn><a href="#TQUrl-4"><b>TQUrl</b></a> ( const TQUrl & url, const TQString & relUrl, bool checkSlash = FALSE )</li> +<li class=fn>virtual <a href="#~TQUrl"><b>~TQUrl</b></a> ()</li> +<li class=fn>TQString <a href="#protocol"><b>protocol</b></a> () const</li> +<li class=fn>virtual void <a href="#setProtocol"><b>setProtocol</b></a> ( const TQString & protocol )</li> +<li class=fn>TQString <a href="#user"><b>user</b></a> () const</li> +<li class=fn>virtual void <a href="#setUser"><b>setUser</b></a> ( const TQString & user )</li> +<li class=fn>bool <a href="#hasUser"><b>hasUser</b></a> () const</li> +<li class=fn>TQString <a href="#password"><b>password</b></a> () const</li> +<li class=fn>virtual void <a href="#setPassword"><b>setPassword</b></a> ( const TQString & pass )</li> +<li class=fn>bool <a href="#hasPassword"><b>hasPassword</b></a> () const</li> +<li class=fn>TQString <a href="#host"><b>host</b></a> () const</li> +<li class=fn>virtual void <a href="#setHost"><b>setHost</b></a> ( const TQString & host )</li> +<li class=fn>bool <a href="#hasHost"><b>hasHost</b></a> () const</li> +<li class=fn>int <a href="#port"><b>port</b></a> () const</li> +<li class=fn>virtual void <a href="#setPort"><b>setPort</b></a> ( int port )</li> +<li class=fn>bool <a href="#hasPort"><b>hasPort</b></a> () const</li> +<li class=fn>TQString <a href="#path"><b>path</b></a> ( bool correct = TRUE ) const</li> +<li class=fn>virtual void <a href="#setPath"><b>setPath</b></a> ( const TQString & path )</li> +<li class=fn>bool <a href="#hasPath"><b>hasPath</b></a> () const</li> +<li class=fn>virtual void <a href="#setEncodedPathAndQuery"><b>setEncodedPathAndQuery</b></a> ( const TQString & pathAndQuery )</li> +<li class=fn>TQString <a href="#encodedPathAndQuery"><b>encodedPathAndQuery</b></a> ()</li> +<li class=fn>virtual void <a href="#setQuery"><b>setQuery</b></a> ( const TQString & txt )</li> +<li class=fn>TQString <a href="#query"><b>query</b></a> () const</li> +<li class=fn>TQString <a href="#ref"><b>ref</b></a> () const</li> +<li class=fn>virtual void <a href="#setRef"><b>setRef</b></a> ( const TQString & txt )</li> +<li class=fn>bool <a href="#hasRef"><b>hasRef</b></a> () const</li> +<li class=fn>bool <a href="#isValid"><b>isValid</b></a> () const</li> +<li class=fn>bool <a href="#isLocalFile"><b>isLocalFile</b></a> () const</li> +<li class=fn>virtual void <a href="#addPath"><b>addPath</b></a> ( const TQString & pa )</li> +<li class=fn>virtual void <a href="#setFileName"><b>setFileName</b></a> ( const TQString & name )</li> +<li class=fn>TQString <a href="#fileName"><b>fileName</b></a> () const</li> +<li class=fn>TQString <a href="#dirPath"><b>dirPath</b></a> () const</li> +<li class=fn>TQUrl & <a href="#operator-eq"><b>operator=</b></a> ( const TQUrl & url )</li> +<li class=fn>TQUrl & <a href="#operator-eq-2"><b>operator=</b></a> ( const TQString & url )</li> +<li class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const TQUrl & url ) const</li> +<li class=fn>bool <a href="#operator-eq-eq-2"><b>operator==</b></a> ( const TQString & url ) const</li> +<li class=fn><a href="#operator-TQString"><b>operator TQString</b></a> () const</li> +<li class=fn>virtual TQString <a href="#toString"><b>toString</b></a> ( bool encodedPath = FALSE, bool forcePrependProtocol = TRUE ) const</li> +<li class=fn>virtual bool <a href="#cdUp"><b>cdUp</b></a> ()</li> +</ul> +<h2>Static Public Members</h2> +<ul> +<li class=fn>void <a href="#decode"><b>decode</b></a> ( TQString & url )</li> +<li class=fn>void <a href="#encode"><b>encode</b></a> ( TQString & url )</li> +<li class=fn>bool <a href="#isRelativeUrl"><b>isRelativeUrl</b></a> ( const TQString & url )</li> +</ul> +<h2>Protected Members</h2> +<ul> +<li class=fn>virtual void <a href="#reset"><b>reset</b></a> ()</li> +<li class=fn>virtual bool <a href="#parse"><b>parse</b></a> ( const TQString & url )</li> +</ul> +<hr><a name="details"></a><h2>Detailed Description</h2> + + +<p> The TQUrl class provides a URL parser and simplifies working with URLs. + +<p> + + +<p> +<p> The TQUrl class is provided for simple work with URLs. It can +parse, decode, encode, etc. +<p> TQUrl works with the decoded path and encoded query in turn. +<p> Example: +<p> <tt>http://www.trolltech.com:80/cgi-bin/test%20me.pl?cmd=Hello%20you</tt> +<p> <center><table cellpadding="4" cellspacing="2" border="0"> +<tr bgcolor="#a2c511"> <th valign="top">Function <th valign="top">Returns +<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#protocol">protocol</a>() <td valign="top">"http" +<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#host">host</a>() <td valign="top">"www.trolltech.com" +<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#port">port</a>() <td valign="top">80 +<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#path">path</a>() <td valign="top">"/cgi-bin/test me.pl" +<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#fileName">fileName</a>() <td valign="top">"test me.pl" +<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#query">query</a>() <td valign="top">"cmd=Hello%20you" +</table></center> +<p> Example: +<p> <tt>http://doc.trolltech.com/qdockarea.html#lines</tt> +<p> <center><table cellpadding="4" cellspacing="2" border="0"> +<tr bgcolor="#a2c511"> <th valign="top">Function <th valign="top">Returns +<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#protocol">protocol</a>() <td valign="top">"http" +<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#host">host</a>() <td valign="top">"doc.trolltech.com" +<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#fileName">fileName</a>() <td valign="top">"qdockarea.html" +<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#ref">ref</a>() <td valign="top">"lines" +</table></center> +<p> The individual parts of a URL can be set with <a href="#setProtocol">setProtocol</a>(), +<a href="#setHost">setHost</a>(), <a href="#setPort">setPort</a>(), <a href="#setPath">setPath</a>(), <a href="#setFileName">setFileName</a>(), <a href="#setRef">setRef</a>() and +<a href="#setQuery">setQuery</a>(). A URL could contain, for example, an ftp address which +retquires a user name and password; these can be set with <a href="#setUser">setUser</a>() +and <a href="#setPassword">setPassword</a>(). +<p> Because path is always encoded internally you must not use "%00" +in the path, although this is okay (but not recommended) for the +query. +<p> TQUrl is normally used like this: +<p> <pre> + TQUrl url( "http://www.trolltech.com" ); + // or + TQUrl url( "file:/home/myself/Mail", "Inbox" ); + </pre> + +<p> You can then access and manipulate the various parts of the URL. +<p> To make it easy to work with TQUrls and TQStrings, TQUrl implements +the necessary cast and assignment operators so you can do +following: +<p> <pre> + TQUrl url( "http://www.trolltech.com" ); + <a href="qstring.html">TQString</a> s = url; + // or + <a href="qstring.html">TQString</a> s( "http://www.trolltech.com" ); + TQUrl url( s ); + </pre> + +<p> Use the static functions, <a href="#encode">encode</a>() and <a href="#decode">decode</a>() to encode or +decode a URL in a string. (They operate on the string in-place.) +The <a href="#isRelativeUrl">isRelativeUrl</a>() static function returns TRUE if the given +string is a relative URL. +<p> 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 +<a href="qurloperator.html">TQUrlOperator</a>. +<p> <p>See also <a href="qurloperator.html">TQUrlOperator</a>, <a href="io.html">Input/Output and Networking</a>, and <a href="misc.html">Miscellaneous Classes</a>. + +<hr><h2>Member Function Documentation</h2> +<h3 class=fn><a name="TQUrl"></a>TQUrl::TQUrl () +</h3> +Constructs an empty URL that is invalid. + +<h3 class=fn><a name="TQUrl-2"></a>TQUrl::TQUrl ( const <a href="qstring.html">TQString</a> & url ) +</h3> +Constructs a URL by parsing the string <em>url</em>. +<p> If you pass a string like "/home/qt", the "file" protocol is +assumed. + +<h3 class=fn><a name="TQUrl-3"></a>TQUrl::TQUrl ( const <a href="qurl.html">TQUrl</a> & url ) +</h3> +Copy constructor. Copies the data of <em>url</em>. + +<h3 class=fn><a name="TQUrl-4"></a>TQUrl::TQUrl ( const <a href="qurl.html">TQUrl</a> & url, const <a href="qstring.html">TQString</a> & relUrl, bool checkSlash = FALSE ) +</h3> +Constructs an URL taking <em>url</em> as the base (context) and +<em>relUrl</em> as a relative URL to <em>url</em>. If <em>relUrl</em> is not relative, +<em>relUrl</em> is taken as the new URL. +<p> For example, the path of +<pre> + TQUrl url( "ftp://ftp.trolltech.com/qt/source", "qt-2.1.0.tar.gz" ); + </pre> + +will be "/qt/srource/qt-2.1.0.tar.gz". +<p> On the other hand, +<pre> + TQUrl url( "ftp://ftp.trolltech.com/qt/source", "/usr/local" ); + </pre> + +will result in a new URL, "ftp://ftp.trolltech.com/usr/local", +because "/usr/local" isn't relative. +<p> Similarly, +<pre> + TQUrl url( "ftp://ftp.trolltech.com/qt/source", "file:/usr/local" ); + </pre> + +will result in a new URL, with "/usr/local" as the path +and "file" as the protocol. +<p> Normally it is expected that the path of <em>url</em> 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 <em>relUrl</em> (if it contains one), set <em>checkSlash</em> +to TRUE. + +<h3 class=fn><a name="~TQUrl"></a>TQUrl::~TQUrl ()<tt> [virtual]</tt> +</h3> +Destructor. + +<h3 class=fn>void <a name="addPath"></a>TQUrl::addPath ( const <a href="qstring.html">TQString</a> & pa )<tt> [virtual]</tt> +</h3> +Adds the path <em>pa</em> to the path of the URL. +<p> <p>See also <a href="#setPath">setPath</a>() and <a href="#hasPath">hasPath</a>(). + +<h3 class=fn>bool <a name="cdUp"></a>TQUrl::cdUp ()<tt> [virtual]</tt> +</h3> +Changes the directory to one directory up. +<p> <p>See also <a href="#setPath">setPath</a>(). + +<h3 class=fn>void <a name="decode"></a>TQUrl::decode ( <a href="qstring.html">TQString</a> & url )<tt> [static]</tt> +</h3> +Decodes the <em>url</em> in-place into UTF-8. For example +<p> <pre> + <a href="qstring.html">TQString</a> url = "http%3A//www%20trolltech%20com" + TQUrl::<a href="#decode">decode</a>( url ); + // url is now "http://www.trolltech.com" + </pre> + +<p> <p>See also <a href="#encode">encode</a>(). + +<h3 class=fn><a href="qstring.html">TQString</a> <a name="dirPath"></a>TQUrl::dirPath () const +</h3> +Returns the directory path of the URL. This is the part of the +path of the URL without the <a href="#fileName">fileName</a>(). See the documentation of +fileName() for a discussion of what is handled as file name and +what is handled as directory path. +<p> <p>See also <a href="#setPath">setPath</a>() and <a href="#hasPath">hasPath</a>(). + +<p>Example: <a href="networkprotocol-example.html#x695">network/networkprotocol/nntp.cpp</a>. +<h3 class=fn>void <a name="encode"></a>TQUrl::encode ( <a href="qstring.html">TQString</a> & url )<tt> [static]</tt> +</h3> +Encodes the <em>url</em> in-place into UTF-8. For example +<p> <pre> + <a href="qstring.html">TQString</a> url = http://www.trolltech.com + TQUrl::<a href="#encode">encode</a>( url ); + // url is now "http%3A//www%20trolltech%20com" + </pre> + +<p> <p>See also <a href="#decode">decode</a>(). + +<p>Example: <a href="archivesearch-example.html#x484">network/archivesearch/archivedialog.ui.h</a>. +<h3 class=fn><a href="qstring.html">TQString</a> <a name="encodedPathAndQuery"></a>TQUrl::encodedPathAndQuery () +</h3> +Returns the encoded path and query. +<p> <p>See also <a href="#decode">decode</a>(). + +<h3 class=fn><a href="qstring.html">TQString</a> <a name="fileName"></a>TQUrl::fileName () const +</h3> +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. +<p> <p>See also <a href="#setFileName">setFileName</a>(). + +<p>Example: <a href="networkprotocol-example.html#x696">network/networkprotocol/nntp.cpp</a>. +<h3 class=fn>bool <a name="hasHost"></a>TQUrl::hasHost () const +</h3> +Returns TRUE if the URL contains a hostname; otherwise returns +FALSE. +<p> <p>See also <a href="#setHost">setHost</a>(). + +<h3 class=fn>bool <a name="hasPassword"></a>TQUrl::hasPassword () const +</h3> +Returns TRUE if the URL contains a password; otherwise returns +FALSE. +<p> <b>Warning:</b> Passwords passed in URLs are normally <em>insecure</em>; this +is due to the mechanism, not because of TQt. +<p> <p>See also <a href="#setPassword">setPassword</a>() and <a href="#setUser">setUser</a>(). + +<h3 class=fn>bool <a name="hasPath"></a>TQUrl::hasPath () const +</h3> +Returns TRUE if the URL contains a path; otherwise returns FALSE. +<p> <p>See also <a href="#path">path</a>() and <a href="#setPath">setPath</a>(). + +<h3 class=fn>bool <a name="hasPort"></a>TQUrl::hasPort () const +</h3> +Returns TRUE if the URL contains a port; otherwise returns FALSE. +<p> <p>See also <a href="#setPort">setPort</a>(). + +<h3 class=fn>bool <a name="hasRef"></a>TQUrl::hasRef () const +</h3> +Returns TRUE if the URL has a reference; otherwise returns FALSE. +<p> <p>See also <a href="#setRef">setRef</a>(). + +<h3 class=fn>bool <a name="hasUser"></a>TQUrl::hasUser () const +</h3> +Returns TRUE if the URL contains a username; otherwise returns +FALSE. +<p> <p>See also <a href="#setUser">setUser</a>() and <a href="#setPassword">setPassword</a>(). + +<h3 class=fn><a href="qstring.html">TQString</a> <a name="host"></a>TQUrl::host () const +</h3> +Returns the hostname of the URL. +<p> <p>See also <a href="#setHost">setHost</a>() and <a href="#hasHost">hasHost</a>(). + +<p>Example: <a href="archivesearch-example.html#x485">network/archivesearch/archivedialog.ui.h</a>. +<h3 class=fn>bool <a name="isLocalFile"></a>TQUrl::isLocalFile () const +</h3> +Returns TRUE if the URL is a local file; otherwise returns FALSE. + +<p>Example: <a href="qdir-example.html#x1849">qdir/qdir.cpp</a>. +<h3 class=fn>bool <a name="isRelativeUrl"></a>TQUrl::isRelativeUrl ( const <a href="qstring.html">TQString</a> & url )<tt> [static]</tt> +</h3> +Returns TRUE if <em>url</em> is relative; otherwise returns FALSE. + +<h3 class=fn>bool <a name="isValid"></a>TQUrl::isValid () const +</h3> +Returns TRUE if the URL is valid; otherwise returns FALSE. A URL +is invalid if it cannot be parsed, for example. + +<h3 class=fn><a name="operator-TQString"></a>TQUrl::operator TQString () const +</h3> +Composes a string version of the URL and returns it. +<p> <p>See also <a href="#toString">TQUrl::toString</a>(). + +<h3 class=fn><a href="qurl.html">TQUrl</a> & <a name="operator-eq"></a>TQUrl::operator= ( const <a href="qurl.html">TQUrl</a> & url ) +</h3> +Assigns the data of <em>url</em> to this class. + +<h3 class=fn><a href="qurl.html">TQUrl</a> & <a name="operator-eq-2"></a>TQUrl::operator= ( const <a href="qstring.html">TQString</a> & url ) +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Parses <em>url</em> and assigns the resulting data to this class. +<p> If you pass a string like "/home/qt" the "file" protocol will be +assumed. + +<h3 class=fn>bool <a name="operator-eq-eq"></a>TQUrl::operator== ( const <a href="qurl.html">TQUrl</a> & url ) const +</h3> +Compares this URL with <em>url</em> and returns TRUE if they are equal; +otherwise returns FALSE. + +<h3 class=fn>bool <a name="operator-eq-eq-2"></a>TQUrl::operator== ( const <a href="qstring.html">TQString</a> & url ) const +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Compares this URL with <em>url</em>. <em>url</em> is parsed first. Returns +TRUE if <em>url</em> is equal to this url; otherwise returns FALSE. + +<h3 class=fn>bool <a name="parse"></a>TQUrl::parse ( const <a href="qstring.html">TQString</a> & url )<tt> [virtual protected]</tt> +</h3> +Parses the <em>url</em>. + +<h3 class=fn><a href="qstring.html">TQString</a> <a name="password"></a>TQUrl::password () const +</h3> +Returns the password of the URL. +<p> <b>Warning:</b> Passwords passed in URLs are normally <em>insecure</em>; this +is due to the mechanism, not because of TQt. +<p> <p>See also <a href="#setPassword">setPassword</a>() and <a href="#setUser">setUser</a>(). + +<h3 class=fn><a href="qstring.html">TQString</a> <a name="path"></a>TQUrl::path ( bool correct = TRUE ) const +</h3> +Returns the path of the URL. If <em>correct</em> is TRUE, the path is +cleaned (deals with too many or too few slashes, cleans things +like "/../..", etc). Otherwise <a href="#path">path</a>() returns exactly the path +that was parsed or set. +<p> <p>See also <a href="#setPath">setPath</a>() and <a href="#hasPath">hasPath</a>(). + +<p>Example: <a href="qdir-example.html#x1850">qdir/qdir.cpp</a>. +<h3 class=fn>int <a name="port"></a>TQUrl::port () const +</h3> +Returns the port of the URL or -1 if no port has been set. +<p> <p>See also <a href="#setPort">setPort</a>(). + +<h3 class=fn><a href="qstring.html">TQString</a> <a name="protocol"></a>TQUrl::protocol () const +</h3> +Returns the protocol of the URL. Typically, "file", "http", "ftp", +etc. +<p> <p>See also <a href="#setProtocol">setProtocol</a>(). + +<h3 class=fn><a href="qstring.html">TQString</a> <a name="query"></a>TQUrl::query () const +</h3> +Returns the (encoded) query of the URL. +<p> <p>See also <a href="#setQuery">setQuery</a>() and <a href="#decode">decode</a>(). + +<h3 class=fn><a href="qstring.html">TQString</a> <a name="ref"></a>TQUrl::ref () const +</h3> +Returns the (encoded) reference of the URL. +<p> <p>See also <a href="#setRef">setRef</a>(), <a href="#hasRef">hasRef</a>(), and <a href="#decode">decode</a>(). + +<h3 class=fn>void <a name="reset"></a>TQUrl::reset ()<tt> [virtual protected]</tt> +</h3> +Resets all parts of the URL to their default values and +invalidates it. + +<h3 class=fn>void <a name="setEncodedPathAndQuery"></a>TQUrl::setEncodedPathAndQuery ( const <a href="qstring.html">TQString</a> & pathAndQuery )<tt> [virtual]</tt> +</h3> +Parses <em>pathAndQuery</em> for a path and query and sets those values. +The whole string must be encoded. +<p> <p>See also <a href="#encode">encode</a>(). + +<h3 class=fn>void <a name="setFileName"></a>TQUrl::setFileName ( const <a href="qstring.html">TQString</a> & name )<tt> [virtual]</tt> +</h3> +Sets the file name of the URL to <em>name</em>. If this URL contains a +<a href="#fileName">fileName</a>(), the original file name is replaced by <em>name</em>. +<p> 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. +<p> <p>See also <a href="#fileName">fileName</a>(). + +<h3 class=fn>void <a name="setHost"></a>TQUrl::setHost ( const <a href="qstring.html">TQString</a> & host )<tt> [virtual]</tt> +</h3> +Sets the hostname of the URL to <em>host</em>. +<p> <p>See also <a href="#host">host</a>() and <a href="#hasHost">hasHost</a>(). + +<h3 class=fn>void <a name="setPassword"></a>TQUrl::setPassword ( const <a href="qstring.html">TQString</a> & pass )<tt> [virtual]</tt> +</h3> +Sets the password of the URL to <em>pass</em>. +<p> <b>Warning:</b> Passwords passed in URLs are normally <em>insecure</em>; this +is due to the mechanism, not because of TQt. +<p> <p>See also <a href="#password">password</a>() and <a href="#setUser">setUser</a>(). + +<h3 class=fn>void <a name="setPath"></a>TQUrl::setPath ( const <a href="qstring.html">TQString</a> & path )<tt> [virtual]</tt> +</h3> +Sets the path of the URL to <em>path</em>. +<p> <p>See also <a href="#path">path</a>() and <a href="#hasPath">hasPath</a>(). + +<h3 class=fn>void <a name="setPort"></a>TQUrl::setPort ( int port )<tt> [virtual]</tt> +</h3> +Sets the port of the URL to <em>port</em>. +<p> <p>See also <a href="#port">port</a>(). + +<h3 class=fn>void <a name="setProtocol"></a>TQUrl::setProtocol ( const <a href="qstring.html">TQString</a> & protocol )<tt> [virtual]</tt> +</h3> +Sets the protocol of the URL to <em>protocol</em>. Typically, "file", +"http", "ftp", etc. +<p> <p>See also <a href="#protocol">protocol</a>(). + +<h3 class=fn>void <a name="setQuery"></a>TQUrl::setQuery ( const <a href="qstring.html">TQString</a> & txt )<tt> [virtual]</tt> +</h3> +Sets the query of the URL to <em>txt</em>. <em>txt</em> must be encoded. +<p> <p>See also <a href="#query">query</a>() and <a href="#encode">encode</a>(). + +<h3 class=fn>void <a name="setRef"></a>TQUrl::setRef ( const <a href="qstring.html">TQString</a> & txt )<tt> [virtual]</tt> +</h3> +Sets the reference of the URL to <em>txt</em>. <em>txt</em> must be encoded. +<p> <p>See also <a href="#ref">ref</a>(), <a href="#hasRef">hasRef</a>(), and <a href="#encode">encode</a>(). + +<h3 class=fn>void <a name="setUser"></a>TQUrl::setUser ( const <a href="qstring.html">TQString</a> & user )<tt> [virtual]</tt> +</h3> +Sets the username of the URL to <em>user</em>. +<p> <p>See also <a href="#user">user</a>() and <a href="#setPassword">setPassword</a>(). + +<h3 class=fn><a href="qstring.html">TQString</a> <a name="toString"></a>TQUrl::toString ( bool encodedPath = FALSE, bool forcePrependProtocol = TRUE ) const<tt> [virtual]</tt> +</h3> +Composes a string version of the URL and returns it. If <em>encodedPath</em> is TRUE the path in the returned string is encoded. If +<em>forcePrependProtocol</em> is TRUE and <em>encodedPath</em> looks like a +local filename, the "file:/" protocol is also prepended. +<p> <p>See also <a href="#encode">encode</a>() and <a href="#decode">decode</a>(). + +<h3 class=fn><a href="qstring.html">TQString</a> <a name="user"></a>TQUrl::user () const +</h3> +Returns the username of the URL. +<p> <p>See also <a href="#setUser">setUser</a>() and <a href="#setPassword">setPassword</a>(). + +<!-- eof --> +<hr><p> +This file is part of the <a href="index.html">TQt toolkit</a>. +Copyright © 1995-2007 +<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center> +<table width=100% cellspacing=0 border=0><tr> +<td>Copyright © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>TQt 3.3.8</div> +</table></div></address></body> +</html> |