<HTML> <HEAD> <TITLE>class KURL</TITLE> <META NAME="Generator" CONTENT="KDOC "> </HEAD> <BODY bgcolor="#ffffff" text="#000000" link="#0000ff" vlink="#000099" alink= "#ffffff"> <TABLE WIDTH="100%" BORDER="0"> <TR> <TD> <TABLE BORDER="0"> <TR><TD valign="top" align="left" cellspacing="10"> <h1>class KURL</h1> </TD> <TD valign="top" align="right" colspan="1"> Represent and parse a URL. <small><A HREF="#longdesc">More...</A></small></TD></TR> </TABLE> <HR> <TABLE BORDER="0"> <TR><TH>Definition</TH><TD><code>#include <<A HREF="kurl_h.html">kurl.h</A>></code></TD></TR> <TR><TH><A HREF="full-list-KURL.html">List of all Methods</A></TH></TR> </TABLE> </TD> <TD align="right"><TABLE BORDER="0"><TR><TD><small><A HREF="index-long.html">Annotated List</A></small></TD></TR> <TR><TD><small><A HREF="header-list.html">Files</A></small></TD></TR> <TR><TD><small><A HREF="all-globals.html">Globals</A></small></TD></TR> <TR><TD><small><A HREF="hier.html">Hierarchy</A></small></TD></TR> <TR><TD><small><A HREF="index.html">Index</A></small></TD></TR> </TABLE></TD></TR></TABLE> <h4>Public Types</h4><ul><LI>class <A HREF="KURL__List.html">List</A> </LI> </ul><h4>Public Methods</h4><ul><LI> <b><A HREF="#ref2">KURL</A></b> () </LI> <LI> <b><A HREF="#ref3">~KURL</A></b> () </LI> <LI> <b><A HREF="#ref4">KURL</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& url, int encoding_hint = 0 ) </LI> <LI> <b><A HREF="#ref5">KURL</A></b> ( const char * url, int encoding_hint = 0 ) </LI> <LI> <b><A HREF="#ref6">KURL</A></b> ( const <A HREF="KURL.html">KURL</A>& u ) </LI> <LI> <b><A HREF="#ref7">KURL</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qurl.html">QUrl</A> &u ) </LI> <LI> <b><A HREF="#ref8">KURL</A></b> ( const <A HREF="KURL.html">KURL</A>& _baseurl, const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _rel_url, int encoding_hint=0 ) </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref9">protocol</A></b> () const </LI> <LI>void <b><A HREF="#ref10">setProtocol</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref11">user</A></b> () const </LI> <LI>void <b><A HREF="#ref12">setUser</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) </LI> <LI>bool <b><A HREF="#ref13">hasUser</A></b> () const </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref14">pass</A></b> () const </LI> <LI>void <b><A HREF="#ref15">setPass</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) </LI> <LI>bool <b><A HREF="#ref16">hasPass</A></b> () const </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref17">host</A></b> () const </LI> <LI>void <b><A HREF="#ref18">setHost</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) </LI> <LI>bool <b><A HREF="#ref19">hasHost</A></b> () const </LI> <LI>unsigned short int <b><A HREF="#ref20">port</A></b> () const </LI> <LI>void <b><A HREF="#ref21">setPort</A></b> ( unsigned short int _p ) </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref22">path</A></b> () const </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref23">path</A></b> ( int _trailing ) const </LI> <LI>void <b><A HREF="#ref24">setPath</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& path ) </LI> <LI>bool <b><A HREF="#ref25">hasPath</A></b> () const </LI> <LI>void <b><A HREF="#ref26">cleanPath</A></b> () </LI> <LI>void <b><A HREF="#ref27">cleanPath</A></b> (bool cleanDirSeparator) </LI> <LI>void <b><A HREF="#ref28">setEncodedPathAndQuery</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt, int encoding_hint = 0 ) </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref29">encodedPathAndQuery</A></b> ( int _trailing = 0, bool _no_empty_path = false, int encoding_hint = 0) const </LI> <LI>void <b><A HREF="#ref30">setQuery</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt, int encoding_hint = 0) </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref31">query</A></b> () const </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref32">ref</A></b> () const </LI> <LI>void <b><A HREF="#ref33">setRef</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) </LI> <LI>bool <b><A HREF="#ref34">hasRef</A></b> () const </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref35">htmlRef</A></b> () const </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref36">encodedHtmlRef</A></b> () const </LI> <LI>void <b><A HREF="#ref37">setHTMLRef</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _ref ) </LI> <LI>bool <b><A HREF="#ref38">hasHTMLRef</A></b> () const </LI> <LI>bool <b><A HREF="#ref39">isValid</A></b> () const </LI> <LI>bool <b><A HREF="#ref40">isMalformed</A></b> () const </LI> <LI>bool <b><A HREF="#ref41">isLocalFile</A></b> () const </LI> <LI>bool <b><A HREF="#ref42">hasSubURL</A></b> () const </LI> <LI>void <b><A HREF="#ref43">addPath</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) </LI> <LI>void <b><A HREF="#ref44">setFileName</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>&_txt ) </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref45">fileName</A></b> ( bool _ignore_trailing_slash_in_path = true ) const </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref46">filename</A></b> ( bool _ignore_trailing_slash_in_path = true ) const </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref47">directory</A></b> ( bool _strip_trailing_slash_from_result = true, bool _ignore_trailing_slash_in_path = true ) const </LI> <LI>bool <b><A HREF="#ref48">cd</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _dir ) </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref49">url</A></b> ( int _trailing = 0 ) const </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref50">url</A></b> ( int _trailing, int encoding_hint ) const </LI> <LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref51">prettyURL</A></b> ( int _trailing = 0) const </LI> <LI>bool <b><A HREF="#ref52">isEmpty</A></b> () const </LI> <LI><A HREF="KURL.html">KURL</A> <b><A HREF="#ref53">upURL</A></b> ( ) const </LI> <LI><A HREF="KURL.html">KURL</A>& <b><A HREF="#ref54">operator=</A></b> ( const <A HREF="KURL.html">KURL</A>& _u ) </LI> <LI><A HREF="KURL.html">KURL</A>& <b><A HREF="#ref55">operator=</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _url ) </LI> <LI><A HREF="KURL.html">KURL</A>& <b><A HREF="#ref56">operator=</A></b> ( const char * _url ) </LI> <LI><A HREF="KURL.html">KURL</A>& <b><A HREF="#ref57">operator=</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qurl.html">QUrl</A> & u ) </LI> <LI>bool <b><A HREF="#ref58">operator==</A></b> ( const <A HREF="KURL.html">KURL</A>& _u ) const </LI> <LI>bool <b><A HREF="#ref59">operator==</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _u ) const </LI> <LI>bool <b><A HREF="#ref60">operator!=</A></b> ( const <A HREF="KURL.html">KURL</A>& _u ) const </LI> <LI>bool <b><A HREF="#ref61">operator!=</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _u ) const </LI> <LI>bool <b><A HREF="#ref62">cmp</A></b> ( const <A HREF="KURL.html">KURL</A> &u, bool ignore_trailing = false ) const </LI> <LI>bool <b><A HREF="#ref63">isParentOf</A></b> ( const <A HREF="KURL.html">KURL</A>& u ) const </LI> </ul><h4>Public Static Methods</h4><ul><LI>static List <b><A HREF="#ref64">split</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _url ) </LI> <LI>static List <b><A HREF="#ref65">split</A></b> ( const <A HREF="KURL.html">KURL</A>& _url ) </LI> <LI>static <A HREF="KURL.html">KURL</A> <b><A HREF="#ref66">join</A></b> ( const List& _list ) </LI> <LI>static <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref67">encode_string</A></b> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> &str, int encoding_hint = 0) </LI> <LI>static <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref68">encode_string_no_slash</A></b> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> &str, int encoding_hint = 0) </LI> <LI>static <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref69">decode_string</A></b> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> &str, int encoding_hint = 0) </LI> <LI>static bool <b><A HREF="#ref70">isRelativeURL</A></b> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> &_url) </LI> </ul><h4>Protected Methods</h4><ul><LI>void <b><A HREF="#ref71">reset</A></b> () </LI> <LI>void <b><A HREF="#ref72">parse</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _url, int encoding_hint = 0) </LI> </ul><HR><H2><A NAME="longdesc">Detailed Description</A></H2><p> Represent and parse a URL. </p> <p> A prototypical URL looks like: </p><table border="0" width="100%"> <tr> <td bgcolor="#BEEAE0"> <pre> protocol:/user:password@hostname:port/<A HREF="KURL.html#path">path</A>/to/file.ext#reference </pre> </td></tr> </table> <p> </p> <p> <A HREF="KURL.html#KURL">KURL</A> has some restrictions regarding the path encoding. <A HREF="KURL.html#KURL">KURL</A> works internally with the decoded path and and encoded query. For example, </p><table border="0" width="100%"> <tr> <td bgcolor="#BEEAE0"> <pre> http://localhost/cgi-bin/test%20me.pl?cmd=Hello%20you </pre> </td></tr> </table> <p> would result in a decoded path "/cgi-bin/test me.pl" and in the encoded query "?cmd=Hello%20you". Since path is internally always encoded you may <em>not</em> use "%00" in the path, although this is OK for the query. </p> <p></p> <A NAME="KURL__List.html"></A><A NAME="ref1"></A><table width="100%"><tr bgcolor="#eeeeee"><td><strong>List</strong> <small>(class)</small></td><td align="right"><h3><strong>List</strong></h3></td></tr></table><p></p><A NAME="KURL"></A><A NAME="ref2"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <strong>KURL</strong> () <br></td><td align="right"><h3><strong>KURL</strong></h3></td></tr></table><p></p><p> Construct an empty URL. </p> <A NAME="~KURL"></A><A NAME="ref3"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <strong>~KURL</strong> () <br></td><td align="right"><h3><strong>~KURL</strong></h3></td></tr></table><p></p><p> destruktor </p> <A NAME="KURL"></A><A NAME="ref4"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <strong>KURL</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& url, int encoding_hint = 0 ) <br></td><td align="right"><h3><strong>KURL</strong></h3></td></tr></table><p></p><p> Usual constructor, to construct from a string. </p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>url</i></TD><TD align="left" valign="top">A URL, not a filename. If the URL does not have a protocol part, "file:" is assumed. It is dangerous to feed unix filenames into this function, this will work most of the time but not always. For example "/home/Torben%20Weis" will be considered a URL pointing to the file "/home/Torben Weis" instead of to the file "/home/Torben%20Weis". This means that if you have a usual UNIX like path you should not use this constructor. Instead create an empty url and set the path by using <A HREF="KURL.html#setPath">setPath</A>(). </TD></TR> <TR><TD align="left" valign="top"><i>encoding_hint</i></TD><TD align="left" valign="top">Reserved, should be 0. </TD></TR> </TABLE></P> <A NAME="KURL"></A><A NAME="ref5"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <strong>KURL</strong> ( const char * url, int encoding_hint = 0 ) <br></td><td align="right"><h3><strong>KURL</strong></h3></td></tr></table><p></p><p> Constructor taking a char * <code>url</code>, which is an _encoded_ representation of the URL, exactly like the usual constructor. This is useful when then URL, in its encoded form, is strictly ascii. </p> <A NAME="KURL"></A><A NAME="ref6"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <strong>KURL</strong> ( const <A HREF="KURL.html">KURL</A>& u ) <br></td><td align="right"><h3><strong>KURL</strong></h3></td></tr></table><p></p><p> Copy constructor </p> <A NAME="KURL"></A><A NAME="ref7"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <strong>KURL</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qurl.html">QUrl</A> &u ) <br></td><td align="right"><h3><strong>KURL</strong></h3></td></tr></table><p></p><p> Convert from a <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qurl.html">QUrl</A>. </p> <A NAME="KURL"></A><A NAME="ref8"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <strong>KURL</strong> ( const <A HREF="KURL.html">KURL</A>& _baseurl, const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _rel_url, int encoding_hint=0 ) <br></td><td align="right"><h3><strong>KURL</strong></h3></td></tr></table><p></p><p> Constructor allowing relative URLs. </p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_baseurl</i></TD><TD align="left" valign="top">The base url. </TD></TR> <TR><TD align="left" valign="top"><i>_rel_url</i></TD><TD align="left" valign="top">A relative or absolute URL. If this is an absolute URL then <code>_baseurl</code> will be ignored. If this is a relative URL it will be combined with <code>_baseurl</code>. Note that _rel_url should be encoded too, in any case. So do NOT pass a path here (use setPath or addPath instead). </TD></TR> <TR><TD align="left" valign="top"><i>encoding_hint</i></TD><TD align="left" valign="top">Reserved, should be 0. </TD></TR> </TABLE></P> <A NAME="protocol"></A><A NAME="ref9"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>protocol</strong> () <br></td><td align="right"><h3><strong>protocol</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Retrieve the protocol for the URL (i.e., file, http, etc.). </p> <A NAME="setProtocol"></A><A NAME="ref10"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setProtocol</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) <br></td><td align="right"><h3><strong>setProtocol</strong></h3></td></tr></table><p></p><p> Set the protocol for the URL (i.e., file, http, etc.) </p> <A NAME="user"></A><A NAME="ref11"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>user</strong> () <br></td><td align="right"><h3><strong>user</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Retrieve the decoded user name (login, user id, ...) included in the URL. </p> <A NAME="setUser"></A><A NAME="ref12"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setUser</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) <br></td><td align="right"><h3><strong>setUser</strong></h3></td></tr></table><p></p><p> Set the user name (login, user id, ...) included the URL. </p> <p> Special characters in the user name will appear encoded in the URL. </p> <A NAME="hasUser"></A><A NAME="ref13"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>hasUser</strong> () <br></td><td align="right"><h3><strong>hasUser</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Test to see if this URL has a user name included in it. </p> <A NAME="pass"></A><A NAME="ref14"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>pass</strong> () <br></td><td align="right"><h3><strong>pass</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Retrieve the decoded password (corresponding to <A HREF="KURL.html#user">user</A>()) included in the URL. </p> <A NAME="setPass"></A><A NAME="ref15"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setPass</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) <br></td><td align="right"><h3><strong>setPass</strong></h3></td></tr></table><p></p><p> Set the password (corresponding to <A HREF="KURL.html#user">user</A>()) included in the URL. </p> <p> Special characters in the password will appear encoded in the URL. </p> <A NAME="hasPass"></A><A NAME="ref16"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>hasPass</strong> () <br></td><td align="right"><h3><strong>hasPass</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Test to see if this URL has a password included in it. </p> <A NAME="host"></A><A NAME="ref17"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>host</strong> () <br></td><td align="right"><h3><strong>host</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Retrieve the decoded hostname included in the URL. </p> <A NAME="setHost"></A><A NAME="ref18"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setHost</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) <br></td><td align="right"><h3><strong>setHost</strong></h3></td></tr></table><p></p><p> Set the hostname included in the URL. </p> <p> Special characters in the hostname will appear encoded in the URL. </p> <A NAME="hasHost"></A><A NAME="ref19"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>hasHost</strong> () <br></td><td align="right"><h3><strong>hasHost</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Test to see if this URL has a hostname included in it. </p> <A NAME="port"></A><A NAME="ref20"></A><table width="100%"><tr bgcolor="#eeeeee"><td>unsigned short int <strong>port</strong> () <br></td><td align="right"><h3><strong>port</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Retrieve the port number included in the URL. If there is no port number specified in the URL, returns 0. </p> <A NAME="setPort"></A><A NAME="ref21"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setPort</strong> ( unsigned short int _p ) <br></td><td align="right"><h3><strong>setPort</strong></h3></td></tr></table><p></p><p> Set the port number included in the URL. </p> <A NAME="path"></A><A NAME="ref22"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>path</strong> () <br></td><td align="right"><h3><strong>path</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p> </p> <p><b>Returns</b>: The current decoded path. This does <em>not</em> include the query. </p> <A NAME="path"></A><A NAME="ref23"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>path</strong> ( int _trailing ) <br></td><td align="right"><h3><strong>path</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_trailing</i></TD><TD align="left" valign="top">May be ( -1, 0 +1 ). -1 strips a trailing '/', +1 adds a trailing '/' if there is none yet and 0 returns the path unchanged. If the URL has no path, then no '/' is added anyway. And on the other side: If the path is "/", then this character won't be stripped. Reason: "ftp://weis@host" means something completely different than "ftp://weis@host/". So adding or stripping the '/' would really alter the URL, while "ftp://host/path" and "ftp://host/path/" mean the same directory. </TD></TR> </TABLE></P> <p><b>Returns</b>: The current decoded path. This does not include the query. </p> <A NAME="setPath"></A><A NAME="ref24"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setPath</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& path ) <br></td><td align="right"><h3><strong>setPath</strong></h3></td></tr></table><p></p><p> path This is considered to be decoded. This means: %3f does not become decoded and the ? does not indicate the start of the query part. The query is not changed by this function. </p> <A NAME="hasPath"></A><A NAME="ref25"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>hasPath</strong> () <br></td><td align="right"><h3><strong>hasPath</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Test to see if this URL has a path is included in it. </p> <A NAME="cleanPath"></A><A NAME="ref26"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>cleanPath</strong> () <br></td><td align="right"><h3><strong>cleanPath</strong></h3></td></tr></table><p></p><p> Removes all multiple directory separators ('/') and resolves any "." or ".." found in the path. Calls <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qdir.html#46d1cc">QDir::cleanDirPath</A> but saves the trailing slash if any. </p> <A NAME="cleanPath"></A><A NAME="ref27"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>cleanPath</strong> (bool cleanDirSeparator) <br></td><td align="right"><h3><strong>cleanPath</strong></h3></td></tr></table><p></p><p> Same as above except it takes a flag that allows you to ignore the clean up of the multiple directory separators. </p> <p> Some servers seem not to like the removal of extra '/' eventhough it is against the specification in RFC 2396. </p> <A NAME="setEncodedPathAndQuery"></A><A NAME="ref28"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setEncodedPathAndQuery</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt, int encoding_hint = 0 ) <br></td><td align="right"><h3><strong>setEncodedPathAndQuery</strong></h3></td></tr></table><p></p><p> This is useful for HTTP. It looks first for '?' and decodes then. The encoded path is the concatenation of the current path and the query. </p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>encoding_hint</i></TD><TD align="left" valign="top">Reserved, should be 0. </TD></TR> </TABLE></P> <A NAME="encodedPathAndQuery"></A><A NAME="ref29"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>encodedPathAndQuery</strong> ( int _trailing = 0, bool _no_empty_path = false, int encoding_hint = 0) <br></td><td align="right"><h3><strong>encodedPathAndQuery</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_no_empty_path</i></TD><TD align="left" valign="top">If set to true then an empty path is substituted by "/". </TD></TR> <TR><TD align="left" valign="top"><i>encoding_hint</i></TD><TD align="left" valign="top">Reserved, should be 0. </TD></TR> </TABLE></P> <p><b>Returns</b>: The concatenation if the encoded path , '?' and the encoded query. </p> <A NAME="setQuery"></A><A NAME="ref30"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setQuery</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt, int encoding_hint = 0) <br></td><td align="right"><h3><strong>setQuery</strong></h3></td></tr></table><p></p><p> </p> <p> The query should start with a '?'. If it doesn't '?' is prepended. </p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_txt</i></TD><TD align="left" valign="top">This is considered to be encoded. This has a good reason: The query may contain the 0 character. </TD></TR> <TR><TD align="left" valign="top"><i>encoding_hint</i></TD><TD align="left" valign="top">Reserved, should be 0. </TD></TR> </TABLE></P> <A NAME="query"></A><A NAME="ref31"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>query</strong> () <br></td><td align="right"><h3><strong>query</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p><b>Returns</b>: The encoded query. This has a good reason: The query may contain the 0 character. If a query is present it always starts with a '?'. A single '?' means an empty query. An empty string means no query. </p> <A NAME="ref"></A><A NAME="ref32"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>ref</strong> () <br></td><td align="right"><h3><strong>ref</strong></h3></td></tr></table><p> <small>[const]</small></p><p> The reference is <em>never</em> decoded automatically. </p> <A NAME="setRef"></A><A NAME="ref33"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setRef</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) <br></td><td align="right"><h3><strong>setRef</strong></h3></td></tr></table><p></p><p> Set the reference part (everything after '#'). </p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_txt</i></TD><TD align="left" valign="top">is considered encoded. </TD></TR> </TABLE></P> <A NAME="hasRef"></A><A NAME="ref34"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>hasRef</strong> () <br></td><td align="right"><h3><strong>hasRef</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p><b>Returns</b>: <code>true</code> if the reference part of the URL is not empty. In a URL like http://www.kde.org/kdebase.tar#tar:/README it would return <code>true</code>, too. </p> <A NAME="htmlRef"></A><A NAME="ref35"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>htmlRef</strong> () <br></td><td align="right"><h3><strong>htmlRef</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p><b>Returns</b>: The HTML-style reference. </p> <A NAME="encodedHtmlRef"></A><A NAME="ref36"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>encodedHtmlRef</strong> () <br></td><td align="right"><h3><strong>encodedHtmlRef</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p><b>Returns</b>: The HTML-style reference in its original form. </p> <A NAME="setHTMLRef"></A><A NAME="ref37"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setHTMLRef</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _ref ) <br></td><td align="right"><h3><strong>setHTMLRef</strong></h3></td></tr></table><p></p><p> Set the HTML-style reference. </p> <p></p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_ref</i></TD><TD align="left" valign="top">This is considered to be <em>not</em> encoded in contrast to <A HREF="KURL.html#setRef">setRef</A>() </TD></TR> </TABLE></P> <p><b>See also</b>: htmlRef()</p> <A NAME="hasHTMLRef"></A><A NAME="ref38"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>hasHTMLRef</strong> () <br></td><td align="right"><h3><strong>hasHTMLRef</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p></p> <p><b>Returns</b>: <code>true</code> if the URL has an HTML-style reference. </p> <p><b>See also</b>: htmlRef()</p> <A NAME="isValid"></A><A NAME="ref39"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>isValid</strong> () <br></td><td align="right"><h3><strong>isValid</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p><b>Returns</b>: <code>false</code> if the URL is malformed. This function does <em>not</em> test whether sub URLs are well-formed, too. </p> <A NAME="isMalformed"></A><A NAME="ref40"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>isMalformed</strong> () <br></td><td align="right"><h3><strong>isMalformed</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <A NAME="isLocalFile"></A><A NAME="ref41"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>isLocalFile</strong> () <br></td><td align="right"><h3><strong>isLocalFile</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p><b>Returns</b>: <code>true</code> if the file is a plain local file and has no filter protocols attached to it. </p> <A NAME="hasSubURL"></A><A NAME="ref42"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>hasSubURL</strong> () <br></td><td align="right"><h3><strong>hasSubURL</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p><b>Returns</b>: <code>true</code> if the file has at least one sub URL. Use <A HREF="KURL.html#split">split</A>() to get the sub URLs. </p> <A NAME="addPath"></A><A NAME="ref43"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>addPath</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _txt ) <br></td><td align="right"><h3><strong>addPath</strong></h3></td></tr></table><p></p><p> Add to the current path. Assumes that the current path is a directory. <code>_txt</code> is appended to the current path. The function adds '/' if needed while concatenating. This means it does not matter whether the current path has a trailing '/' or not. If there is none, it becomes appended. If <code>_txt</code> has a leading '/' then this one is stripped. </p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_txt</i></TD><TD align="left" valign="top">This is considered to be decoded </TD></TR> </TABLE></P> <A NAME="setFileName"></A><A NAME="ref44"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>setFileName</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>&_txt ) <br></td><td align="right"><h3><strong>setFileName</strong></h3></td></tr></table><p></p><p> In comparison to <A HREF="KURL.html#addPath">addPath</A>() this function does not assume that the current path is a directory. This is only assumed if the current path ends with '/'. </p> <p> Any reference is reset. </p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_txt</i></TD><TD align="left" valign="top">This is considered to be decoded. If the current path ends with '/' then <code>_txt</code> ist just appended, otherwise all text behind the last '/' in the current path is erased and <code>_txt</code> is appended then. It does not matter whether <code>_txt</code> starts with '/' or not. </TD></TR> </TABLE></P> <A NAME="fileName"></A><A NAME="ref45"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>fileName</strong> ( bool _ignore_trailing_slash_in_path = true ) <br></td><td align="right"><h3><strong>fileName</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_ignore_trailing_slash_in_path</i></TD><TD align="left" valign="top">This tells whether a trailing '/' should be ignored. This means that the function would return "torben" for <tt>file:/hallo/torben/</tt> and <tt>file:/hallo/torben</tt>. If the flag is set to false, then everything behind the last '/' is considered to be the filename. </TD></TR> </TABLE></P> <p><b>Returns</b>: The filename of the current path. The returned string is decoded. </p> <A NAME="filename"></A><A NAME="ref46"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>filename</strong> ( bool _ignore_trailing_slash_in_path = true ) <br></td><td align="right"><h3><strong>filename</strong></h3></td></tr></table><p> <small>[const]</small></p><A NAME="directory"></A><A NAME="ref47"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>directory</strong> ( bool _strip_trailing_slash_from_result = true, bool _ignore_trailing_slash_in_path = true ) <br></td><td align="right"><h3><strong>directory</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_strip_trailing_slash_from_result</i></TD><TD align="left" valign="top">tells whether the returned result should end with '/' or not. If the path is empty or just "/" then this flag has no effect. </TD></TR> <TR><TD align="left" valign="top"><i>_ignore_trailing_slash_in_path</i></TD><TD align="left" valign="top">means that <tt>file:/hallo/torben</tt> and <tt>file:/hallo/torben/"</tt> would both return <tt>/hallo/</tt> or <tt>/hallo</tt> depending on the other flag </TD></TR> </TABLE></P> <p><b>Returns</b>: The directory part of the current path. Everything between the last and the second last '/' is returned. For example <tt>file:/hallo/torben/</tt> would return "/hallo/torben/" while <tt>file:/hallo/torben</tt> would return "hallo/". The returned string is decoded. </p> <A NAME="cd"></A><A NAME="ref48"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>cd</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _dir ) <br></td><td align="right"><h3><strong>cd</strong></h3></td></tr></table><p></p><p> Change directory by descending into the given directory. It is assumed the current URL represents a directory. If <code>dir</code> starts with a "/" the current URL will be "protocol://host/dir" otherwise <code>_dir</code> will be appended to the path. <code>_dir</code> can be ".." This function won't strip protocols. That means that when you are in file:/dir/dir2/my.tgz#tar:/ and you do cd("..") you will still be in file:/dir/dir2/my.tgz#tar:/ </p> <p></p> <p><b>Returns</b>: true </p> <A NAME="url"></A><A NAME="ref49"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>url</strong> ( int _trailing = 0 ) <br></td><td align="right"><h3><strong>url</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_trailing</i></TD><TD align="left" valign="top">This may be ( -1, 0 +1 ). -1 strips a trailing '/' from the path, +1 adds a trailing '/' if there is none yet and 0 returns the path unchanged. </TD></TR> </TABLE></P> <p><b>Returns</b>: The complete URL, with all escape sequences intact. Example: http://localhost:8080/test.cgi?test=hello%20world&name=fred </p> <A NAME="url"></A><A NAME="ref50"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>url</strong> ( int _trailing, int encoding_hint ) <br></td><td align="right"><h3><strong>url</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_trailing</i></TD><TD align="left" valign="top">This may be ( -1, 0 +1 ). -1 strips a trailing '/' from the path, +1 adds a trailing '/' if there is none yet and 0 returns the path unchanged. </TD></TR> <TR><TD align="left" valign="top"><i>encoding_hint</i></TD><TD align="left" valign="top">The charset to use for encoding (see QFont::Charset). </TD></TR> </TABLE></P> <p><b>Returns</b>: The complete URL, with all escape sequences intact, encoded in a given charset. This is used in particular for encoding URLs in UTF-8 before using them in a drag and drop operation. </p> <A NAME="prettyURL"></A><A NAME="ref51"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>prettyURL</strong> ( int _trailing = 0) <br></td><td align="right"><h3><strong>prettyURL</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p><b>Returns</b>: A human readable URL, with no non-necessary encodings/escaped characters. Example: http://localhost:8080/test.cgi?test=hello world&name=fred </p> <A NAME="isEmpty"></A><A NAME="ref52"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>isEmpty</strong> () <br></td><td align="right"><h3><strong>isEmpty</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Test to see if the <A HREF="KURL.html#KURL">KURL</A> is empty. </p> <A NAME="upURL"></A><A NAME="ref53"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="KURL.html">KURL</A> <strong>upURL</strong> ( ) <br></td><td align="right"><h3><strong>upURL</strong></h3></td></tr></table><p> <small>[const]</small></p><p> This function is useful to implement the "Up" button in a file manager for example. <A HREF="KURL.html#cd">cd</A>() never strips a sub-protocol. That means that if you are in file:/home/x.tgz#gzip:/#tar:/ and hit the up button you expect to see file:/home. The algorithm tries to go up on the right-most URL. If that is not possible it strips the right most URL. It continues stripping URLs. </p> <A NAME="operator="></A><A NAME="ref54"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="KURL.html">KURL</A>& <strong>operator=</strong> ( const <A HREF="KURL.html">KURL</A>& _u ) <br></td><td align="right"><h3><strong>operator=</strong></h3></td></tr></table><p></p><A NAME="operator="></A><A NAME="ref55"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="KURL.html">KURL</A>& <strong>operator=</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _url ) <br></td><td align="right"><h3><strong>operator=</strong></h3></td></tr></table><p></p><A NAME="operator="></A><A NAME="ref56"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="KURL.html">KURL</A>& <strong>operator=</strong> ( const char * _url ) <br></td><td align="right"><h3><strong>operator=</strong></h3></td></tr></table><p></p><A NAME="operator="></A><A NAME="ref57"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="KURL.html">KURL</A>& <strong>operator=</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qurl.html">QUrl</A> & u ) <br></td><td align="right"><h3><strong>operator=</strong></h3></td></tr></table><p></p><A NAME="operator=="></A><A NAME="ref58"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>operator==</strong> ( const <A HREF="KURL.html">KURL</A>& _u ) <br></td><td align="right"><h3><strong>operator==</strong></h3></td></tr></table><p> <small>[const]</small></p><A NAME="operator=="></A><A NAME="ref59"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>operator==</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _u ) <br></td><td align="right"><h3><strong>operator==</strong></h3></td></tr></table><p> <small>[const]</small></p><A NAME="operator!="></A><A NAME="ref60"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>operator!=</strong> ( const <A HREF="KURL.html">KURL</A>& _u ) <br></td><td align="right"><h3><strong>operator!=</strong></h3></td></tr></table><p> <small>[const]</small></p><A NAME="operator!="></A><A NAME="ref61"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>operator!=</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _u ) <br></td><td align="right"><h3><strong>operator!=</strong></h3></td></tr></table><p> <small>[const]</small></p><A NAME="cmp"></A><A NAME="ref62"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>cmp</strong> ( const <A HREF="KURL.html">KURL</A> &u, bool ignore_trailing = false ) <br></td><td align="right"><h3><strong>cmp</strong></h3></td></tr></table><p> <small>[const]</small></p><p> Compare this url with <code>u</code> </p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>ignore_trailing</i></TD><TD align="left" valign="top">set to true to ignore trailing '/' characters. </TD></TR> </TABLE></P> <p><b>Returns</b>: true if both urls are the same </p> <p><b>See also</b>: operator==., This, function, should, be, used, if, you, want, to, ignore, trailing, '/', characters.</p> <A NAME="isParentOf"></A><A NAME="ref63"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>isParentOf</strong> ( const <A HREF="KURL.html">KURL</A>& u ) <br></td><td align="right"><h3><strong>isParentOf</strong></h3></td></tr></table><p> <small>[const]</small></p><p> </p> <p><b>Returns</b>: true if this url is a parent of <code>u</code> (or the same URL as <code>u</code>) For instance, ftp://host/dir/ is a parent of ftp://host/dir/subdir/subsubdir/. </p> <A NAME="split"></A><A NAME="ref64"></A><table width="100%"><tr bgcolor="#eeeeee"><td> List <strong>split</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _url ) <br></td><td align="right"><h3><strong>split</strong></h3></td></tr></table><p> <small>[static]</small></p><p> Splits nested URLs like file:/home/weis/kde.tgz#gzip:/#tar:/kdebase A URL like http://www.kde.org#tar:/kde/README.hml#ref1 will be split in http://www.kde.org and tar:/kde/README.html#ref1. That means in turn that "#ref1" is an HTML-style reference and not a new sub URL. Since HTML-style references mark a certain position in a document this reference is appended to every URL. The idea behind this is that browsers, for example, only look at the first URL while the rest is not of interest to them. </p> <p></p> <p></p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_url</i></TD><TD align="left" valign="top">The URL that has to be split. </TD></TR> </TABLE></P> <p><b>Returns</b>: An empty list on error or the list of split URLs. </p> <A NAME="split"></A><A NAME="ref65"></A><table width="100%"><tr bgcolor="#eeeeee"><td> List <strong>split</strong> ( const <A HREF="KURL.html">KURL</A>& _url ) <br></td><td align="right"><h3><strong>split</strong></h3></td></tr></table><p> <small>[static]</small></p><p> A convenience function. </p> <A NAME="join"></A><A NAME="ref66"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <A HREF="KURL.html">KURL</A> <strong>join</strong> ( const List& _list ) <br></td><td align="right"><h3><strong>join</strong></h3></td></tr></table><p> <small>[static]</small></p><p> Reverses <A HREF="KURL.html#split">split</A>(). Only the first URL may have a reference. This reference is considered to be HTML-like and is appended at the end of the resulting joined URL. </p> <A NAME="encode_string"></A><A NAME="ref67"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>encode_string</strong> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> &str, int encoding_hint = 0) <br></td><td align="right"><h3><strong>encode_string</strong></h3></td></tr></table><p> <small>[static]</small></p><p> Convenience function </p> <p> Convert unicoded string to local encoding and use %-style encoding for all common delimiters / non-ascii characters. </p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>str</i></TD><TD align="left" valign="top">String to encode </TD></TR> <TR><TD align="left" valign="top"><i>encoding_hint</i></TD><TD align="left" valign="top">Reserved, should be 0. </TD></TR> </TABLE></P> <A NAME="encode_string_no_slash"></A><A NAME="ref68"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>encode_string_no_slash</strong> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> &str, int encoding_hint = 0) <br></td><td align="right"><h3><strong>encode_string_no_slash</strong></h3></td></tr></table><p> <small>[static]</small></p><p> Convenience function </p> <p> Convert unicoded string to local encoding and use %-style encoding for all common delimiters / non-ascii characters as well as the slash '/'. </p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>str</i></TD><TD align="left" valign="top">String to encode </TD></TR> <TR><TD align="left" valign="top"><i>encoding_hint</i></TD><TD align="left" valign="top">Reserved, should be 0. </TD></TR> </TABLE></P> <A NAME="decode_string"></A><A NAME="ref69"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>decode_string</strong> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> &str, int encoding_hint = 0) <br></td><td align="right"><h3><strong>decode_string</strong></h3></td></tr></table><p> <small>[static]</small></p><p> Convenience function </p> <p> Decode %-style encoding and convert from local encoding to unicode. </p> <p> Revers of encode_string() </p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>str</i></TD><TD align="left" valign="top">String to decode </TD></TR> <TR><TD align="left" valign="top"><i>encoding_hint</i></TD><TD align="left" valign="top">Reserved, should be 0. </TD></TR> </TABLE></P> <A NAME="isRelativeURL"></A><A NAME="ref70"></A><table width="100%"><tr bgcolor="#eeeeee"><td> bool <strong>isRelativeURL</strong> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> &_url) <br></td><td align="right"><h3><strong>isRelativeURL</strong></h3></td></tr></table><p> <small>[static]</small></p><p> Convenience function </p> <p> Returns whether '_url' is likely to be a "relative" URL instead of an "absolute" URL. </p> <p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5"> <TR><TD align="left" valign="top"><i>_url</i></TD><TD align="left" valign="top">URL to examine </TD></TR> </TABLE></P> <p><b>Returns</b>: true when the URL is likely to be "relative", false otherwise. </p> <A NAME="reset"></A><A NAME="ref71"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>reset</strong> () <br></td><td align="right"><h3><strong>reset</strong></h3></td></tr></table><p> <small>[protected]</small></p><A NAME="parse"></A><A NAME="ref72"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>parse</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& _url, int encoding_hint = 0) <br></td><td align="right"><h3><strong>parse</strong></h3></td></tr></table><p> <small>[protected]</small></p><HR><UL><LI><i>Author</i>: Torben Weis <weis@kde.org> </LI><LI><i>Generated</i>: qateam on updates.mandrakesoft.com on Mon Dec 30 16:08:56 2002, using kdoc 2.0a53.</LI></UL></BODY></HTML>