Sophie

Sophie

distrib > Fedora > 15 > i386 > by-pkgid > 1f9eb832ba1e4b88d9a5c2b384813bb4 > files > 2415

kdelibs3-apidocs-3.5.10-31.fc15.noarch.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">

<head>
  <title>kdecore: kurl.cpp Source File (kdecore)</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

  <meta http-equiv="Content-Style-Type" content="text/css" />

  <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org"  r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org"  r (n 0 s 0 v 0 l 0))' />

  <meta name="trademark" content="KDE e.V." />
  <meta name="description" content="K Desktop Environment Homepage, KDE.org" />
  <meta name="MSSmartTagsPreventParsing" content="true" />
  <meta name="robots" content="all" />

  <link rel="shortcut icon" href="../../favicon.ico" />

<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />



</head>

<body>

<div id="nav_header_top" align="right">
  <a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>

  <a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a>
  <span class="doNotDisplay">::</span>

  <div id="nav_header_title" align="left">KDE API Reference</div>


</div>

<div id="nav_header_bottom" align="right">
  <span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
  <div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../..">API Reference</a>
 / <a href=".">kdecore</a>
  </div>
</div>


<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
      <td valign="top" class="menuheader" height="0"></td>

  <td id="contentcolumn" valign="top" rowspan="2" >
    <div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
    <a name="content"></a>


<!-- Generated by Doxygen 1.7.4 -->
<div class="header">
  <div class="headertitle">
<div class="title">kurl.cpp</div>  </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment">    Copyright (C) 1999 Torben Weis &lt;weis@kde.org&gt;</span>
<a name="l00003"></a>00003 <span class="comment"></span>
<a name="l00004"></a>00004 <span class="comment">    This library is free software; you can redistribute it and/or</span>
<a name="l00005"></a>00005 <span class="comment">    modify it under the terms of the GNU Library General Public</span>
<a name="l00006"></a>00006 <span class="comment">    License as published by the Free Software Foundation; either</span>
<a name="l00007"></a>00007 <span class="comment">    version 2 of the License, or (at your option) any later version.</span>
<a name="l00008"></a>00008 <span class="comment"></span>
<a name="l00009"></a>00009 <span class="comment">    This library is distributed in the hope that it will be useful,</span>
<a name="l00010"></a>00010 <span class="comment">    but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00011"></a>00011 <span class="comment">    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU</span>
<a name="l00012"></a>00012 <span class="comment">    Library General Public License for more details.</span>
<a name="l00013"></a>00013 <span class="comment"></span>
<a name="l00014"></a>00014 <span class="comment">    You should have received a copy of the GNU Library General Public License</span>
<a name="l00015"></a>00015 <span class="comment">    along with this library; see the file COPYING.LIB.  If not, write to</span>
<a name="l00016"></a>00016 <span class="comment">    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span>
<a name="l00017"></a>00017 <span class="comment">    Boston, MA 02110-1301, USA.</span>
<a name="l00018"></a>00018 <span class="comment">*/</span>
<a name="l00019"></a>00019 
<a name="l00020"></a>00020 <span class="comment">/*</span>
<a name="l00021"></a>00021 <span class="comment"> * The currently active RFC for URL/URIs is RFC3986</span>
<a name="l00022"></a>00022 <span class="comment"> * Previous (and now deprecated) RFCs are RFC1738 and RFC2396</span>
<a name="l00023"></a>00023 <span class="comment"> */</span>
<a name="l00024"></a>00024 
<a name="l00025"></a>00025 <span class="preprocessor">#include &quot;kurl.h&quot;</span>
<a name="l00026"></a>00026 
<a name="l00027"></a>00027 <span class="comment">// KDE_QT_ONLY is first used for dcop/client (e.g. marshalling)</span>
<a name="l00028"></a>00028 <span class="preprocessor">#ifndef KDE_QT_ONLY</span>
<a name="l00029"></a>00029 <span class="preprocessor"></span><span class="preprocessor">#include &lt;kdebug.h&gt;</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include &lt;kglobal.h&gt;</span>
<a name="l00031"></a>00031 <span class="preprocessor">#include &lt;kidna.h&gt;</span>
<a name="l00032"></a>00032 <span class="preprocessor">#include &lt;kprotocolinfo.h&gt;</span>
<a name="l00033"></a>00033 <span class="preprocessor">#endif</span>
<a name="l00034"></a>00034 <span class="preprocessor"></span>
<a name="l00035"></a>00035 <span class="preprocessor">#include &lt;stdio.h&gt;</span>
<a name="l00036"></a>00036 <span class="preprocessor">#include &lt;assert.h&gt;</span>
<a name="l00037"></a>00037 <span class="preprocessor">#include &lt;ctype.h&gt;</span>
<a name="l00038"></a>00038 <span class="preprocessor">#include &lt;stdlib.h&gt;</span>
<a name="l00039"></a>00039 <span class="preprocessor">#include &lt;unistd.h&gt;</span>
<a name="l00040"></a>00040 
<a name="l00041"></a>00041 <span class="preprocessor">#include &lt;qurl.h&gt;</span>
<a name="l00042"></a>00042 <span class="preprocessor">#include &lt;qdir.h&gt;</span>
<a name="l00043"></a>00043 <span class="preprocessor">#include &lt;qstringlist.h&gt;</span>
<a name="l00044"></a>00044 <span class="preprocessor">#include &lt;qregexp.h&gt;</span>
<a name="l00045"></a>00045 <span class="preprocessor">#include &lt;qstylesheet.h&gt;</span>
<a name="l00046"></a>00046 <span class="preprocessor">#include &lt;qmap.h&gt;</span>
<a name="l00047"></a>00047 <span class="preprocessor">#include &lt;qtextcodec.h&gt;</span>
<a name="l00048"></a>00048 <span class="preprocessor">#include &lt;qmutex.h&gt;</span>
<a name="l00049"></a>00049 
<a name="l00050"></a>00050 <span class="preprocessor">#ifdef Q_WS_WIN</span>
<a name="l00051"></a>00051 <span class="preprocessor"></span><span class="preprocessor"># define KURL_ROOTDIR_PATH &quot;C:/&quot;</span>
<a name="l00052"></a>00052 <span class="preprocessor"></span><span class="preprocessor">#else</span>
<a name="l00053"></a>00053 <span class="preprocessor"></span><span class="preprocessor"># define KURL_ROOTDIR_PATH &quot;/&quot;</span>
<a name="l00054"></a>00054 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00055"></a>00055 <span class="preprocessor"></span>
<a name="l00056"></a>00056 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> fileProt = <span class="stringliteral">&quot;file&quot;</span>;
<a name="l00057"></a>00057 
<a name="l00058"></a>00058 <span class="keyword">static</span> <a class="codeRef" href="qtextcodec.html">QTextCodec</a> * codecForHint( <span class="keywordtype">int</span> encoding_hint <span class="comment">/* not 0 ! */</span> )
<a name="l00059"></a>00059 {
<a name="l00060"></a>00060     <span class="keywordflow">return</span> <a class="codeRef" href="qtextcodec.html#codecForMib">QTextCodec::codecForMib</a>( encoding_hint );
<a name="l00061"></a>00061 }
<a name="l00062"></a>00062 
<a name="l00063"></a>00063 <span class="comment">// encoding_offset:</span>
<a name="l00064"></a>00064 <span class="comment">// 0 encode both @ and /</span>
<a name="l00065"></a>00065 <span class="comment">// 1 encode @ but not /</span>
<a name="l00066"></a>00066 <span class="comment">// 2 encode neither @ or /</span>
<a name="l00067"></a>00067 <span class="keyword">static</span> <a class="codeRef" href="qstring.html">QString</a> encode( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; segment, <span class="keywordtype">int</span> encoding_offset, <span class="keywordtype">int</span> encoding_hint, <span class="keywordtype">bool</span> isRawURI = <span class="keyword">false</span> )
<a name="l00068"></a>00068 {
<a name="l00069"></a>00069   <span class="keyword">const</span> <span class="keywordtype">char</span> *encode_string = <span class="stringliteral">&quot;/@&lt;&gt;#\&quot;&amp;?={}|^~[]\&#39;`\\:+%&quot;</span>;
<a name="l00070"></a>00070   encode_string += encoding_offset;
<a name="l00071"></a>00071 
<a name="l00072"></a>00072   <a class="codeRef" href="qcstring.html">QCString</a> local;
<a name="l00073"></a>00073   <span class="keywordflow">if</span> (encoding_hint==0)
<a name="l00074"></a>00074     local = segment.<a class="codeRef" href="qstring.html#local8Bit">local8Bit</a>();
<a name="l00075"></a>00075   <span class="keywordflow">else</span>
<a name="l00076"></a>00076   {
<a name="l00077"></a>00077       <a class="codeRef" href="qtextcodec.html">QTextCodec</a> * textCodec = codecForHint( encoding_hint );
<a name="l00078"></a>00078       <span class="keywordflow">if</span> (!textCodec)
<a name="l00079"></a>00079           local = segment.<a class="codeRef" href="qstring.html#local8Bit">local8Bit</a>();
<a name="l00080"></a>00080       <span class="keywordflow">else</span>
<a name="l00081"></a>00081           local = textCodec-&gt;<a class="codeRef" href="qtextcodec.html#fromUnicode">fromUnicode</a>( segment );
<a name="l00082"></a>00082   }
<a name="l00083"></a>00083 
<a name="l00084"></a>00084   <span class="keywordtype">int</span> old_length = isRawURI ? local.size() - 1 : local.<a class="codeRef" href="qcstring.html#length">length</a>();
<a name="l00085"></a>00085 
<a name="l00086"></a>00086   <span class="keywordflow">if</span> ( !old_length )
<a name="l00087"></a>00087     <span class="keywordflow">return</span> segment.<a class="codeRef" href="qstring.html#isNull">isNull</a>() ? QString::null : <a class="codeRef" href="qstring.html">QString</a>(<span class="stringliteral">&quot;&quot;</span>); <span class="comment">// differentiate null and empty</span>
<a name="l00088"></a>00088 
<a name="l00089"></a>00089   <span class="comment">// a worst case approximation</span>
<a name="l00090"></a>00090   <a class="codeRef" href="qchar.html">QChar</a> *new_segment = <span class="keyword">new</span> <a class="codeRef" href="qchar.html">QChar</a>[ old_length * 3 + 1 ];
<a name="l00091"></a>00091   <span class="keywordtype">int</span> new_length = 0;
<a name="l00092"></a>00092 
<a name="l00093"></a>00093   <span class="keywordflow">for</span> ( <span class="keywordtype">int</span> i = 0; i &lt; old_length; i++ )
<a name="l00094"></a>00094   {
<a name="l00095"></a>00095     <span class="comment">// &#39;unsave&#39; and &#39;reserved&#39; characters</span>
<a name="l00096"></a>00096     <span class="comment">// according to RFC 1738,</span>
<a name="l00097"></a>00097     <span class="comment">// 2.2. URL Character Encoding Issues (pp. 3-4)</span>
<a name="l00098"></a>00098     <span class="comment">// WABA: Added non-ascii</span>
<a name="l00099"></a>00099     <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> character = local[i];
<a name="l00100"></a>00100     <span class="keywordflow">if</span> ( (character &lt;= 32) || (character &gt;= 127) ||
<a name="l00101"></a>00101          strchr(encode_string, character) )
<a name="l00102"></a>00102     {
<a name="l00103"></a>00103       new_segment[ new_length++ ] = <span class="charliteral">&#39;%&#39;</span>;
<a name="l00104"></a>00104 
<a name="l00105"></a>00105       <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> c = character / 16;
<a name="l00106"></a>00106       c += (c &gt; 9) ? (<span class="charliteral">&#39;A&#39;</span> - 10) : <span class="charliteral">&#39;0&#39;</span>;
<a name="l00107"></a>00107       new_segment[ new_length++ ] = c;
<a name="l00108"></a>00108 
<a name="l00109"></a>00109       c = character % 16;
<a name="l00110"></a>00110       c += (c &gt; 9) ? (<span class="charliteral">&#39;A&#39;</span> - 10) : <span class="charliteral">&#39;0&#39;</span>;
<a name="l00111"></a>00111       new_segment[ new_length++ ] = c;
<a name="l00112"></a>00112 
<a name="l00113"></a>00113     }
<a name="l00114"></a>00114     <span class="keywordflow">else</span>
<a name="l00115"></a>00115       new_segment[ new_length++ ] = local[i];
<a name="l00116"></a>00116   }
<a name="l00117"></a>00117 
<a name="l00118"></a>00118   <a class="codeRef" href="qstring.html">QString</a> result = <a class="codeRef" href="qstring.html">QString</a>(new_segment, new_length);
<a name="l00119"></a>00119   <span class="keyword">delete</span> [] new_segment;
<a name="l00120"></a>00120   <span class="keywordflow">return</span> result;
<a name="l00121"></a>00121 }
<a name="l00122"></a>00122 
<a name="l00123"></a>00123 <span class="keyword">static</span> <a class="codeRef" href="qstring.html">QString</a> encodeHost( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; segment, <span class="keywordtype">bool</span> encode_slash, <span class="keywordtype">int</span> encoding_hint )
<a name="l00124"></a>00124 {
<a name="l00125"></a>00125   <span class="comment">// Hostnames are encoded differently</span>
<a name="l00126"></a>00126   <span class="comment">// we use the IDNA transformation instead</span>
<a name="l00127"></a>00127 
<a name="l00128"></a>00128   <span class="comment">// Note: when merging qt-addon, use QResolver::domainToAscii here</span>
<a name="l00129"></a>00129 <span class="preprocessor">#ifndef KDE_QT_ONLY</span>
<a name="l00130"></a>00130 <span class="preprocessor"></span>  Q_UNUSED( encode_slash );
<a name="l00131"></a>00131   Q_UNUSED( encoding_hint );
<a name="l00132"></a>00132   <a class="codeRef" href="qstring.html">QString</a> host = KIDNA::toAscii(segment);
<a name="l00133"></a>00133   <span class="keywordflow">if</span> (host.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l00134"></a>00134      <span class="keywordflow">return</span> segment;
<a name="l00135"></a>00135   <span class="keywordflow">return</span> host;
<a name="l00136"></a>00136 <span class="preprocessor">#else</span>
<a name="l00137"></a>00137 <span class="preprocessor"></span>  <span class="keywordflow">return</span> encode(segment, encode_slash ? 0 : 1, encoding_hint);
<a name="l00138"></a>00138 <span class="preprocessor">#endif</span>
<a name="l00139"></a>00139 <span class="preprocessor"></span>}
<a name="l00140"></a>00140 
<a name="l00141"></a>00141 <span class="keyword">static</span> <span class="keywordtype">int</span> hex2int( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> _char )
<a name="l00142"></a>00142 {
<a name="l00143"></a>00143   <span class="keywordflow">if</span> ( _char &gt;= <span class="charliteral">&#39;A&#39;</span> &amp;&amp; _char &lt;=<span class="charliteral">&#39;F&#39;</span>)
<a name="l00144"></a>00144     <span class="keywordflow">return</span> _char - <span class="charliteral">&#39;A&#39;</span> + 10;
<a name="l00145"></a>00145   <span class="keywordflow">if</span> ( _char &gt;= <span class="charliteral">&#39;a&#39;</span> &amp;&amp; _char &lt;=<span class="charliteral">&#39;f&#39;</span>)
<a name="l00146"></a>00146     <span class="keywordflow">return</span> _char - <span class="charliteral">&#39;a&#39;</span> + 10;
<a name="l00147"></a>00147   <span class="keywordflow">if</span> ( _char &gt;= <span class="charliteral">&#39;0&#39;</span> &amp;&amp; _char &lt;=<span class="charliteral">&#39;9&#39;</span>)
<a name="l00148"></a>00148     <span class="keywordflow">return</span> _char - <span class="charliteral">&#39;0&#39;</span>;
<a name="l00149"></a>00149   <span class="keywordflow">return</span> -1;
<a name="l00150"></a>00150 }
<a name="l00151"></a>00151 
<a name="l00152"></a>00152 <span class="comment">// WABA: The result of lazy_encode isn&#39;t usable for a URL which</span>
<a name="l00153"></a>00153 <span class="comment">// needs to satisfies RFC requirements. However, the following</span>
<a name="l00154"></a>00154 <span class="comment">// operation will make it usable again:</span>
<a name="l00155"></a>00155 <span class="comment">//      encode(decode(...))</span>
<a name="l00156"></a>00156 <span class="comment">//</span>
<a name="l00157"></a>00157 <span class="comment">// As a result one can see that url.prettyURL() does not result in</span>
<a name="l00158"></a>00158 <span class="comment">// a RFC compliant URL but that the following sequence does:</span>
<a name="l00159"></a>00159 <span class="comment">//      KURL(url.prettyURL()).url()</span>
<a name="l00160"></a>00160 
<a name="l00161"></a>00161 
<a name="l00162"></a>00162 <span class="keyword">static</span> <a class="codeRef" href="qstring.html">QString</a> lazy_encode( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; segment, <span class="keywordtype">bool</span> encodeAt=<span class="keyword">true</span> )
<a name="l00163"></a>00163 {
<a name="l00164"></a>00164   <span class="keywordtype">int</span> old_length = segment.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00165"></a>00165 
<a name="l00166"></a>00166   <span class="keywordflow">if</span> ( !old_length )
<a name="l00167"></a>00167     <span class="keywordflow">return</span> QString::null;
<a name="l00168"></a>00168 
<a name="l00169"></a>00169   <span class="comment">// a worst case approximation</span>
<a name="l00170"></a>00170   <a class="codeRef" href="qchar.html">QChar</a> *new_segment = <span class="keyword">new</span> <a class="codeRef" href="qchar.html">QChar</a>[ old_length * 3 + 1 ];
<a name="l00171"></a>00171   <span class="keywordtype">int</span> new_length = 0;
<a name="l00172"></a>00172 
<a name="l00173"></a>00173   <span class="keywordflow">for</span> ( <span class="keywordtype">int</span> i = 0; i &lt; old_length; i++ )
<a name="l00174"></a>00174   {
<a name="l00175"></a>00175     <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> character = segment[i].<a class="codeRef" href="qstring.html#unicode">unicode</a>(); <span class="comment">// Don&#39;t use latin1()</span>
<a name="l00176"></a>00176                                                    <span class="comment">// It returns 0 for non-latin1 values</span>
<a name="l00177"></a>00177     <span class="comment">// Small set of really ambiguous chars</span>
<a name="l00178"></a>00178     <span class="keywordflow">if</span> ((character &lt; 32) ||  <span class="comment">// Low ASCII</span>
<a name="l00179"></a>00179         ((character == <span class="charliteral">&#39;%&#39;</span>) &amp;&amp; <span class="comment">// The escape character itself</span>
<a name="l00180"></a>00180            (i+2 &lt; old_length) &amp;&amp; <span class="comment">// But only if part of a valid escape sequence!</span>
<a name="l00181"></a>00181           (hex2int(segment[i+1].unicode())!= -1) &amp;&amp;
<a name="l00182"></a>00182           (hex2int(segment[i+2].unicode())!= -1)) ||
<a name="l00183"></a>00183         (character == <span class="charliteral">&#39;?&#39;</span>) || <span class="comment">// Start of query delimiter</span>
<a name="l00184"></a>00184         ((character == <span class="charliteral">&#39;@&#39;</span>) &amp;&amp; encodeAt) || <span class="comment">// Username delimiter</span>
<a name="l00185"></a>00185         (character == <span class="charliteral">&#39;#&#39;</span>) || <span class="comment">// Start of reference delimiter</span>
<a name="l00186"></a>00186         ((character == 32) &amp;&amp; (i+1 == old_length || segment[i+1] == <span class="charliteral">&#39; &#39;</span>))) <span class="comment">// A trailing space</span>
<a name="l00187"></a>00187     {
<a name="l00188"></a>00188       new_segment[ new_length++ ] = <span class="charliteral">&#39;%&#39;</span>;
<a name="l00189"></a>00189 
<a name="l00190"></a>00190       <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> c = character / 16;
<a name="l00191"></a>00191       c += (c &gt; 9) ? (<span class="charliteral">&#39;A&#39;</span> - 10) : <span class="charliteral">&#39;0&#39;</span>;
<a name="l00192"></a>00192       new_segment[ new_length++ ] = c;
<a name="l00193"></a>00193 
<a name="l00194"></a>00194       c = character % 16;
<a name="l00195"></a>00195       c += (c &gt; 9) ? (<span class="charliteral">&#39;A&#39;</span> - 10) : <span class="charliteral">&#39;0&#39;</span>;
<a name="l00196"></a>00196       new_segment[ new_length++ ] = c;
<a name="l00197"></a>00197     }
<a name="l00198"></a>00198     <span class="keywordflow">else</span>
<a name="l00199"></a>00199     new_segment[ new_length++ ] = segment[i];
<a name="l00200"></a>00200   }
<a name="l00201"></a>00201 
<a name="l00202"></a>00202   <a class="codeRef" href="qstring.html">QString</a> result = <a class="codeRef" href="qstring.html">QString</a>(new_segment, new_length);
<a name="l00203"></a>00203   <span class="keyword">delete</span> [] new_segment;
<a name="l00204"></a>00204   <span class="keywordflow">return</span> result;
<a name="l00205"></a>00205 }
<a name="l00206"></a>00206 
<a name="l00207"></a>00207 <span class="keyword">static</span> <span class="keywordtype">void</span> decode( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; segment, <a class="codeRef" href="qstring.html">QString</a> &amp;decoded, <a class="codeRef" href="qstring.html">QString</a> &amp;encoded, <span class="keywordtype">int</span> encoding_hint=0, <span class="keywordtype">bool</span> updateDecoded = <span class="keyword">true</span>, <span class="keywordtype">bool</span> isRawURI = <span class="keyword">false</span> )
<a name="l00208"></a>00208 {
<a name="l00209"></a>00209   decoded = QString::null;
<a name="l00210"></a>00210   encoded = segment;
<a name="l00211"></a>00211 
<a name="l00212"></a>00212   <span class="keywordtype">int</span> old_length = segment.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00213"></a>00213   <span class="keywordflow">if</span> ( !old_length )
<a name="l00214"></a>00214     <span class="keywordflow">return</span>;
<a name="l00215"></a>00215 
<a name="l00216"></a>00216   <a class="codeRef" href="qtextcodec.html">QTextCodec</a> *textCodec = 0;
<a name="l00217"></a>00217   <span class="keywordflow">if</span> (encoding_hint)
<a name="l00218"></a>00218       textCodec = codecForHint( encoding_hint );
<a name="l00219"></a>00219 
<a name="l00220"></a>00220   <span class="keywordflow">if</span> (!textCodec)
<a name="l00221"></a>00221       textCodec = <a class="codeRef" href="qtextcodec.html#codecForLocale">QTextCodec::codecForLocale</a>();
<a name="l00222"></a>00222 
<a name="l00223"></a>00223   <a class="codeRef" href="qcstring.html">QCString</a> csegment = textCodec-&gt;<a class="codeRef" href="qtextcodec.html#fromUnicode">fromUnicode</a>(segment);
<a name="l00224"></a>00224   <span class="comment">// Check if everything went ok</span>
<a name="l00225"></a>00225   <span class="keywordflow">if</span> (textCodec-&gt;<a class="codeRef" href="qtextcodec.html#toUnicode">toUnicode</a>(csegment) != segment)
<a name="l00226"></a>00226   {
<a name="l00227"></a>00227       <span class="comment">// Uh oh</span>
<a name="l00228"></a>00228       textCodec = codecForHint( 106 ); <span class="comment">// Fall back to utf-8</span>
<a name="l00229"></a>00229       csegment = textCodec-&gt;<a class="codeRef" href="qtextcodec.html#fromUnicode">fromUnicode</a>(segment);
<a name="l00230"></a>00230   }
<a name="l00231"></a>00231   old_length = csegment.<a class="codeRef" href="qcstring.html#length">length</a>();
<a name="l00232"></a>00232 
<a name="l00233"></a>00233   <span class="keywordtype">int</span> new_length = 0;
<a name="l00234"></a>00234   <span class="keywordtype">int</span> new_length2 = 0;
<a name="l00235"></a>00235 
<a name="l00236"></a>00236   <span class="comment">// make a copy of the old one</span>
<a name="l00237"></a>00237   <span class="keywordtype">char</span> *new_segment = <span class="keyword">new</span> <span class="keywordtype">char</span>[ old_length + 1 ];
<a name="l00238"></a>00238   <a class="codeRef" href="qchar.html">QChar</a> *new_usegment = <span class="keyword">new</span> <a class="codeRef" href="qchar.html">QChar</a>[ old_length * 3 + 1 ];
<a name="l00239"></a>00239 
<a name="l00240"></a>00240   <span class="keywordtype">int</span> i = 0;
<a name="l00241"></a>00241   <span class="keywordflow">while</span>( i &lt; old_length )
<a name="l00242"></a>00242   {
<a name="l00243"></a>00243     <span class="keywordtype">bool</span> bReencode = <span class="keyword">false</span>;
<a name="l00244"></a>00244     <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> character = csegment[ i++ ];
<a name="l00245"></a>00245     <span class="keywordflow">if</span> ((character &lt;= <span class="charliteral">&#39; &#39;</span>) || (character &gt; 127))
<a name="l00246"></a>00246        bReencode = <span class="keyword">true</span>;
<a name="l00247"></a>00247 
<a name="l00248"></a>00248     new_usegment [ new_length2++ ] = character;
<a name="l00249"></a>00249     <span class="keywordflow">if</span> (character == <span class="charliteral">&#39;%&#39;</span> )
<a name="l00250"></a>00250     {
<a name="l00251"></a>00251       <span class="keywordtype">int</span> a = i+1 &lt; old_length ? hex2int( csegment[i] ) : -1;
<a name="l00252"></a>00252       <span class="keywordtype">int</span> b = i+1 &lt; old_length ? hex2int( csegment[i+1] ) : -1;
<a name="l00253"></a>00253       <span class="keywordflow">if</span> ((a == -1) || (b == -1)) <span class="comment">// Only replace if sequence is valid</span>
<a name="l00254"></a>00254       {
<a name="l00255"></a>00255          <span class="comment">// Contains stray %, make sure to re-encode!</span>
<a name="l00256"></a>00256          bReencode = <span class="keyword">true</span>;
<a name="l00257"></a>00257       }
<a name="l00258"></a>00258       <span class="keywordflow">else</span>
<a name="l00259"></a>00259       {
<a name="l00260"></a>00260          <span class="comment">// Valid %xx sequence</span>
<a name="l00261"></a>00261          character = a * 16 + b; <span class="comment">// Replace with value of %dd</span>
<a name="l00262"></a>00262          <span class="keywordflow">if</span> (!isRawURI &amp;&amp; !character &amp;&amp; updateDecoded)
<a name="l00263"></a>00263             <span class="keywordflow">break</span>; <span class="comment">// Stop at %00</span>
<a name="l00264"></a>00264 
<a name="l00265"></a>00265          new_usegment [ new_length2++ ] = (<span class="keywordtype">unsigned</span> char) csegment[i++];
<a name="l00266"></a>00266          new_usegment [ new_length2++ ] = (<span class="keywordtype">unsigned</span> char) csegment[i++];
<a name="l00267"></a>00267       }
<a name="l00268"></a>00268     }
<a name="l00269"></a>00269     <span class="keywordflow">if</span> (bReencode)
<a name="l00270"></a>00270     {
<a name="l00271"></a>00271       new_length2--;
<a name="l00272"></a>00272       new_usegment [ new_length2++ ] = <span class="charliteral">&#39;%&#39;</span>;
<a name="l00273"></a>00273 
<a name="l00274"></a>00274       <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> c = character / 16;
<a name="l00275"></a>00275       c += (c &gt; 9) ? (<span class="charliteral">&#39;A&#39;</span> - 10) : <span class="charliteral">&#39;0&#39;</span>;
<a name="l00276"></a>00276       new_usegment[ new_length2++ ] = c;
<a name="l00277"></a>00277 
<a name="l00278"></a>00278       c = character % 16;
<a name="l00279"></a>00279       c += (c &gt; 9) ? (<span class="charliteral">&#39;A&#39;</span> - 10) : <span class="charliteral">&#39;0&#39;</span>;
<a name="l00280"></a>00280       new_usegment[ new_length2++ ] = c;
<a name="l00281"></a>00281     }
<a name="l00282"></a>00282 
<a name="l00283"></a>00283     new_segment [ new_length++ ] = character;
<a name="l00284"></a>00284   }
<a name="l00285"></a>00285   new_segment [ new_length ] = 0;
<a name="l00286"></a>00286 
<a name="l00287"></a>00287   encoded = <a class="codeRef" href="qstring.html">QString</a>( new_usegment, new_length2);
<a name="l00288"></a>00288 
<a name="l00289"></a>00289   <span class="comment">// Encoding specified</span>
<a name="l00290"></a>00290   <span class="keywordflow">if</span> (updateDecoded)
<a name="l00291"></a>00291   {
<a name="l00292"></a>00292      decoded = textCodec-&gt;<a class="codeRef" href="qtextcodec.html#toUnicode">toUnicode</a>( new_segment );
<a name="l00293"></a>00293      <span class="keywordflow">if</span> ( isRawURI ) {
<a name="l00294"></a>00294         <span class="keywordtype">int</span> length = qstrlen( new_segment );
<a name="l00295"></a>00295         <span class="keywordflow">while</span> ( length &lt; new_length ) {
<a name="l00296"></a>00296             decoded += QChar::null;
<a name="l00297"></a>00297             length += 1;
<a name="l00298"></a>00298             decoded += textCodec-&gt;<a class="codeRef" href="qtextcodec.html#toUnicode">toUnicode</a>( new_segment + length );
<a name="l00299"></a>00299             length += qstrlen( new_segment + length );
<a name="l00300"></a>00300         }
<a name="l00301"></a>00301      }
<a name="l00302"></a>00302 
<a name="l00303"></a>00303      <a class="codeRef" href="qcstring.html">QCString</a> validate = textCodec-&gt;<a class="codeRef" href="qtextcodec.html#fromUnicode">fromUnicode</a>(decoded);
<a name="l00304"></a>00304 
<a name="l00305"></a>00305      <span class="keywordflow">if</span> (strcmp(validate.data(), new_segment) != 0)
<a name="l00306"></a>00306      {
<a name="l00307"></a>00307         decoded = <a class="codeRef" href="qstring.html#fromLocal8Bit">QString::fromLocal8Bit</a>(new_segment, new_length);
<a name="l00308"></a>00308      }
<a name="l00309"></a>00309   }
<a name="l00310"></a>00310 
<a name="l00311"></a>00311   <span class="keyword">delete</span> [] new_segment;
<a name="l00312"></a>00312   <span class="keyword">delete</span> [] new_usegment;
<a name="l00313"></a>00313 }
<a name="l00314"></a>00314 
<a name="l00315"></a>00315 <span class="keyword">static</span> <a class="codeRef" href="qstring.html">QString</a> decode(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;segment, <span class="keywordtype">int</span> encoding_hint = 0, <span class="keywordtype">bool</span> isRawURI = <span class="keyword">false</span>)
<a name="l00316"></a>00316 {
<a name="l00317"></a>00317   <a class="codeRef" href="qstring.html">QString</a> result;
<a name="l00318"></a>00318   <a class="codeRef" href="qstring.html">QString</a> tmp;
<a name="l00319"></a>00319   decode(segment, result, tmp, encoding_hint, <span class="keyword">true</span>, isRawURI);
<a name="l00320"></a>00320   <span class="keywordflow">return</span> result;
<a name="l00321"></a>00321 }
<a name="l00322"></a>00322 
<a name="l00323"></a>00323 <span class="keyword">static</span> <a class="codeRef" href="qstring.html">QString</a> cleanpath(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;_path, <span class="keywordtype">bool</span> cleanDirSeparator, <span class="keywordtype">bool</span> decodeDots)
<a name="l00324"></a>00324 {
<a name="l00325"></a>00325   <span class="keywordflow">if</span> (_path.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>()) <span class="keywordflow">return</span> QString::null;
<a name="l00326"></a>00326 
<a name="l00327"></a>00327   <span class="keywordflow">if</span> (<a class="codeRef" href="qdir.html#isRelativePath">QDir::isRelativePath</a>(_path))
<a name="l00328"></a>00328      <span class="keywordflow">return</span> _path; <span class="comment">// Don&#39;t mangle mailto-style URLs</span>
<a name="l00329"></a>00329 
<a name="l00330"></a>00330   <a class="codeRef" href="qstring.html">QString</a> path = _path;
<a name="l00331"></a>00331 
<a name="l00332"></a>00332   <span class="keywordtype">int</span> len = path.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00333"></a>00333 
<a name="l00334"></a>00334   <span class="keywordflow">if</span> (decodeDots)
<a name="l00335"></a>00335   {
<a name="l00336"></a>00336 <span class="preprocessor">#ifndef KDE_QT_ONLY</span>
<a name="l00337"></a>00337 <span class="preprocessor"></span>     <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;encodedDot = <a class="code" href="classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb" title="Creates a static QString.">KGlobal::staticQString</a>(<span class="stringliteral">&quot;%2e&quot;</span>);
<a name="l00338"></a>00338 <span class="preprocessor">#else</span>
<a name="l00339"></a>00339 <span class="preprocessor"></span>     <a class="codeRef" href="qstring.html">QString</a> encodedDot(<span class="stringliteral">&quot;%2e&quot;</span>);
<a name="l00340"></a>00340 <span class="preprocessor">#endif</span>
<a name="l00341"></a>00341 <span class="preprocessor"></span>     <span class="keywordflow">if</span> (path.<a class="codeRef" href="qstring.html#find">find</a>(encodedDot, 0, <span class="keyword">false</span>) != -1)
<a name="l00342"></a>00342      {
<a name="l00343"></a>00343 <span class="preprocessor">#ifndef KDE_QT_ONLY</span>
<a name="l00344"></a>00344 <span class="preprocessor"></span>        <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;encodedDOT = <a class="code" href="classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb" title="Creates a static QString.">KGlobal::staticQString</a>(<span class="stringliteral">&quot;%2E&quot;</span>); <span class="comment">// Uppercase!</span>
<a name="l00345"></a>00345 <span class="preprocessor">#else</span>
<a name="l00346"></a>00346 <span class="preprocessor"></span>        <a class="codeRef" href="qstring.html">QString</a> encodedDOT(<span class="stringliteral">&quot;%2E&quot;</span>);
<a name="l00347"></a>00347 <span class="preprocessor">#endif</span>
<a name="l00348"></a>00348 <span class="preprocessor"></span>        path.<a class="codeRef" href="qstring.html#replace">replace</a>(encodedDot, <span class="stringliteral">&quot;.&quot;</span>);
<a name="l00349"></a>00349         path.<a class="codeRef" href="qstring.html#replace">replace</a>(encodedDOT, <span class="stringliteral">&quot;.&quot;</span>);
<a name="l00350"></a>00350         len = path.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00351"></a>00351      }
<a name="l00352"></a>00352   }
<a name="l00353"></a>00353 
<a name="l00354"></a>00354   <span class="keywordtype">bool</span> slash = (len &amp;&amp; path[len-1] == <span class="charliteral">&#39;/&#39;</span>) ||
<a name="l00355"></a>00355                (len &gt; 1 &amp;&amp; path[len-2] == <span class="charliteral">&#39;/&#39;</span> &amp;&amp; path[len-1] == <span class="charliteral">&#39;.&#39;</span>);
<a name="l00356"></a>00356 
<a name="l00357"></a>00357   <span class="comment">// The following code cleans up directory path much like</span>
<a name="l00358"></a>00358   <span class="comment">// QDir::cleanDirPath() except it can be made to ignore multiple</span>
<a name="l00359"></a>00359   <span class="comment">// directory separators by setting the flag to false.  That fixes</span>
<a name="l00360"></a>00360   <span class="comment">// bug# 15044, mail.altavista.com and other similar brain-dead server</span>
<a name="l00361"></a>00361   <span class="comment">// implementations that do not follow what has been specified in</span>
<a name="l00362"></a>00362   <span class="comment">// RFC 2396!! (dA)</span>
<a name="l00363"></a>00363   <a class="codeRef" href="qstring.html">QString</a> result;
<a name="l00364"></a>00364   <span class="keywordtype">int</span> cdUp, orig_pos, pos;
<a name="l00365"></a>00365 
<a name="l00366"></a>00366   cdUp = 0;
<a name="l00367"></a>00367   pos = orig_pos = len;
<a name="l00368"></a>00368   <span class="keywordflow">while</span> ( pos &amp;&amp; (pos = path.findRev(<span class="charliteral">&#39;/&#39;</span>,--pos)) != -1 )
<a name="l00369"></a>00369   {
<a name="l00370"></a>00370     len = orig_pos - pos - 1;
<a name="l00371"></a>00371     <span class="keywordflow">if</span> ( len == 2 &amp;&amp; path[pos+1] == <span class="charliteral">&#39;.&#39;</span> &amp;&amp; path[pos+2] == <span class="charliteral">&#39;.&#39;</span> )
<a name="l00372"></a>00372       cdUp++;
<a name="l00373"></a>00373     <span class="keywordflow">else</span>
<a name="l00374"></a>00374     {
<a name="l00375"></a>00375       <span class="comment">// Ignore any occurrences of &#39;.&#39;</span>
<a name="l00376"></a>00376       <span class="comment">// This includes entries that simply do not make sense like /..../</span>
<a name="l00377"></a>00377       <span class="keywordflow">if</span> ( (len || !cleanDirSeparator) &amp;&amp;
<a name="l00378"></a>00378            (len != 1 || path[pos+1] != <span class="charliteral">&#39;.&#39;</span> ) )
<a name="l00379"></a>00379       {
<a name="l00380"></a>00380           <span class="keywordflow">if</span> ( !cdUp )
<a name="l00381"></a>00381               result.<a class="codeRef" href="qstring.html#prepend">prepend</a>(path.mid(pos, len+1));
<a name="l00382"></a>00382           <span class="keywordflow">else</span>
<a name="l00383"></a>00383               cdUp--;
<a name="l00384"></a>00384       }
<a name="l00385"></a>00385     }
<a name="l00386"></a>00386     orig_pos = pos;
<a name="l00387"></a>00387   }
<a name="l00388"></a>00388 
<a name="l00389"></a>00389 <span class="preprocessor">#ifdef Q_WS_WIN // prepend drive letter if exists (js)</span>
<a name="l00390"></a>00390 <span class="preprocessor"></span>  <span class="keywordflow">if</span> (orig_pos &gt;= 2 &amp;&amp; isalpha(path[0].latin1()) &amp;&amp; path[1]==<span class="charliteral">&#39;:&#39;</span>) {
<a name="l00391"></a>00391     result.<a class="codeRef" href="qstring.html#prepend">prepend</a>(<a class="codeRef" href="qstring.html">QString</a>(path[0])+<span class="stringliteral">&quot;:&quot;</span>);
<a name="l00392"></a>00392   }
<a name="l00393"></a>00393 <span class="preprocessor">#endif</span>
<a name="l00394"></a>00394 <span class="preprocessor"></span>
<a name="l00395"></a>00395   <span class="keywordflow">if</span> ( result.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00396"></a>00396     result = KURL_ROOTDIR_PATH;
<a name="l00397"></a>00397   <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( slash &amp;&amp; result[result.<a class="codeRef" href="qstring.html#length">length</a>()-1] != <span class="charliteral">&#39;/&#39;</span> )
<a name="l00398"></a>00398        result.<a class="codeRef" href="qstring.html#append">append</a>(<span class="charliteral">&#39;/&#39;</span>);
<a name="l00399"></a>00399 
<a name="l00400"></a>00400   <span class="keywordflow">return</span> result;
<a name="l00401"></a>00401 }
<a name="l00402"></a>00402 
<a name="l00403"></a><a class="code" href="classKURL.html#aa45474b065df2aa16142dc77500d6971">00403</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#aa45474b065df2aa16142dc77500d6971" title="Tests if a given URL is a relative as opposed to an absolute URL.">KURL::isRelativeURL</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;_url)
<a name="l00404"></a>00404 {
<a name="l00405"></a>00405   <span class="keywordtype">int</span> len = _url.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00406"></a>00406   <span class="keywordflow">if</span> (!len) <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// Very short relative URL.</span>
<a name="l00407"></a>00407   <span class="keyword">const</span> <a class="codeRef" href="qchar.html">QChar</a> *str = _url.<a class="codeRef" href="qstring.html#unicode">unicode</a>();
<a name="l00408"></a>00408 
<a name="l00409"></a>00409   <span class="comment">// Absolute URL must start with alpha-character</span>
<a name="l00410"></a>00410   <span class="keywordflow">if</span> (!isalpha(str[0].latin1()))
<a name="l00411"></a>00411      <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// Relative URL</span>
<a name="l00412"></a>00412 
<a name="l00413"></a>00413   <span class="keywordflow">for</span>(<span class="keywordtype">int</span> i = 1; i &lt; len; i++)
<a name="l00414"></a>00414   {
<a name="l00415"></a>00415      <span class="keywordtype">char</span> c = str[i].<a class="codeRef" href="qchar.html#latin1">latin1</a>(); <span class="comment">// Note: non-latin1 chars return 0!</span>
<a name="l00416"></a>00416      <span class="keywordflow">if</span> (c == <span class="charliteral">&#39;:&#39;</span>)
<a name="l00417"></a>00417         <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// Absolute URL</span>
<a name="l00418"></a>00418 
<a name="l00419"></a>00419      <span class="comment">// Protocol part may only contain alpha, digit, + or -</span>
<a name="l00420"></a>00420      <span class="keywordflow">if</span> (!isalpha(c) &amp;&amp; !isdigit(c) &amp;&amp; (c != <span class="charliteral">&#39;+&#39;</span>) &amp;&amp; (c != <span class="charliteral">&#39;-&#39;</span>))
<a name="l00421"></a>00421         <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// Relative URL</span>
<a name="l00422"></a>00422   }
<a name="l00423"></a>00423   <span class="comment">// URL did not contain &#39;:&#39;</span>
<a name="l00424"></a>00424   <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// Relative URL</span>
<a name="l00425"></a>00425 }
<a name="l00426"></a>00426 
<a name="l00427"></a><a class="code" href="classKURL_1_1List.html#ac44f5d8950a69d002da2b21fe6e55b17">00427</a> <a class="code" href="classKURL_1_1List.html#a40dc089502acc88196731fd97852ce80" title="Creates an empty List.">KURL::List::List</a>(<span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> &amp;url)
<a name="l00428"></a>00428 {
<a name="l00429"></a>00429     <a class="codeRef" href="qvaluelist.html#append">append</a>( url );
<a name="l00430"></a>00430 }
<a name="l00431"></a>00431 
<a name="l00432"></a><a class="code" href="classKURL_1_1List.html#a3561ea9201ba5e86cea868f1b6ca6099">00432</a> <a class="code" href="classKURL_1_1List.html#a40dc089502acc88196731fd97852ce80" title="Creates an empty List.">KURL::List::List</a>(<span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a> &amp;list)
<a name="l00433"></a>00433 {
<a name="l00434"></a>00434   <span class="keywordflow">for</span> (QStringList::ConstIterator it = list.begin();
<a name="l00435"></a>00435        it != list.end();
<a name="l00436"></a>00436        it++)
<a name="l00437"></a>00437     {
<a name="l00438"></a>00438       append( <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL</a>(*it) );
<a name="l00439"></a>00439     }
<a name="l00440"></a>00440 }
<a name="l00441"></a>00441 
<a name="l00442"></a><a class="code" href="classKURL_1_1List.html#a691f3ac6a1d05ecbec0a49633d0cfd17">00442</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKURL_1_1List.html#a691f3ac6a1d05ecbec0a49633d0cfd17" title="Converts the URLs of this list to a list of strings.">KURL::List::toStringList</a>()<span class="keyword"> const</span>
<a name="l00443"></a>00443 <span class="keyword"></span>{
<a name="l00444"></a>00444   <a class="codeRef" href="qstringlist.html">QStringList</a> lst;
<a name="l00445"></a>00445    <span class="keywordflow">for</span>( <a class="codeRef" href="qvaluelist.html#ConstIterator">KURL::List::ConstIterator</a> it = begin();
<a name="l00446"></a>00446         it != end();
<a name="l00447"></a>00447         it++)
<a name="l00448"></a>00448    {
<a name="l00449"></a>00449       lst.append( (*it).url() );
<a name="l00450"></a>00450    }
<a name="l00451"></a>00451    <span class="keywordflow">return</span> lst;
<a name="l00452"></a>00452 }
<a name="l00453"></a>00453 
<a name="l00454"></a>00454 
<a name="l00455"></a><a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9">00455</a> <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL::KURL</a>()
<a name="l00456"></a>00456 {
<a name="l00457"></a>00457   <a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536" title="Resets the members to their &quot;null&quot; state.">reset</a>();
<a name="l00458"></a>00458 }
<a name="l00459"></a>00459 
<a name="l00460"></a><a class="code" href="classKURL.html#a6892da49ac63d19458bf27eb0736ed9c">00460</a> <a class="code" href="classKURL.html#a6892da49ac63d19458bf27eb0736ed9c" title="Destructs the KURL object.">KURL::~KURL</a>()
<a name="l00461"></a>00461 {
<a name="l00462"></a>00462 }
<a name="l00463"></a>00463 
<a name="l00464"></a>00464 
<a name="l00465"></a><a class="code" href="classKURL.html#a78d5d0d9c4e19289b7ff74f988538cc7">00465</a> <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL::KURL</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;<a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>, <span class="keywordtype">int</span> encoding_hint )
<a name="l00466"></a>00466 {
<a name="l00467"></a>00467   <a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536" title="Resets the members to their &quot;null&quot; state.">reset</a>();
<a name="l00468"></a>00468   <a class="code" href="classKURL.html#ab3e311c1974098c707b94e7b7eb2ec74" title="Parses the given string and fills the URL&#39;s values on success.">parse</a>( url, encoding_hint );
<a name="l00469"></a>00469 }
<a name="l00470"></a>00470 
<a name="l00471"></a><a class="code" href="classKURL.html#adbc4e9b6cb078e26e5b220b1fe9b3cfa">00471</a> <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL::KURL</a>( <span class="keyword">const</span> <span class="keywordtype">char</span> * <a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>, <span class="keywordtype">int</span> encoding_hint )
<a name="l00472"></a>00472 {
<a name="l00473"></a>00473   <a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536" title="Resets the members to their &quot;null&quot; state.">reset</a>();
<a name="l00474"></a>00474   <a class="code" href="classKURL.html#ab3e311c1974098c707b94e7b7eb2ec74" title="Parses the given string and fills the URL&#39;s values on success.">parse</a>( <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>(url), encoding_hint );
<a name="l00475"></a>00475 }
<a name="l00476"></a>00476 
<a name="l00477"></a><a class="code" href="classKURL.html#a3db6e118ac41e55600e9bbad86825b21">00477</a> <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL::KURL</a>( <span class="keyword">const</span> <a class="codeRef" href="qcstring.html">QCString</a>&amp; <a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>, <span class="keywordtype">int</span> encoding_hint )
<a name="l00478"></a>00478 {
<a name="l00479"></a>00479   <a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536" title="Resets the members to their &quot;null&quot; state.">reset</a>();
<a name="l00480"></a>00480   <a class="code" href="classKURL.html#ab3e311c1974098c707b94e7b7eb2ec74" title="Parses the given string and fills the URL&#39;s values on success.">parse</a>( <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>(url), encoding_hint );
<a name="l00481"></a>00481 }
<a name="l00482"></a>00482 
<a name="l00483"></a><a class="code" href="classKURL.html#a5c8f93cc2fe4e6fcad9e431d4c78da70">00483</a> <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL::KURL</a>( <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; _u )
<a name="l00484"></a>00484 {
<a name="l00485"></a>00485   *<span class="keyword">this</span> = _u;
<a name="l00486"></a>00486 }
<a name="l00487"></a>00487 
<a name="l00488"></a>00488 <a class="codeRef" href="qdatastream.html">QDataStream</a> &amp; operator&lt;&lt; (<a class="codeRef" href="qdatastream.html">QDataStream</a> &amp; s, <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> &amp; a)
<a name="l00489"></a>00489 {
<a name="l00490"></a>00490   <a class="codeRef" href="qstring.html">QString</a> QueryForWire=a.m_strQuery_encoded;
<a name="l00491"></a>00491   <span class="keywordflow">if</span> (!a.m_strQuery_encoded.<a class="codeRef" href="qstring.html#isNull">isNull</a>())
<a name="l00492"></a>00492     QueryForWire.<a class="codeRef" href="qstring.html#prepend">prepend</a>(<span class="stringliteral">&quot;?&quot;</span>);
<a name="l00493"></a>00493 
<a name="l00494"></a>00494     s &lt;&lt; a.m_strProtocol &lt;&lt; a.m_strUser &lt;&lt; a.m_strPass &lt;&lt; a.m_strHost
<a name="l00495"></a>00495       &lt;&lt; a.m_strPath &lt;&lt; a.m_strPath_encoded &lt;&lt; QueryForWire &lt;&lt; a.m_strRef_encoded
<a name="l00496"></a>00496       &lt;&lt; Q_INT8(a.m_bIsMalformed ? 1 : 0) &lt;&lt; a.m_iPort;
<a name="l00497"></a>00497     <span class="keywordflow">return</span> s;
<a name="l00498"></a>00498 }
<a name="l00499"></a>00499 
<a name="l00500"></a>00500 <a class="codeRef" href="qdatastream.html">QDataStream</a> &amp; operator&gt;&gt; (<a class="codeRef" href="qdatastream.html">QDataStream</a> &amp; s, <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> &amp; a)
<a name="l00501"></a>00501 {
<a name="l00502"></a>00502     Q_INT8 malf;
<a name="l00503"></a>00503     <a class="codeRef" href="qstring.html">QString</a> QueryFromWire;
<a name="l00504"></a>00504     s &gt;&gt; a.m_strProtocol &gt;&gt; a.m_strUser &gt;&gt; a.m_strPass &gt;&gt; a.m_strHost
<a name="l00505"></a>00505       &gt;&gt; a.m_strPath &gt;&gt; a.m_strPath_encoded &gt;&gt; QueryFromWire &gt;&gt; a.m_strRef_encoded
<a name="l00506"></a>00506       &gt;&gt; malf &gt;&gt; a.m_iPort;
<a name="l00507"></a>00507     a.m_bIsMalformed = (malf != 0);
<a name="l00508"></a>00508 
<a name="l00509"></a>00509     <span class="keywordflow">if</span> ( QueryFromWire.<a class="codeRef" href="qstring.html#isNull">isNull</a>() )
<a name="l00510"></a>00510       a.m_strQuery_encoded = QString::null;
<a name="l00511"></a>00511     <span class="keywordflow">else</span> if ( QueryFromWire.<a class="codeRef" href="qstring.html#length">length</a>() == 1 ) <span class="comment">// empty query</span>
<a name="l00512"></a>00512       a.m_strQuery_encoded = <span class="stringliteral">&quot;&quot;</span>;
<a name="l00513"></a>00513     <span class="keywordflow">else</span>
<a name="l00514"></a>00514       a.m_strQuery_encoded = QueryFromWire.<a class="codeRef" href="qstring.html#mid">mid</a>(1);
<a name="l00515"></a>00515 
<a name="l00516"></a>00516     a.m_iUriMode = <a class="code" href="classKURL.html#ad400be8a7ea5af29184581da39abe7ce" title="Determines which URI mode is suitable for processing URIs of a given protocol.">KURL::uriModeForProtocol</a>( a.m_strProtocol );
<a name="l00517"></a>00517 
<a name="l00518"></a>00518     <span class="keywordflow">return</span> s;
<a name="l00519"></a>00519 }
<a name="l00520"></a>00520 
<a name="l00521"></a>00521 <span class="preprocessor">#ifndef QT_NO_NETWORKPROTOCOL</span>
<a name="l00522"></a><a class="code" href="classKURL.html#ada858afd3328c262dc57ec6a31934013">00522</a> <span class="preprocessor"></span><a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL::KURL</a>( <span class="keyword">const</span> <a class="codeRef" href="qurl.html">QUrl</a> &amp;u )
<a name="l00523"></a>00523 {
<a name="l00524"></a>00524   *<span class="keyword">this</span> = u;
<a name="l00525"></a>00525 }
<a name="l00526"></a>00526 <span class="preprocessor">#endif</span>
<a name="l00527"></a>00527 <span class="preprocessor"></span>
<a name="l00528"></a><a class="code" href="classKURL.html#a36339dac9244da13dab71911f4a216dd">00528</a> <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL::KURL</a>( <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; _u, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _rel_url, <span class="keywordtype">int</span> encoding_hint )
<a name="l00529"></a>00529 {
<a name="l00530"></a>00530   <span class="keywordflow">if</span> (_u.<a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>()) <span class="comment">// Operate on the last suburl, not the first</span>
<a name="l00531"></a>00531   {
<a name="l00532"></a>00532     <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> lst = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">split</a>( _u );
<a name="l00533"></a>00533     <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> u(lst.<a class="codeRef" href="qvaluelist.html#last">last</a>(), _rel_url, encoding_hint);
<a name="l00534"></a>00534     lst.<a class="codeRef" href="qvaluelist.html#remove">remove</a>( lst.<a class="codeRef" href="qvaluelist.html#last">last</a>() );
<a name="l00535"></a>00535     lst.<a class="codeRef" href="qvaluelist.html#append">append</a>( u );
<a name="l00536"></a>00536     *<span class="keyword">this</span> = <a class="code" href="classKURL.html#a95df01647f7ddf97be8c3ab018fd1f36" title="Joins a list of URLs into a single URL with sub URLs.">join</a>( lst );
<a name="l00537"></a>00537     <span class="keywordflow">return</span>;
<a name="l00538"></a>00538   }
<a name="l00539"></a>00539   <span class="comment">// WORKAROUND THE RFC 1606 LOOPHOLE THAT ALLOWS</span>
<a name="l00540"></a>00540   <span class="comment">// http:/index.html AS A VALID SYNTAX FOR RELATIVE</span>
<a name="l00541"></a>00541   <span class="comment">// URLS. ( RFC 2396 section 5.2 item # 3 )</span>
<a name="l00542"></a>00542   <a class="codeRef" href="qstring.html">QString</a> rUrl = _rel_url;
<a name="l00543"></a>00543   <span class="keywordtype">int</span> len = _u.m_strProtocol.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00544"></a>00544   <span class="keywordflow">if</span> ( !_u.m_strHost.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() &amp;&amp; !rUrl.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() &amp;&amp;
<a name="l00545"></a>00545        rUrl.<a class="codeRef" href="qstring.html#find">find</a>( _u.m_strProtocol, 0, <span class="keyword">false</span> ) == 0 &amp;&amp;
<a name="l00546"></a>00546        rUrl[len] == <span class="charliteral">&#39;:&#39;</span> &amp;&amp; (rUrl[len+1] != <span class="charliteral">&#39;/&#39;</span> ||
<a name="l00547"></a>00547        (rUrl[len+1] == <span class="charliteral">&#39;/&#39;</span> &amp;&amp; rUrl[len+2] != <span class="charliteral">&#39;/&#39;</span>)) )
<a name="l00548"></a>00548   {
<a name="l00549"></a>00549     rUrl.<a class="codeRef" href="qstring.html#remove">remove</a>( 0, rUrl.<a class="codeRef" href="qstring.html#find">find</a>( <span class="charliteral">&#39;:&#39;</span> ) + 1 );
<a name="l00550"></a>00550   }
<a name="l00551"></a>00551 
<a name="l00552"></a>00552   <span class="keywordflow">if</span> ( rUrl.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00553"></a>00553   {
<a name="l00554"></a>00554     *<span class="keyword">this</span> = _u;
<a name="l00555"></a>00555   }
<a name="l00556"></a>00556   <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( rUrl[0] == <span class="charliteral">&#39;#&#39;</span> )
<a name="l00557"></a>00557   {
<a name="l00558"></a>00558     *<span class="keyword">this</span> = _u;
<a name="l00559"></a>00559     m_strRef_encoded = rUrl.<a class="codeRef" href="qstring.html#mid">mid</a>(1);
<a name="l00560"></a>00560     <span class="keywordflow">if</span> ( m_strRef_encoded.<a class="codeRef" href="qstring.html#isNull">isNull</a>() )
<a name="l00561"></a>00561         m_strRef_encoded = <span class="stringliteral">&quot;&quot;</span>; <span class="comment">// we know there was an (empty) html ref, we saw the &#39;#&#39;</span>
<a name="l00562"></a>00562   }
<a name="l00563"></a>00563   <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( <a class="code" href="classKURL.html#aa45474b065df2aa16142dc77500d6971" title="Tests if a given URL is a relative as opposed to an absolute URL.">isRelativeURL</a>( rUrl) )
<a name="l00564"></a>00564   {
<a name="l00565"></a>00565     *<span class="keyword">this</span> = _u;
<a name="l00566"></a>00566     m_strQuery_encoded = QString::null;
<a name="l00567"></a>00567     m_strRef_encoded = QString::null;
<a name="l00568"></a>00568     <span class="keywordflow">if</span> ( rUrl[0] == <span class="charliteral">&#39;/&#39;</span>)
<a name="l00569"></a>00569     {
<a name="l00570"></a>00570         <span class="keywordflow">if</span> ((rUrl.<a class="codeRef" href="qstring.html#length">length</a>() &gt; 1) &amp;&amp; (rUrl[1] == <span class="charliteral">&#39;/&#39;</span>))
<a name="l00571"></a>00571         {
<a name="l00572"></a>00572            m_strHost = QString::null;
<a name="l00573"></a>00573            <span class="comment">// File protocol returns file:/// without host, strip // from rUrl</span>
<a name="l00574"></a>00574            <span class="keywordflow">if</span> (_u.m_strProtocol == fileProt)
<a name="l00575"></a>00575               rUrl.<a class="codeRef" href="qstring.html#remove">remove</a>(0, 2);
<a name="l00576"></a>00576         }
<a name="l00577"></a>00577         m_strPath = QString::null;
<a name="l00578"></a>00578         m_strPath_encoded = QString::null;
<a name="l00579"></a>00579     }
<a name="l00580"></a>00580     <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( rUrl[0] != <span class="charliteral">&#39;?&#39;</span> )
<a name="l00581"></a>00581     {
<a name="l00582"></a>00582        <span class="keywordtype">int</span> pos = m_strPath.<a class="codeRef" href="qstring.html#findRev">findRev</a>( <span class="charliteral">&#39;/&#39;</span> );
<a name="l00583"></a>00583        <span class="keywordflow">if</span> (pos &gt;= 0)
<a name="l00584"></a>00584           m_strPath.<a class="codeRef" href="qstring.html#truncate">truncate</a>(pos);
<a name="l00585"></a>00585        m_strPath += <span class="charliteral">&#39;/&#39;</span>;
<a name="l00586"></a>00586        <span class="keywordflow">if</span> (!m_strPath_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l00587"></a>00587        {
<a name="l00588"></a>00588           pos = m_strPath_encoded.<a class="codeRef" href="qstring.html#findRev">findRev</a>( <span class="charliteral">&#39;/&#39;</span> );
<a name="l00589"></a>00589           <span class="keywordflow">if</span> (pos &gt;= 0)
<a name="l00590"></a>00590              m_strPath_encoded.<a class="codeRef" href="qstring.html#truncate">truncate</a>(pos);
<a name="l00591"></a>00591           m_strPath_encoded += <span class="charliteral">&#39;/&#39;</span>;
<a name="l00592"></a>00592        }
<a name="l00593"></a>00593     }
<a name="l00594"></a>00594     <span class="keywordflow">else</span>
<a name="l00595"></a>00595     {
<a name="l00596"></a>00596        <span class="keywordflow">if</span> ( m_strPath.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00597"></a>00597           m_strPath = <span class="charliteral">&#39;/&#39;</span>;
<a name="l00598"></a>00598     }
<a name="l00599"></a>00599     <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> tmp( <a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>() + rUrl, encoding_hint);
<a name="l00600"></a>00600     *<span class="keyword">this</span> = tmp;
<a name="l00601"></a>00601     <a class="code" href="classKURL.html#aa4f7e51dc176f53f6e25a89195b04477" title="Resolves &quot;.&quot; and &quot;..&quot; components in path.">cleanPath</a>(<span class="keyword">false</span>);
<a name="l00602"></a>00602   }
<a name="l00603"></a>00603   <span class="keywordflow">else</span>
<a name="l00604"></a>00604   {
<a name="l00605"></a>00605     <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> tmp( rUrl, encoding_hint);
<a name="l00606"></a>00606     *<span class="keyword">this</span> = tmp;
<a name="l00607"></a>00607     <span class="comment">// Preserve userinfo if applicable.</span>
<a name="l00608"></a>00608     <span class="keywordflow">if</span> (!_u.m_strUser.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() &amp;&amp; m_strUser.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() &amp;&amp; (_u.m_strHost == m_strHost) &amp;&amp; (_u.m_strProtocol == m_strProtocol))
<a name="l00609"></a>00609     {
<a name="l00610"></a>00610        m_strUser = _u.m_strUser;
<a name="l00611"></a>00611        m_strPass = _u.m_strPass;
<a name="l00612"></a>00612     }
<a name="l00613"></a>00613     <a class="code" href="classKURL.html#aa4f7e51dc176f53f6e25a89195b04477" title="Resolves &quot;.&quot; and &quot;..&quot; components in path.">cleanPath</a>(<span class="keyword">false</span>);
<a name="l00614"></a>00614   }
<a name="l00615"></a>00615 }
<a name="l00616"></a>00616 
<a name="l00617"></a><a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536">00617</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536" title="Resets the members to their &quot;null&quot; state.">KURL::reset</a>()
<a name="l00618"></a>00618 {
<a name="l00619"></a>00619   m_strProtocol = QString::null;
<a name="l00620"></a>00620   m_strUser = QString::null;
<a name="l00621"></a>00621   m_strPass = QString::null;
<a name="l00622"></a>00622   m_strHost = QString::null;
<a name="l00623"></a>00623   m_strPath = QString::null;
<a name="l00624"></a>00624   m_strPath_encoded = QString::null;
<a name="l00625"></a>00625   m_strQuery_encoded = QString::null;
<a name="l00626"></a>00626   m_strRef_encoded = QString::null;
<a name="l00627"></a>00627   m_bIsMalformed = <span class="keyword">true</span>;
<a name="l00628"></a>00628   m_iPort = 0;
<a name="l00629"></a>00629   m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a9db85130d0702a27e41777d7c767acca" title="Automatically detected.">Auto</a>;
<a name="l00630"></a>00630 }
<a name="l00631"></a>00631 
<a name="l00632"></a><a class="code" href="classKURL.html#af10f805c72d7223d88d7499fc5f39bd2">00632</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#af10f805c72d7223d88d7499fc5f39bd2" title="Tests if the KURL is empty.">KURL::isEmpty</a>()<span class="keyword"> const</span>
<a name="l00633"></a>00633 <span class="keyword"></span>{
<a name="l00634"></a>00634   <span class="keywordflow">return</span> (m_strPath.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() &amp;&amp; m_strProtocol.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>());
<a name="l00635"></a>00635 }
<a name="l00636"></a>00636 
<a name="l00637"></a><a class="code" href="classKURL.html#ab3e311c1974098c707b94e7b7eb2ec74">00637</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#ab3e311c1974098c707b94e7b7eb2ec74" title="Parses the given string and fills the URL&#39;s values on success.">KURL::parse</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _url, <span class="keywordtype">int</span> encoding_hint )
<a name="l00638"></a>00638 {
<a name="l00639"></a>00639     <span class="keywordflow">if</span> ( _url.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a48dc1cda1b16403f9ba112a8d035e5e7" title="Invalid URI.">Invalid</a> )
<a name="l00640"></a>00640     {
<a name="l00641"></a>00641     m_strProtocol = _url;
<a name="l00642"></a>00642     m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a48dc1cda1b16403f9ba112a8d035e5e7" title="Invalid URI.">Invalid</a>;
<a name="l00643"></a>00643     <span class="keywordflow">return</span>;
<a name="l00644"></a>00644     }
<a name="l00645"></a>00645 
<a name="l00646"></a>00646     <span class="keyword">const</span> <a class="codeRef" href="qchar.html">QChar</a>* buf = _url.<a class="codeRef" href="qstring.html#unicode">unicode</a>();
<a name="l00647"></a>00647     <span class="keyword">const</span> <a class="codeRef" href="qchar.html">QChar</a>* orig = buf;
<a name="l00648"></a>00648     uint len = _url.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00649"></a>00649     uint pos = 0;
<a name="l00650"></a>00650 
<a name="l00651"></a>00651     <span class="comment">// Node 1: Accept alpha or slash</span>
<a name="l00652"></a>00652     <a class="codeRef" href="qchar.html">QChar</a> x = buf[pos++];
<a name="l00653"></a>00653 <span class="preprocessor">#ifdef Q_WS_WIN</span>
<a name="l00654"></a>00654 <span class="preprocessor"></span>    <span class="comment">/* win32: accept &lt;letter&gt;: or &lt;letter&gt;:/ or &lt;letter&gt;:\ */</span>
<a name="l00655"></a>00655     <span class="keyword">const</span> <span class="keywordtype">bool</span> alpha = isalpha((<span class="keywordtype">int</span>)x);
<a name="l00656"></a>00656     <span class="keywordflow">if</span> (alpha &amp;&amp; len&lt;2)
<a name="l00657"></a>00657         <span class="keywordflow">goto</span> NodeErr;
<a name="l00658"></a>00658     <span class="keywordflow">if</span> (alpha &amp;&amp; buf[pos]==<span class="charliteral">&#39;:&#39;</span> &amp;&amp; (len==2 || (len&gt;2 &amp;&amp; (buf[pos+1]==<span class="charliteral">&#39;/&#39;</span> || buf[pos+1]==<span class="charliteral">&#39;\\&#39;</span>))))
<a name="l00659"></a>00659 <span class="preprocessor">#else</span>
<a name="l00660"></a>00660 <span class="preprocessor"></span>    <span class="keywordflow">if</span> ( x == <span class="charliteral">&#39;/&#39;</span> )
<a name="l00661"></a>00661 <span class="preprocessor">#endif</span>
<a name="l00662"></a>00662 <span class="preprocessor"></span>    {
<a name="l00663"></a>00663     <span class="comment">// A slash means we immediately proceed to parse it as a file URL.</span>
<a name="l00664"></a>00664     m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a>;
<a name="l00665"></a>00665     m_strProtocol = fileProt;
<a name="l00666"></a>00666     <a class="code" href="classKURL.html#a1005b451c6beee15b87bfe498b2e1f90" title="Parses the given string and fills the URL&#39;s values on success.">parseURL</a>( _url, encoding_hint );
<a name="l00667"></a>00667     <span class="keywordflow">return</span>;
<a name="l00668"></a>00668     }
<a name="l00669"></a>00669     <span class="keywordflow">if</span> ( !isalpha( (<span class="keywordtype">int</span>)x ) )
<a name="l00670"></a>00670     <span class="keywordflow">goto</span> NodeErr;
<a name="l00671"></a>00671 
<a name="l00672"></a>00672     <span class="comment">// Node 2: Accept any amount of (alpha|digit|&#39;+&#39;|&#39;-&#39;)</span>
<a name="l00673"></a>00673     <span class="comment">// &#39;.&#39; is not currently accepted, because current KURL may be confused.</span>
<a name="l00674"></a>00674     <span class="comment">// Proceed with :// :/ or :</span>
<a name="l00675"></a>00675     <span class="keywordflow">while</span>( pos &lt; len &amp;&amp; (isalpha((<span class="keywordtype">int</span>)buf[pos]) || isdigit((<span class="keywordtype">int</span>)buf[pos]) ||
<a name="l00676"></a>00676              buf[pos] == <span class="charliteral">&#39;+&#39;</span> || buf[pos] == <span class="charliteral">&#39;-&#39;</span>)) pos++;
<a name="l00677"></a>00677 
<a name="l00678"></a>00678     <span class="keywordflow">if</span> (pos &lt; len &amp;&amp; buf[pos] == <span class="charliteral">&#39;:&#39;</span> )
<a name="l00679"></a>00679     {
<a name="l00680"></a>00680     m_strProtocol = <a class="codeRef" href="qstring.html">QString</a>( orig, pos ).<a class="codeRef" href="qstring.html#lower">lower</a>();
<a name="l00681"></a>00681     <span class="keywordflow">if</span> ( m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a9db85130d0702a27e41777d7c767acca" title="Automatically detected.">Auto</a> )
<a name="l00682"></a>00682         m_iUriMode = <a class="code" href="classKURL.html#ad400be8a7ea5af29184581da39abe7ce" title="Determines which URI mode is suitable for processing URIs of a given protocol.">uriModeForProtocol</a>( m_strProtocol );
<a name="l00683"></a>00683     <span class="comment">// Proceed to correct parse function.</span>
<a name="l00684"></a>00684     <span class="keywordflow">switch</span> ( m_iUriMode )
<a name="l00685"></a>00685     {
<a name="l00686"></a>00686     <span class="keywordflow">case</span> <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25ae1438b681934016b65507c804f933c30" title="Raw URI.">RawURI</a>:
<a name="l00687"></a>00687         <a class="code" href="classKURL.html#a4429a776e21ea5a2112c1dad318a8d15" title="Parses the given string and fills the URL&#39;s values on success.">parseRawURI</a>( _url );
<a name="l00688"></a>00688         <span class="keywordflow">return</span>;
<a name="l00689"></a>00689     <span class="keywordflow">case</span> <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25add1a21fcdf4c90f451c256191553c6f7" title="Mailto URI.">Mailto</a>:
<a name="l00690"></a>00690         <a class="code" href="classKURL.html#a9266785d84b7b41c78b1336592198a86" title="Parses the given string and fills the URL&#39;s values on success.">parseMailto</a>( _url );
<a name="l00691"></a>00691         <span class="keywordflow">return</span>;
<a name="l00692"></a>00692     <span class="keywordflow">case</span> <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a>:
<a name="l00693"></a>00693         <a class="code" href="classKURL.html#a1005b451c6beee15b87bfe498b2e1f90" title="Parses the given string and fills the URL&#39;s values on success.">parseURL</a>( _url, encoding_hint );
<a name="l00694"></a>00694         <span class="keywordflow">return</span>;
<a name="l00695"></a>00695     <span class="keywordflow">default</span>:
<a name="l00696"></a>00696         <span class="comment">// Unknown URI mode results in an invalid URI.</span>
<a name="l00697"></a>00697         <span class="keywordflow">break</span>;
<a name="l00698"></a>00698     }
<a name="l00699"></a>00699     }
<a name="l00700"></a>00700 
<a name="l00701"></a>00701 NodeErr:
<a name="l00702"></a>00702     <a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536" title="Resets the members to their &quot;null&quot; state.">reset</a>();
<a name="l00703"></a>00703     m_strProtocol = _url;
<a name="l00704"></a>00704     m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a48dc1cda1b16403f9ba112a8d035e5e7" title="Invalid URI.">Invalid</a>;
<a name="l00705"></a>00705 }
<a name="l00706"></a>00706 
<a name="l00707"></a><a class="code" href="classKURL.html#a4429a776e21ea5a2112c1dad318a8d15">00707</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a4429a776e21ea5a2112c1dad318a8d15" title="Parses the given string and fills the URL&#39;s values on success.">KURL::parseRawURI</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _url, <span class="keywordtype">int</span> encoding_hint )
<a name="l00708"></a>00708 {
<a name="l00709"></a>00709     uint len = _url.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00710"></a>00710     <span class="keyword">const</span> <a class="codeRef" href="qchar.html">QChar</a>* buf = _url.<a class="codeRef" href="qstring.html#unicode">unicode</a>();
<a name="l00711"></a>00711 
<a name="l00712"></a>00712     uint pos = 0;
<a name="l00713"></a>00713 
<a name="l00714"></a>00714     <span class="comment">// Accept any amount of (alpha|digit|&#39;+&#39;|&#39;-&#39;)</span>
<a name="l00715"></a>00715     <span class="comment">// &#39;.&#39; is not currently accepted, because current KURL may be confused.</span>
<a name="l00716"></a>00716     <span class="comment">// Proceed with :</span>
<a name="l00717"></a>00717     <span class="keywordflow">while</span>( pos &lt; len &amp;&amp; (isalpha((<span class="keywordtype">int</span>)buf[pos]) || isdigit((<span class="keywordtype">int</span>)buf[pos]) ||
<a name="l00718"></a>00718              buf[pos] == <span class="charliteral">&#39;+&#39;</span> || buf[pos] == <span class="charliteral">&#39;-&#39;</span>)) pos++;
<a name="l00719"></a>00719 
<a name="l00720"></a>00720     <span class="comment">// Note that m_strProtocol is already set here, so we just skip over the protocol.</span>
<a name="l00721"></a>00721     <span class="keywordflow">if</span> (pos &lt; len &amp;&amp; buf[pos] == <span class="charliteral">&#39;:&#39;</span> )
<a name="l00722"></a>00722     pos++;
<a name="l00723"></a>00723     <span class="keywordflow">else</span> { <span class="comment">// can&#39;t happen, the caller checked all this already</span>
<a name="l00724"></a>00724     <a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536" title="Resets the members to their &quot;null&quot; state.">reset</a>();
<a name="l00725"></a>00725     m_strProtocol = _url;
<a name="l00726"></a>00726     m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a48dc1cda1b16403f9ba112a8d035e5e7" title="Invalid URI.">Invalid</a>;
<a name="l00727"></a>00727     <span class="keywordflow">return</span>;
<a name="l00728"></a>00728     }
<a name="l00729"></a>00729 
<a name="l00730"></a>00730     <span class="keywordflow">if</span> ( pos == len ) <span class="comment">// can&#39;t happen, the caller checked this already</span>
<a name="l00731"></a>00731     m_strPath = QString::null;
<a name="l00732"></a>00732     <span class="keywordflow">else</span>
<a name="l00733"></a>00733     m_strPath = decode( <a class="codeRef" href="qstring.html">QString</a>( buf + pos, len - pos ), encoding_hint, <span class="keyword">true</span> );
<a name="l00734"></a>00734 
<a name="l00735"></a>00735     m_bIsMalformed = <span class="keyword">false</span>;
<a name="l00736"></a>00736 
<a name="l00737"></a>00737     <span class="keywordflow">return</span>;
<a name="l00738"></a>00738 }
<a name="l00739"></a>00739 
<a name="l00740"></a><a class="code" href="classKURL.html#a9266785d84b7b41c78b1336592198a86">00740</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a9266785d84b7b41c78b1336592198a86" title="Parses the given string and fills the URL&#39;s values on success.">KURL::parseMailto</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _url, <span class="keywordtype">int</span> encoding_hint )
<a name="l00741"></a>00741 {
<a name="l00742"></a>00742     <a class="code" href="classKURL.html#a1005b451c6beee15b87bfe498b2e1f90" title="Parses the given string and fills the URL&#39;s values on success.">parseURL</a>( _url, encoding_hint);
<a name="l00743"></a>00743     <span class="keywordflow">if</span> ( m_bIsMalformed )
<a name="l00744"></a>00744         <span class="keywordflow">return</span>;
<a name="l00745"></a>00745     <a class="codeRef" href="qregexp.html">QRegExp</a> mailre(<span class="stringliteral">&quot;(.+@)(.+)&quot;</span>);
<a name="l00746"></a>00746     <span class="keywordflow">if</span> ( mailre.<a class="codeRef" href="qregexp.html#exactMatch">exactMatch</a>( m_strPath ) )
<a name="l00747"></a>00747     {
<a name="l00748"></a>00748 <span class="preprocessor">#ifndef KDE_QT_ONLY</span>
<a name="l00749"></a>00749 <span class="preprocessor"></span>    <a class="codeRef" href="qstring.html">QString</a> host = KIDNA::toUnicode( mailre.<a class="codeRef" href="qregexp.html#cap">cap</a>( 2 ) );
<a name="l00750"></a>00750     <span class="keywordflow">if</span> (host.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l00751"></a>00751         host = mailre.<a class="codeRef" href="qregexp.html#cap">cap</a>( 2 ).lower();
<a name="l00752"></a>00752 <span class="preprocessor">#else</span>
<a name="l00753"></a>00753 <span class="preprocessor"></span>    <a class="codeRef" href="qstring.html">QString</a> host = mailre.<a class="codeRef" href="qregexp.html#cap">cap</a>( 2 ).lower();
<a name="l00754"></a>00754 <span class="preprocessor">#endif</span>
<a name="l00755"></a>00755 <span class="preprocessor"></span>    m_strPath = mailre.<a class="codeRef" href="qregexp.html#cap">cap</a>( 1 ) + <a class="code" href="classKURL.html#adf3ad35581a0ca25ecc16e073f8275ca" title="Returns the decoded hostname included in the URL.">host</a>;
<a name="l00756"></a>00756   }
<a name="l00757"></a>00757 }
<a name="l00758"></a>00758 
<a name="l00759"></a><a class="code" href="classKURL.html#a1005b451c6beee15b87bfe498b2e1f90">00759</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a1005b451c6beee15b87bfe498b2e1f90" title="Parses the given string and fills the URL&#39;s values on success.">KURL::parseURL</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _url, <span class="keywordtype">int</span> encoding_hint )
<a name="l00760"></a>00760 {
<a name="l00761"></a>00761   <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a205598afc6842db13e4ad996ba1d9422" title="Returns the port number included in the URL.">port</a>;
<a name="l00762"></a>00762   <span class="keywordtype">bool</span> badHostName = <span class="keyword">false</span>;
<a name="l00763"></a>00763   <span class="keywordtype">int</span> start = 0;
<a name="l00764"></a>00764   uint len = _url.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00765"></a>00765   <span class="keyword">const</span> <a class="codeRef" href="qchar.html">QChar</a>* buf = _url.<a class="codeRef" href="qstring.html#unicode">unicode</a>();
<a name="l00766"></a>00766 
<a name="l00767"></a>00767   <a class="codeRef" href="qchar.html">QChar</a> delim;
<a name="l00768"></a>00768   <a class="codeRef" href="qstring.html">QString</a> tmp;
<a name="l00769"></a>00769 
<a name="l00770"></a>00770   uint pos = 0;
<a name="l00771"></a>00771 
<a name="l00772"></a>00772   <span class="comment">// Node 1: Accept alpha or slash</span>
<a name="l00773"></a>00773   <a class="codeRef" href="qchar.html">QChar</a> x = buf[pos++];
<a name="l00774"></a>00774 <span class="preprocessor">#ifdef Q_WS_WIN</span>
<a name="l00775"></a>00775 <span class="preprocessor"></span>  <span class="comment">/* win32: accept &lt;letter&gt;: or &lt;letter&gt;:/ or &lt;letter&gt;:\ */</span>
<a name="l00776"></a>00776   <span class="keyword">const</span> <span class="keywordtype">bool</span> alpha = isalpha((<span class="keywordtype">int</span>)x);
<a name="l00777"></a>00777   <span class="keywordflow">if</span> (alpha &amp;&amp; len&lt;2)
<a name="l00778"></a>00778     <span class="keywordflow">goto</span> NodeErr;
<a name="l00779"></a>00779   <span class="keywordflow">if</span> (alpha &amp;&amp; buf[pos]==<span class="charliteral">&#39;:&#39;</span> &amp;&amp; (len==2 || (len&gt;2 &amp;&amp; (buf[pos+1]==<span class="charliteral">&#39;/&#39;</span> || buf[pos+1]==<span class="charliteral">&#39;\\&#39;</span>))))
<a name="l00780"></a>00780 <span class="preprocessor">#else</span>
<a name="l00781"></a>00781 <span class="preprocessor"></span>  <span class="keywordflow">if</span> ( x == <span class="charliteral">&#39;/&#39;</span> )
<a name="l00782"></a>00782 <span class="preprocessor">#endif</span>
<a name="l00783"></a>00783 <span class="preprocessor"></span>    <span class="keywordflow">goto</span> Node9;
<a name="l00784"></a>00784   <span class="keywordflow">if</span> ( !isalpha( (<span class="keywordtype">int</span>)x ) )
<a name="l00785"></a>00785     <span class="keywordflow">goto</span> NodeErr;
<a name="l00786"></a>00786 
<a name="l00787"></a>00787   <span class="comment">// Node 2: Accept any amount of (alpha|digit|&#39;+&#39;|&#39;-&#39;)</span>
<a name="l00788"></a>00788   <span class="comment">// &#39;.&#39; is not currently accepted, because current KURL may be confused.</span>
<a name="l00789"></a>00789   <span class="comment">// Proceed with :// :/ or :</span>
<a name="l00790"></a>00790   <span class="keywordflow">while</span>( pos &lt; len &amp;&amp; (isalpha((<span class="keywordtype">int</span>)buf[pos]) || isdigit((<span class="keywordtype">int</span>)buf[pos]) ||
<a name="l00791"></a>00791           buf[pos] == <span class="charliteral">&#39;+&#39;</span> || buf[pos] == <span class="charliteral">&#39;-&#39;</span>)) pos++;
<a name="l00792"></a>00792 
<a name="l00793"></a>00793   <span class="comment">// Note that m_strProtocol is already set here, so we just skip over the protocol.</span>
<a name="l00794"></a>00794   <span class="keywordflow">if</span> ( pos+2 &lt; len &amp;&amp; buf[pos] == <span class="charliteral">&#39;:&#39;</span> &amp;&amp; buf[pos+1] == <span class="charliteral">&#39;/&#39;</span> &amp;&amp; buf[pos+2] == <span class="charliteral">&#39;/&#39;</span> )
<a name="l00795"></a>00795     {
<a name="l00796"></a>00796       pos += 3;
<a name="l00797"></a>00797     }
<a name="l00798"></a>00798   <span class="keywordflow">else</span> <span class="keywordflow">if</span> (pos+1 &lt; len &amp;&amp; buf[pos] == <span class="charliteral">&#39;:&#39;</span> ) <span class="comment">// Need to always compare length()-1 otherwise KURL passes &quot;http:&quot; as legal!!</span>
<a name="l00799"></a>00799     {
<a name="l00800"></a>00800       pos++;
<a name="l00801"></a>00801       start = pos;
<a name="l00802"></a>00802       <span class="keywordflow">goto</span> Node9;
<a name="l00803"></a>00803     }
<a name="l00804"></a>00804   <span class="keywordflow">else</span>
<a name="l00805"></a>00805     <span class="keywordflow">goto</span> NodeErr;
<a name="l00806"></a>00806 
<a name="l00807"></a>00807   <span class="comment">//Node 3: We need at least one character here</span>
<a name="l00808"></a>00808   <span class="keywordflow">if</span> ( pos == len )
<a name="l00809"></a>00809       <span class="keywordflow">goto</span> NodeErr;
<a name="l00810"></a>00810   start = pos;
<a name="l00811"></a>00811 
<a name="l00812"></a>00812   <span class="comment">// Node 4: Accept any amount of characters.</span>
<a name="l00813"></a>00813   <span class="keywordflow">if</span> (buf[pos] == <span class="charliteral">&#39;[&#39;</span>)     <span class="comment">// An IPv6 host follows.</span>
<a name="l00814"></a>00814       <span class="keywordflow">goto</span> Node8;
<a name="l00815"></a>00815   <span class="comment">// Terminate on / or @ or ? or # or &quot; or ; or &lt;</span>
<a name="l00816"></a>00816   x = buf[pos];
<a name="l00817"></a>00817   <span class="keywordflow">while</span>( (x != <span class="charliteral">&#39;:&#39;</span>) &amp;&amp; (x != <span class="charliteral">&#39;@&#39;</span>) &amp;&amp; (x != <span class="charliteral">&#39;/&#39;</span>) &amp;&amp; (x != <span class="charliteral">&#39;?&#39;</span>) &amp;&amp; (x != <span class="charliteral">&#39;#&#39;</span>) )
<a name="l00818"></a>00818   {
<a name="l00819"></a>00819      <span class="keywordflow">if</span> ((x == <span class="charliteral">&#39;\&quot;&#39;</span>) || (x == <span class="charliteral">&#39;;&#39;</span>) || (x == <span class="charliteral">&#39;&lt;&#39;</span>))
<a name="l00820"></a>00820         badHostName = <span class="keyword">true</span>;
<a name="l00821"></a>00821      <span class="keywordflow">if</span> (++pos == len)
<a name="l00822"></a>00822         <span class="keywordflow">break</span>;
<a name="l00823"></a>00823      x = buf[pos];
<a name="l00824"></a>00824   }
<a name="l00825"></a>00825   <span class="keywordflow">if</span> ( pos == len )
<a name="l00826"></a>00826     {
<a name="l00827"></a>00827       <span class="keywordflow">if</span> (badHostName)
<a name="l00828"></a>00828          <span class="keywordflow">goto</span> NodeErr;
<a name="l00829"></a>00829 
<a name="l00830"></a>00830       <a class="code" href="classKURL.html#afbf05cea61e7c6f3c5de6a467d5f0534" title="Sets the hostname to include in the URL.">setHost</a>(decode(<a class="codeRef" href="qstring.html">QString</a>( buf + start, pos - start ), encoding_hint));
<a name="l00831"></a>00831       <span class="keywordflow">goto</span> NodeOk;
<a name="l00832"></a>00832     }
<a name="l00833"></a>00833   <span class="keywordflow">if</span> ( x == <span class="charliteral">&#39;@&#39;</span> )
<a name="l00834"></a>00834     {
<a name="l00835"></a>00835       m_strUser = decode(<a class="codeRef" href="qstring.html">QString</a>( buf + start, pos - start ), encoding_hint);
<a name="l00836"></a>00836       pos++;
<a name="l00837"></a>00837       <span class="keywordflow">goto</span> Node7;
<a name="l00838"></a>00838     }
<a name="l00839"></a>00839   <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( (x == <span class="charliteral">&#39;/&#39;</span>) || (x == <span class="charliteral">&#39;?&#39;</span>) || (x == <span class="charliteral">&#39;#&#39;</span>))
<a name="l00840"></a>00840     {
<a name="l00841"></a>00841       <span class="keywordflow">if</span> (badHostName)
<a name="l00842"></a>00842          <span class="keywordflow">goto</span> NodeErr;
<a name="l00843"></a>00843 
<a name="l00844"></a>00844       <a class="code" href="classKURL.html#afbf05cea61e7c6f3c5de6a467d5f0534" title="Sets the hostname to include in the URL.">setHost</a>(decode(<a class="codeRef" href="qstring.html">QString</a>( buf + start, pos - start ), encoding_hint));
<a name="l00845"></a>00845       start = pos;
<a name="l00846"></a>00846       <span class="keywordflow">goto</span> Node9;
<a name="l00847"></a>00847     }
<a name="l00848"></a>00848   <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( x != <span class="charliteral">&#39;:&#39;</span> )
<a name="l00849"></a>00849     <span class="keywordflow">goto</span> NodeErr;
<a name="l00850"></a>00850   m_strUser = decode(<a class="codeRef" href="qstring.html">QString</a>( buf + start, pos - start ), encoding_hint);
<a name="l00851"></a>00851   pos++;
<a name="l00852"></a>00852 
<a name="l00853"></a>00853   <span class="comment">// Node 5: We need at least one character</span>
<a name="l00854"></a>00854   <span class="keywordflow">if</span> ( pos == len )
<a name="l00855"></a>00855     <span class="keywordflow">goto</span> NodeErr;
<a name="l00856"></a>00856   start = pos++;
<a name="l00857"></a>00857 
<a name="l00858"></a>00858   <span class="comment">// Node 6: Read everything until @, /, ? or #</span>
<a name="l00859"></a>00859   <span class="keywordflow">while</span>( (pos &lt; len) &amp;&amp;
<a name="l00860"></a>00860         (buf[pos] != <span class="charliteral">&#39;@&#39;</span>) &amp;&amp;
<a name="l00861"></a>00861         (buf[pos] != <span class="charliteral">&#39;/&#39;</span>) &amp;&amp;
<a name="l00862"></a>00862         (buf[pos] != <span class="charliteral">&#39;?&#39;</span>) &amp;&amp;
<a name="l00863"></a>00863         (buf[pos] != <span class="charliteral">&#39;#&#39;</span>)) pos++;
<a name="l00864"></a>00864   <span class="comment">// If we now have a &#39;@&#39; the &#39;:&#39; seperates user and password.</span>
<a name="l00865"></a>00865   <span class="comment">// Otherwise it seperates host and port.</span>
<a name="l00866"></a>00866   <span class="keywordflow">if</span> ( (pos == len) || (buf[pos] != <span class="charliteral">&#39;@&#39;</span>) )
<a name="l00867"></a>00867     {
<a name="l00868"></a>00868       <span class="comment">// Ok the : was used to separate host and port</span>
<a name="l00869"></a>00869       <span class="keywordflow">if</span> (badHostName)
<a name="l00870"></a>00870          <span class="keywordflow">goto</span> NodeErr;
<a name="l00871"></a>00871       <a class="code" href="classKURL.html#afbf05cea61e7c6f3c5de6a467d5f0534" title="Sets the hostname to include in the URL.">setHost</a>(m_strUser);
<a name="l00872"></a>00872       m_strUser = QString::null;
<a name="l00873"></a>00873       <a class="codeRef" href="qstring.html">QString</a> tmp( buf + start, pos - start );
<a name="l00874"></a>00874       <span class="keywordtype">char</span> *endptr;
<a name="l00875"></a>00875       m_iPort = (<span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> int)strtol(tmp.<a class="codeRef" href="qstring.html#ascii">ascii</a>(), &amp;endptr, 10);
<a name="l00876"></a>00876       <span class="keywordflow">if</span> ((pos == len) &amp;&amp; (strlen(endptr) == 0))
<a name="l00877"></a>00877         <span class="keywordflow">goto</span> NodeOk;
<a name="l00878"></a>00878       <span class="comment">// there is more after the digits</span>
<a name="l00879"></a>00879       pos -= strlen(endptr);
<a name="l00880"></a>00880       <span class="keywordflow">if</span> ((buf[pos] != <span class="charliteral">&#39;@&#39;</span>) &amp;&amp;
<a name="l00881"></a>00881           (buf[pos] != <span class="charliteral">&#39;/&#39;</span>) &amp;&amp;
<a name="l00882"></a>00882           (buf[pos] != <span class="charliteral">&#39;?&#39;</span>) &amp;&amp;
<a name="l00883"></a>00883           (buf[pos] != <span class="charliteral">&#39;#&#39;</span>))
<a name="l00884"></a>00884         <span class="keywordflow">goto</span> NodeErr;
<a name="l00885"></a>00885 
<a name="l00886"></a>00886       start = pos;
<a name="l00887"></a>00887       <span class="keywordflow">goto</span> Node9;
<a name="l00888"></a>00888     }
<a name="l00889"></a>00889   m_strPass = decode(<a class="codeRef" href="qstring.html">QString</a>( buf + start, pos - start), encoding_hint);
<a name="l00890"></a>00890   pos++;
<a name="l00891"></a>00891 
<a name="l00892"></a>00892   <span class="comment">// Node 7: We need at least one character</span>
<a name="l00893"></a>00893  Node7:
<a name="l00894"></a>00894   <span class="keywordflow">if</span> ( pos == len )
<a name="l00895"></a>00895     <span class="keywordflow">goto</span> NodeErr;
<a name="l00896"></a>00896 
<a name="l00897"></a>00897  Node8:
<a name="l00898"></a>00898   <span class="keywordflow">if</span> (buf[pos] == <span class="charliteral">&#39;[&#39;</span>)
<a name="l00899"></a>00899   {
<a name="l00900"></a>00900     <span class="comment">// IPv6 address</span>
<a name="l00901"></a>00901     start = ++pos; <span class="comment">// Skip &#39;[&#39;</span>
<a name="l00902"></a>00902 
<a name="l00903"></a>00903     <span class="keywordflow">if</span> (pos == len)
<a name="l00904"></a>00904     {
<a name="l00905"></a>00905        badHostName = <span class="keyword">true</span>;
<a name="l00906"></a>00906        <span class="keywordflow">goto</span> NodeErr;
<a name="l00907"></a>00907     }
<a name="l00908"></a>00908     <span class="comment">// Node 8a: Read everything until ] or terminate</span>
<a name="l00909"></a>00909     badHostName = <span class="keyword">false</span>;
<a name="l00910"></a>00910     x = buf[pos];
<a name="l00911"></a>00911     <span class="keywordflow">while</span>( (x != <span class="charliteral">&#39;]&#39;</span>) )
<a name="l00912"></a>00912     {
<a name="l00913"></a>00913        <span class="keywordflow">if</span> ((x == <span class="charliteral">&#39;\&quot;&#39;</span>) || (x == <span class="charliteral">&#39;;&#39;</span>) || (x == <span class="charliteral">&#39;&lt;&#39;</span>))
<a name="l00914"></a>00914           badHostName = <span class="keyword">true</span>;
<a name="l00915"></a>00915        <span class="keywordflow">if</span> (++pos == len)
<a name="l00916"></a>00916        {
<a name="l00917"></a>00917           badHostName = <span class="keyword">true</span>;
<a name="l00918"></a>00918           <span class="keywordflow">break</span>;
<a name="l00919"></a>00919        }
<a name="l00920"></a>00920        x = buf[pos];
<a name="l00921"></a>00921     }
<a name="l00922"></a>00922     <span class="keywordflow">if</span> (badHostName)
<a name="l00923"></a>00923        <span class="keywordflow">goto</span> NodeErr;
<a name="l00924"></a>00924     <a class="code" href="classKURL.html#afbf05cea61e7c6f3c5de6a467d5f0534" title="Sets the hostname to include in the URL.">setHost</a>(decode(<a class="codeRef" href="qstring.html">QString</a>( buf + start, pos - start ), encoding_hint));
<a name="l00925"></a>00925     <span class="keywordflow">if</span> (pos &lt; len) pos++; <span class="comment">// Skip &#39;]&#39;</span>
<a name="l00926"></a>00926     <span class="keywordflow">if</span> (pos == len)
<a name="l00927"></a>00927        <span class="keywordflow">goto</span> NodeOk;
<a name="l00928"></a>00928   }
<a name="l00929"></a>00929   <span class="keywordflow">else</span>
<a name="l00930"></a>00930   {
<a name="l00931"></a>00931     <span class="comment">// Non IPv6 address, with a user</span>
<a name="l00932"></a>00932     start = pos;
<a name="l00933"></a>00933 
<a name="l00934"></a>00934     <span class="comment">// Node 8b: Read everything until / : or terminate</span>
<a name="l00935"></a>00935     badHostName = <span class="keyword">false</span>;
<a name="l00936"></a>00936     x = buf[pos];
<a name="l00937"></a>00937     <span class="keywordflow">while</span>( (x != <span class="charliteral">&#39;:&#39;</span>) &amp;&amp; (x != <span class="charliteral">&#39;@&#39;</span>) &amp;&amp; (x != <span class="charliteral">&#39;/&#39;</span>) &amp;&amp; (x != <span class="charliteral">&#39;?&#39;</span>) &amp;&amp; (x != <span class="charliteral">&#39;#&#39;</span>) )
<a name="l00938"></a>00938     {
<a name="l00939"></a>00939        <span class="keywordflow">if</span> ((x == <span class="charliteral">&#39;\&quot;&#39;</span>) || (x == <span class="charliteral">&#39;;&#39;</span>) || (x == <span class="charliteral">&#39;&lt;&#39;</span>))
<a name="l00940"></a>00940           badHostName = <span class="keyword">true</span>;
<a name="l00941"></a>00941        <span class="keywordflow">if</span> (++pos == len)
<a name="l00942"></a>00942           <span class="keywordflow">break</span>;
<a name="l00943"></a>00943        x = buf[pos];
<a name="l00944"></a>00944     }
<a name="l00945"></a>00945     <span class="keywordflow">if</span> (badHostName)
<a name="l00946"></a>00946        <span class="keywordflow">goto</span> NodeErr;
<a name="l00947"></a>00947     <span class="keywordflow">if</span> ( pos == len )
<a name="l00948"></a>00948     {
<a name="l00949"></a>00949        <a class="code" href="classKURL.html#afbf05cea61e7c6f3c5de6a467d5f0534" title="Sets the hostname to include in the URL.">setHost</a>(decode(<a class="codeRef" href="qstring.html">QString</a>( buf + start, pos - start ), encoding_hint));
<a name="l00950"></a>00950        <span class="keywordflow">goto</span> NodeOk;
<a name="l00951"></a>00951     }
<a name="l00952"></a>00952     <a class="code" href="classKURL.html#afbf05cea61e7c6f3c5de6a467d5f0534" title="Sets the hostname to include in the URL.">setHost</a>(decode(<a class="codeRef" href="qstring.html">QString</a>( buf + start, pos - start ), encoding_hint));
<a name="l00953"></a>00953   }
<a name="l00954"></a>00954   x = buf[pos];
<a name="l00955"></a>00955   <span class="keywordflow">if</span> ( x == <span class="charliteral">&#39;/&#39;</span> || x == <span class="charliteral">&#39;#&#39;</span> || x == <span class="charliteral">&#39;?&#39;</span> )
<a name="l00956"></a>00956     {
<a name="l00957"></a>00957       start = pos;
<a name="l00958"></a>00958       <span class="keywordflow">goto</span> Node9;
<a name="l00959"></a>00959     }
<a name="l00960"></a>00960   <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( x != <span class="charliteral">&#39;:&#39;</span> )
<a name="l00961"></a>00961     <span class="keywordflow">goto</span> NodeErr;
<a name="l00962"></a>00962   pos++;
<a name="l00963"></a>00963 
<a name="l00964"></a>00964   <span class="comment">// Node 8c: Accept at least one digit</span>
<a name="l00965"></a>00965   <span class="keywordflow">if</span> ( pos == len )
<a name="l00966"></a>00966     <span class="keywordflow">goto</span> NodeErr;
<a name="l00967"></a>00967   start = pos;
<a name="l00968"></a>00968   <span class="keywordflow">if</span> ( !isdigit( buf[pos++] ) )
<a name="l00969"></a>00969     <span class="keywordflow">goto</span> NodeErr;
<a name="l00970"></a>00970 
<a name="l00971"></a>00971   <span class="comment">// Node 8d: Accept any amount of digits</span>
<a name="l00972"></a>00972   <span class="keywordflow">while</span>( pos &lt; len &amp;&amp; isdigit( buf[pos] ) ) pos++;
<a name="l00973"></a>00973   port = <a class="codeRef" href="qstring.html">QString</a>( buf + start, pos - start );
<a name="l00974"></a>00974   m_iPort = port.<a class="codeRef" href="qstring.html#toUShort">toUShort</a>();
<a name="l00975"></a>00975   <span class="keywordflow">if</span> ( pos == len )
<a name="l00976"></a>00976     <span class="keywordflow">goto</span> NodeOk;
<a name="l00977"></a>00977   start = pos;
<a name="l00978"></a>00978 
<a name="l00979"></a>00979  Node9: <span class="comment">// parse path until query or reference reached</span>
<a name="l00980"></a>00980 
<a name="l00981"></a>00981   <span class="keywordflow">while</span>( pos &lt; len &amp;&amp; buf[pos] != <span class="charliteral">&#39;#&#39;</span> &amp;&amp; buf[pos]!=<span class="charliteral">&#39;?&#39;</span> ) pos++;
<a name="l00982"></a>00982 
<a name="l00983"></a>00983   tmp = <a class="codeRef" href="qstring.html">QString</a>( buf + start, pos - start );
<a name="l00984"></a>00984   <span class="comment">//kdDebug(126)&lt;&lt;&quot; setting encoded path to:&quot;&lt;&lt;tmp&lt;&lt;endl;</span>
<a name="l00985"></a>00985   <a class="code" href="classKURL.html#aab26a52864a868ea2eddb5e9e7c9057e" title="Sets the (already encoded) path of the URL.">setEncodedPath</a>( tmp, encoding_hint );
<a name="l00986"></a>00986 
<a name="l00987"></a>00987   <span class="keywordflow">if</span> ( pos == len )
<a name="l00988"></a>00988       <span class="keywordflow">goto</span> NodeOk;
<a name="l00989"></a>00989 
<a name="l00990"></a>00990  <span class="comment">//Node10: // parse query or reference depending on what comes first</span>
<a name="l00991"></a>00991   delim = (buf[pos++]==<span class="charliteral">&#39;#&#39;</span>?<span class="charliteral">&#39;?&#39;</span>:<span class="charliteral">&#39;#&#39;</span>);
<a name="l00992"></a>00992 
<a name="l00993"></a>00993   start = pos;
<a name="l00994"></a>00994 
<a name="l00995"></a>00995   <span class="keywordflow">while</span>(pos &lt; len &amp;&amp; buf[pos]!=delim ) pos++;
<a name="l00996"></a>00996 
<a name="l00997"></a>00997   tmp = <a class="codeRef" href="qstring.html">QString</a>(buf + start, pos - start);
<a name="l00998"></a>00998   <span class="keywordflow">if</span> (delim==<span class="charliteral">&#39;#&#39;</span>)
<a name="l00999"></a>00999       _setQuery(tmp, encoding_hint);
<a name="l01000"></a>01000   <span class="keywordflow">else</span>
<a name="l01001"></a>01001       m_strRef_encoded = tmp;
<a name="l01002"></a>01002 
<a name="l01003"></a>01003   <span class="keywordflow">if</span> (pos == len)
<a name="l01004"></a>01004       <span class="keywordflow">goto</span> NodeOk;
<a name="l01005"></a>01005 
<a name="l01006"></a>01006  <span class="comment">//Node11: // feed the rest into the remaining variable</span>
<a name="l01007"></a>01007   tmp = <a class="codeRef" href="qstring.html">QString</a>( buf + pos + 1, len - pos - 1);
<a name="l01008"></a>01008   <span class="keywordflow">if</span> (delim == <span class="charliteral">&#39;#&#39;</span>)
<a name="l01009"></a>01009       m_strRef_encoded = tmp;
<a name="l01010"></a>01010   <span class="keywordflow">else</span>
<a name="l01011"></a>01011       _setQuery(tmp, encoding_hint);
<a name="l01012"></a>01012 
<a name="l01013"></a>01013  NodeOk:
<a name="l01014"></a>01014   <span class="comment">//kdDebug(126)&lt;&lt;&quot;parsing finished. m_strProtocol=&quot;&lt;&lt;m_strProtocol&lt;&lt;&quot; m_strHost=&quot;&lt;&lt;m_strHost&lt;&lt;&quot; m_strPath=&quot;&lt;&lt;m_strPath&lt;&lt;endl;</span>
<a name="l01015"></a>01015   m_bIsMalformed = <span class="keyword">false</span>; <span class="comment">// Valid URL</span>
<a name="l01016"></a>01016 
<a name="l01017"></a>01017   <span class="comment">//kdDebug()&lt;&lt;&quot;Prot=&quot;&lt;&lt;m_strProtocol&lt;&lt;&quot;\nUser=&quot;&lt;&lt;m_strUser&lt;&lt;&quot;\nPass=&quot;&lt;&lt;m_strPass&lt;&lt;&quot;\nHost=&quot;&lt;&lt;m_strHost&lt;&lt;&quot;\nPath=&quot;&lt;&lt;m_strPath&lt;&lt;&quot;\nQuery=&quot;&lt;&lt;m_strQuery_encoded&lt;&lt;&quot;\nRef=&quot;&lt;&lt;m_strRef_encoded&lt;&lt;&quot;\nPort=&quot;&lt;&lt;m_iPort&lt;&lt;endl;</span>
<a name="l01018"></a>01018   <span class="keywordflow">if</span> (m_strProtocol.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01019"></a>01019   {
<a name="l01020"></a>01020     m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a>;
<a name="l01021"></a>01021     m_strProtocol = fileProt;
<a name="l01022"></a>01022   }
<a name="l01023"></a>01023   <span class="keywordflow">return</span>;
<a name="l01024"></a>01024 
<a name="l01025"></a>01025  NodeErr:
<a name="l01026"></a>01026 <span class="comment">//  kdDebug(126) &lt;&lt; &quot;KURL couldn&#39;t parse URL \&quot;&quot; &lt;&lt; _url &lt;&lt; &quot;\&quot;&quot; &lt;&lt; endl;</span>
<a name="l01027"></a>01027   <a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536" title="Resets the members to their &quot;null&quot; state.">reset</a>();
<a name="l01028"></a>01028   m_strProtocol = _url;
<a name="l01029"></a>01029   m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a48dc1cda1b16403f9ba112a8d035e5e7" title="Invalid URI.">Invalid</a>;
<a name="l01030"></a>01030 }
<a name="l01031"></a>01031 
<a name="l01032"></a><a class="code" href="classKURL.html#a7803b7119921a664d389e9c85b7742e0">01032</a> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; <a class="code" href="classKURL.html#a86078b56b4e196780e343001263d4545" title="Copies the values of the given URL into this one.">KURL::operator=</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _url )
<a name="l01033"></a>01033 {
<a name="l01034"></a>01034   <a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536" title="Resets the members to their &quot;null&quot; state.">reset</a>();
<a name="l01035"></a>01035   <a class="code" href="classKURL.html#ab3e311c1974098c707b94e7b7eb2ec74" title="Parses the given string and fills the URL&#39;s values on success.">parse</a>( _url );
<a name="l01036"></a>01036 
<a name="l01037"></a>01037   <span class="keywordflow">return</span> *<span class="keyword">this</span>;
<a name="l01038"></a>01038 }
<a name="l01039"></a>01039 
<a name="l01040"></a><a class="code" href="classKURL.html#a43257e96a858a015009ea2816b88f69c">01040</a> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; <a class="code" href="classKURL.html#a86078b56b4e196780e343001263d4545" title="Copies the values of the given URL into this one.">KURL::operator=</a>( <span class="keyword">const</span> <span class="keywordtype">char</span> * _url )
<a name="l01041"></a>01041 {
<a name="l01042"></a>01042   <a class="code" href="classKURL.html#a508a4c6026a031a52d4c854a26cce536" title="Resets the members to their &quot;null&quot; state.">reset</a>();
<a name="l01043"></a>01043   <a class="code" href="classKURL.html#ab3e311c1974098c707b94e7b7eb2ec74" title="Parses the given string and fills the URL&#39;s values on success.">parse</a>( <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>(_url) );
<a name="l01044"></a>01044 
<a name="l01045"></a>01045   <span class="keywordflow">return</span> *<span class="keyword">this</span>;
<a name="l01046"></a>01046 }
<a name="l01047"></a>01047 
<a name="l01048"></a>01048 <span class="preprocessor">#ifndef QT_NO_NETWORKPROTOCOL</span>
<a name="l01049"></a><a class="code" href="classKURL.html#a678569f3199c222f99701bdbfb091ea3">01049</a> <span class="preprocessor"></span><a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; <a class="code" href="classKURL.html#a86078b56b4e196780e343001263d4545" title="Copies the values of the given URL into this one.">KURL::operator=</a>( <span class="keyword">const</span> <a class="codeRef" href="qurl.html">QUrl</a> &amp; u )
<a name="l01050"></a>01050 {
<a name="l01051"></a>01051   m_strProtocol = u.<a class="codeRef" href="qurl.html#protocol">protocol</a>();
<a name="l01052"></a>01052   m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a9db85130d0702a27e41777d7c767acca" title="Automatically detected.">Auto</a>;
<a name="l01053"></a>01053   m_strUser = u.<a class="codeRef" href="qurl.html#user">user</a>();
<a name="l01054"></a>01054   m_strPass = u.<a class="codeRef" href="qurl.html#password">password</a>();
<a name="l01055"></a>01055   m_strHost = u.<a class="codeRef" href="qurl.html#host">host</a>();
<a name="l01056"></a>01056   m_strPath = u.<a class="codeRef" href="qurl.html#path">path</a>( <span class="keyword">false</span> );
<a name="l01057"></a>01057   m_strPath_encoded = QString::null;
<a name="l01058"></a>01058   m_strQuery_encoded = u.<a class="codeRef" href="qurl.html#query">query</a>();
<a name="l01059"></a>01059   m_strRef_encoded = u.<a class="codeRef" href="qurl.html#ref">ref</a>();
<a name="l01060"></a>01060   m_bIsMalformed = !u.<a class="codeRef" href="qurl.html#isValid">isValid</a>();
<a name="l01061"></a>01061   m_iPort = u.<a class="codeRef" href="qurl.html#port">port</a>();
<a name="l01062"></a>01062 
<a name="l01063"></a>01063   <span class="keywordflow">return</span> *<span class="keyword">this</span>;
<a name="l01064"></a>01064 }
<a name="l01065"></a>01065 <span class="preprocessor">#endif</span>
<a name="l01066"></a>01066 <span class="preprocessor"></span>
<a name="l01067"></a><a class="code" href="classKURL.html#a86078b56b4e196780e343001263d4545">01067</a> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; <a class="code" href="classKURL.html#a86078b56b4e196780e343001263d4545" title="Copies the values of the given URL into this one.">KURL::operator=</a>( <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; _u )
<a name="l01068"></a>01068 {
<a name="l01069"></a>01069   m_strProtocol = _u.m_strProtocol;
<a name="l01070"></a>01070   m_strUser = _u.m_strUser;
<a name="l01071"></a>01071   m_strPass = _u.m_strPass;
<a name="l01072"></a>01072   m_strHost = _u.m_strHost;
<a name="l01073"></a>01073   m_strPath = _u.m_strPath;
<a name="l01074"></a>01074   m_strPath_encoded = _u.m_strPath_encoded;
<a name="l01075"></a>01075   m_strQuery_encoded = _u.m_strQuery_encoded;
<a name="l01076"></a>01076   m_strRef_encoded = _u.m_strRef_encoded;
<a name="l01077"></a>01077   m_bIsMalformed = _u.m_bIsMalformed;
<a name="l01078"></a>01078   m_iPort = _u.m_iPort;
<a name="l01079"></a>01079   m_iUriMode = _u.m_iUriMode;
<a name="l01080"></a>01080 
<a name="l01081"></a>01081   <span class="keywordflow">return</span> *<span class="keyword">this</span>;
<a name="l01082"></a>01082 }
<a name="l01083"></a>01083 
<a name="l01084"></a><a class="code" href="classKURL.html#ac60bdbc98263f470f5955ffc79cf95c3">01084</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#ac60bdbc98263f470f5955ffc79cf95c3" title="Tests if this URL is less than the given URL.">KURL::operator&lt;</a>( <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; _u)<span class="keyword"> const</span>
<a name="l01085"></a>01085 <span class="keyword"></span>{
<a name="l01086"></a>01086   <span class="keywordtype">int</span> i;
<a name="l01087"></a>01087   <span class="keywordflow">if</span> (!_u.<a class="code" href="classKURL.html#ad8b823d40572ca24b6983d868847c251" title="Tests if the URL is well formed.">isValid</a>())
<a name="l01088"></a>01088   {
<a name="l01089"></a>01089      <span class="keywordflow">if</span> (!<a class="code" href="classKURL.html#ad8b823d40572ca24b6983d868847c251" title="Tests if the URL is well formed.">isValid</a>())
<a name="l01090"></a>01090      {
<a name="l01091"></a>01091         i = m_strProtocol.<a class="codeRef" href="qstring.html#compare">compare</a>(_u.m_strProtocol);
<a name="l01092"></a>01092         <span class="keywordflow">return</span> (i &lt; 0);
<a name="l01093"></a>01093      }
<a name="l01094"></a>01094      <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01095"></a>01095   }
<a name="l01096"></a>01096   <span class="keywordflow">if</span> (!<a class="code" href="classKURL.html#ad8b823d40572ca24b6983d868847c251" title="Tests if the URL is well formed.">isValid</a>())
<a name="l01097"></a>01097      <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01098"></a>01098 
<a name="l01099"></a>01099   i = m_strProtocol.<a class="codeRef" href="qstring.html#compare">compare</a>(_u.m_strProtocol);
<a name="l01100"></a>01100   <span class="keywordflow">if</span> (i) <span class="keywordflow">return</span> (i &lt; 0);
<a name="l01101"></a>01101 
<a name="l01102"></a>01102   i = m_strHost.<a class="codeRef" href="qstring.html#compare">compare</a>(_u.m_strHost);
<a name="l01103"></a>01103   <span class="keywordflow">if</span> (i) <span class="keywordflow">return</span> (i &lt; 0);
<a name="l01104"></a>01104 
<a name="l01105"></a>01105   <span class="keywordflow">if</span> (m_iPort != _u.m_iPort) <span class="keywordflow">return</span> (m_iPort &lt; _u.m_iPort);
<a name="l01106"></a>01106 
<a name="l01107"></a>01107   i = m_strPath.<a class="codeRef" href="qstring.html#compare">compare</a>(_u.m_strPath);
<a name="l01108"></a>01108   <span class="keywordflow">if</span> (i) <span class="keywordflow">return</span> (i &lt; 0);
<a name="l01109"></a>01109 
<a name="l01110"></a>01110   i = m_strQuery_encoded.<a class="codeRef" href="qstring.html#compare">compare</a>(_u.m_strQuery_encoded);
<a name="l01111"></a>01111   <span class="keywordflow">if</span> (i) <span class="keywordflow">return</span> (i &lt; 0);
<a name="l01112"></a>01112 
<a name="l01113"></a>01113   i = m_strRef_encoded.<a class="codeRef" href="qstring.html#compare">compare</a>(_u.m_strRef_encoded);
<a name="l01114"></a>01114   <span class="keywordflow">if</span> (i) <span class="keywordflow">return</span> (i &lt; 0);
<a name="l01115"></a>01115 
<a name="l01116"></a>01116   i = m_strUser.<a class="codeRef" href="qstring.html#compare">compare</a>(_u.m_strUser);
<a name="l01117"></a>01117   <span class="keywordflow">if</span> (i) <span class="keywordflow">return</span> (i &lt; 0);
<a name="l01118"></a>01118 
<a name="l01119"></a>01119   i = m_strPass.<a class="codeRef" href="qstring.html#compare">compare</a>(_u.m_strPass);
<a name="l01120"></a>01120   <span class="keywordflow">if</span> (i) <span class="keywordflow">return</span> (i &lt; 0);
<a name="l01121"></a>01121 
<a name="l01122"></a>01122   <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01123"></a>01123 }
<a name="l01124"></a>01124 
<a name="l01125"></a><a class="code" href="classKURL.html#a16d4527245ef6a50d158240936be4775">01125</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#a16d4527245ef6a50d158240936be4775" title="Tests if this URL is equal to the given one.">KURL::operator==</a>( <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; _u )<span class="keyword"> const</span>
<a name="l01126"></a>01126 <span class="keyword"></span>{
<a name="l01127"></a>01127   <span class="keywordflow">if</span> ( !<a class="code" href="classKURL.html#ad8b823d40572ca24b6983d868847c251" title="Tests if the URL is well formed.">isValid</a>() || !_u.<a class="code" href="classKURL.html#ad8b823d40572ca24b6983d868847c251" title="Tests if the URL is well formed.">isValid</a>() )
<a name="l01128"></a>01128     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01129"></a>01129 
<a name="l01130"></a>01130   <span class="keywordflow">if</span> ( m_strProtocol == _u.m_strProtocol &amp;&amp;
<a name="l01131"></a>01131        m_strUser == _u.m_strUser &amp;&amp;
<a name="l01132"></a>01132        m_strPass == _u.m_strPass &amp;&amp;
<a name="l01133"></a>01133        m_strHost == _u.m_strHost &amp;&amp;
<a name="l01134"></a>01134        m_strPath == _u.m_strPath &amp;&amp;
<a name="l01135"></a>01135        <span class="comment">// The encoded path may be null, but the URLs are still equal (David)</span>
<a name="l01136"></a>01136        ( m_strPath_encoded.<a class="codeRef" href="qstring.html#isNull">isNull</a>() || _u.m_strPath_encoded.<a class="codeRef" href="qstring.html#isNull">isNull</a>() ||
<a name="l01137"></a>01137          m_strPath_encoded == _u.m_strPath_encoded ) &amp;&amp;
<a name="l01138"></a>01138        m_strQuery_encoded == _u.m_strQuery_encoded &amp;&amp;
<a name="l01139"></a>01139        m_strRef_encoded == _u.m_strRef_encoded &amp;&amp;
<a name="l01140"></a>01140        m_iPort == _u.m_iPort )
<a name="l01141"></a>01141   {
<a name="l01142"></a>01142     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01143"></a>01143   }
<a name="l01144"></a>01144 
<a name="l01145"></a>01145   <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01146"></a>01146 }
<a name="l01147"></a>01147 
<a name="l01148"></a><a class="code" href="classKURL.html#a405d73554b97daca3568a0a554e2cc58">01148</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#a16d4527245ef6a50d158240936be4775" title="Tests if this URL is equal to the given one.">KURL::operator==</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _u )<span class="keyword"> const</span>
<a name="l01149"></a>01149 <span class="keyword"></span>{
<a name="l01150"></a>01150   <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> u( _u );
<a name="l01151"></a>01151   <span class="keywordflow">return</span> ( *<span class="keyword">this</span> == u );
<a name="l01152"></a>01152 }
<a name="l01153"></a>01153 
<a name="l01154"></a><a class="code" href="classKURL.html#ae52a2ef0548958a5e0586182016834da">01154</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#ae52a2ef0548958a5e0586182016834da" title="Compares this URL with another one.">KURL::cmp</a>( <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> &amp;u, <span class="keywordtype">bool</span> ignore_trailing )<span class="keyword"> const</span>
<a name="l01155"></a>01155 <span class="keyword"></span>{
<a name="l01156"></a>01156   <span class="keywordflow">return</span> <a class="code" href="classKURL.html#a373b2cd2d283db2a94f7cf00483d5111" title="Compares this URL with another one.">equals</a>( u, ignore_trailing );
<a name="l01157"></a>01157 }
<a name="l01158"></a>01158 
<a name="l01159"></a><a class="code" href="classKURL.html#a373b2cd2d283db2a94f7cf00483d5111">01159</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#a373b2cd2d283db2a94f7cf00483d5111" title="Compares this URL with another one.">KURL::equals</a>( <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> &amp;_u, <span class="keywordtype">bool</span> ignore_trailing )<span class="keyword"> const</span>
<a name="l01160"></a>01160 <span class="keyword"></span>{
<a name="l01161"></a>01161   <span class="keywordflow">if</span> ( !<a class="code" href="classKURL.html#ad8b823d40572ca24b6983d868847c251" title="Tests if the URL is well formed.">isValid</a>() || !_u.<a class="code" href="classKURL.html#ad8b823d40572ca24b6983d868847c251" title="Tests if the URL is well formed.">isValid</a>() )
<a name="l01162"></a>01162     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01163"></a>01163 
<a name="l01164"></a>01164   <span class="keywordflow">if</span> ( ignore_trailing )
<a name="l01165"></a>01165   {
<a name="l01166"></a>01166     <a class="codeRef" href="qstring.html">QString</a> path1 = <a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>(1);
<a name="l01167"></a>01167     <a class="codeRef" href="qstring.html">QString</a> path2 = _u.<a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>(1);
<a name="l01168"></a>01168     <span class="keywordflow">if</span> ( path1 != path2 )
<a name="l01169"></a>01169       <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01170"></a>01170 
<a name="l01171"></a>01171     <span class="keywordflow">if</span> ( m_strProtocol == _u.m_strProtocol &amp;&amp;
<a name="l01172"></a>01172          m_strUser == _u.m_strUser &amp;&amp;
<a name="l01173"></a>01173          m_strPass == _u.m_strPass &amp;&amp;
<a name="l01174"></a>01174          m_strHost == _u.m_strHost &amp;&amp;
<a name="l01175"></a>01175          m_strQuery_encoded == _u.m_strQuery_encoded &amp;&amp;
<a name="l01176"></a>01176          m_strRef_encoded == _u.m_strRef_encoded &amp;&amp;
<a name="l01177"></a>01177          m_iPort == _u.m_iPort )
<a name="l01178"></a>01178       <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01179"></a>01179 
<a name="l01180"></a>01180     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01181"></a>01181   }
<a name="l01182"></a>01182 
<a name="l01183"></a>01183   <span class="keywordflow">return</span> ( *<span class="keyword">this</span> == _u );
<a name="l01184"></a>01184 }
<a name="l01185"></a>01185 
<a name="l01186"></a><a class="code" href="classKURL.html#a969ac5a396980191f14a459e1d0d6000">01186</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#a969ac5a396980191f14a459e1d0d6000" title="Tests if the given URL is parent of this URL.">KURL::isParentOf</a>( <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; _u )<span class="keyword"> const</span>
<a name="l01187"></a>01187 <span class="keyword"></span>{
<a name="l01188"></a>01188   <span class="keywordflow">if</span> ( !<a class="code" href="classKURL.html#ad8b823d40572ca24b6983d868847c251" title="Tests if the URL is well formed.">isValid</a>() || !_u.<a class="code" href="classKURL.html#ad8b823d40572ca24b6983d868847c251" title="Tests if the URL is well formed.">isValid</a>() )
<a name="l01189"></a>01189     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01190"></a>01190 
<a name="l01191"></a>01191   <span class="keywordflow">if</span> ( m_strProtocol == _u.m_strProtocol &amp;&amp;
<a name="l01192"></a>01192        m_strUser == _u.m_strUser &amp;&amp;
<a name="l01193"></a>01193        m_strPass == _u.m_strPass &amp;&amp;
<a name="l01194"></a>01194        m_strHost == _u.m_strHost &amp;&amp;
<a name="l01195"></a>01195        m_strQuery_encoded == _u.m_strQuery_encoded &amp;&amp;
<a name="l01196"></a>01196        m_strRef_encoded == _u.m_strRef_encoded &amp;&amp;
<a name="l01197"></a>01197        m_iPort == _u.m_iPort )
<a name="l01198"></a>01198   {
<a name="l01199"></a>01199     <span class="keywordflow">if</span> ( <a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>().<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || _u.<a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>().<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l01200"></a>01200         <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// can&#39;t work with implicit paths</span>
<a name="l01201"></a>01201 
<a name="l01202"></a>01202     <a class="codeRef" href="qstring.html">QString</a> p1( cleanpath( <a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>(), <span class="keyword">true</span>, <span class="keyword">false</span> ) );
<a name="l01203"></a>01203     <span class="keywordflow">if</span> ( p1[p1.<a class="codeRef" href="qstring.html#length">length</a>()-1] != <span class="charliteral">&#39;/&#39;</span> )
<a name="l01204"></a>01204         p1 += <span class="charliteral">&#39;/&#39;</span>;
<a name="l01205"></a>01205     <a class="codeRef" href="qstring.html">QString</a> p2( cleanpath( _u.<a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>(), <span class="keyword">true</span>, false ) );
<a name="l01206"></a>01206     <span class="keywordflow">if</span> ( p2[p2.<a class="codeRef" href="qstring.html#length">length</a>()-1] != <span class="charliteral">&#39;/&#39;</span> )
<a name="l01207"></a>01207         p2 += <span class="charliteral">&#39;/&#39;</span>;
<a name="l01208"></a>01208 
<a name="l01209"></a>01209     <span class="comment">//kdDebug(126) &lt;&lt; &quot;p1=&quot; &lt;&lt; p1 &lt;&lt; endl;</span>
<a name="l01210"></a>01210     <span class="comment">//kdDebug(126) &lt;&lt; &quot;p2=&quot; &lt;&lt; p2 &lt;&lt; endl;</span>
<a name="l01211"></a>01211     <span class="comment">//kdDebug(126) &lt;&lt; &quot;p1.length()=&quot; &lt;&lt; p1.length() &lt;&lt; endl;</span>
<a name="l01212"></a>01212     <span class="comment">//kdDebug(126) &lt;&lt; &quot;p2.left(!$)=&quot; &lt;&lt; p2.left( p1.length() ) &lt;&lt; endl;</span>
<a name="l01213"></a>01213     <span class="keywordflow">return</span> p2.<a class="codeRef" href="qstring.html#startsWith">startsWith</a>( p1 );
<a name="l01214"></a>01214   }
<a name="l01215"></a>01215   <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01216"></a>01216 }
<a name="l01217"></a>01217 
<a name="l01218"></a><a class="code" href="classKURL.html#a8a068268c1128fea91eb2cc17ccad5ce">01218</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a8a068268c1128fea91eb2cc17ccad5ce" title="Sets the filename of the path.">KURL::setFileName</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _txt )
<a name="l01219"></a>01219 {
<a name="l01220"></a>01220   m_strRef_encoded = QString::null;
<a name="l01221"></a>01221   <span class="keywordtype">int</span> i = 0;
<a name="l01222"></a>01222   <span class="keywordflow">while</span>( _txt[i] == <span class="charliteral">&#39;/&#39;</span> ) ++i;
<a name="l01223"></a>01223   <a class="codeRef" href="qstring.html">QString</a> tmp;
<a name="l01224"></a>01224   <span class="keywordflow">if</span> ( i )
<a name="l01225"></a>01225     tmp = _txt.<a class="codeRef" href="qstring.html#mid">mid</a>( i );
<a name="l01226"></a>01226   <span class="keywordflow">else</span>
<a name="l01227"></a>01227     tmp = _txt;
<a name="l01228"></a>01228 
<a name="l01229"></a>01229   <a class="codeRef" href="qstring.html">QString</a> path = m_strPath_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ? m_strPath : m_strPath_encoded;
<a name="l01230"></a>01230   <span class="keywordflow">if</span> ( path.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l01231"></a>01231     path = <span class="stringliteral">&quot;/&quot;</span>;
<a name="l01232"></a>01232   <span class="keywordflow">else</span>
<a name="l01233"></a>01233   {
<a name="l01234"></a>01234     <span class="keywordtype">int</span> lastSlash = path.<a class="codeRef" href="qstring.html#findRev">findRev</a>( <span class="charliteral">&#39;/&#39;</span> );
<a name="l01235"></a>01235     <span class="keywordflow">if</span> ( lastSlash == -1)
<a name="l01236"></a>01236     {
<a name="l01237"></a>01237       <span class="comment">// The first character is not a &#39;/&#39; ???</span>
<a name="l01238"></a>01238       <span class="comment">// This looks strange ...</span>
<a name="l01239"></a>01239       path = <span class="stringliteral">&quot;/&quot;</span>;
<a name="l01240"></a>01240     }
<a name="l01241"></a>01241     <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( path.<a class="codeRef" href="qstring.html#right">right</a>(1) != <span class="stringliteral">&quot;/&quot;</span> )
<a name="l01242"></a>01242       path.<a class="codeRef" href="qstring.html#truncate">truncate</a>( lastSlash+1 ); <span class="comment">// keep the &quot;/&quot;</span>
<a name="l01243"></a>01243   }
<a name="l01244"></a>01244   <span class="keywordflow">if</span> (m_strPath_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01245"></a>01245   {
<a name="l01246"></a>01246      path += tmp;
<a name="l01247"></a>01247      <a class="code" href="classKURL.html#a6c0a0828b4b9f1126b13380076e2b2f3" title="Sets the decoded path of the URL.">setPath</a>( path );
<a name="l01248"></a>01248   }
<a name="l01249"></a>01249   <span class="keywordflow">else</span>
<a name="l01250"></a>01250   {
<a name="l01251"></a>01251      path += <a class="code" href="classKURL.html#a5a12896c25a17ab12abf2097a7c75713" title="Encodes a string for use in URLs.">encode_string</a>(tmp);
<a name="l01252"></a>01252      <a class="code" href="classKURL.html#aab26a52864a868ea2eddb5e9e7c9057e" title="Sets the (already encoded) path of the URL.">setEncodedPath</a>( path );
<a name="l01253"></a>01253   }
<a name="l01254"></a>01254   <a class="code" href="classKURL.html#aa4f7e51dc176f53f6e25a89195b04477" title="Resolves &quot;.&quot; and &quot;..&quot; components in path.">cleanPath</a>();
<a name="l01255"></a>01255 }
<a name="l01256"></a>01256 
<a name="l01257"></a><a class="code" href="classKURL.html#aa4f7e51dc176f53f6e25a89195b04477">01257</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#aa4f7e51dc176f53f6e25a89195b04477" title="Resolves &quot;.&quot; and &quot;..&quot; components in path.">KURL::cleanPath</a>( <span class="keywordtype">bool</span> cleanDirSeparator ) <span class="comment">// taken from the old KURL</span>
<a name="l01258"></a>01258 {
<a name="l01259"></a>01259   <span class="keywordflow">if</span> (m_iUriMode != <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a>) <span class="keywordflow">return</span>;
<a name="l01260"></a>01260   m_strPath = cleanpath(m_strPath, cleanDirSeparator, <span class="keyword">false</span>);
<a name="l01261"></a>01261   <span class="comment">// WABA: Is this safe when &quot;/../&quot; is encoded with %?</span>
<a name="l01262"></a>01262   m_strPath_encoded = cleanpath(m_strPath_encoded, cleanDirSeparator, <span class="keyword">true</span>);
<a name="l01263"></a>01263 }
<a name="l01264"></a>01264 
<a name="l01265"></a>01265 <span class="keyword">static</span> <a class="codeRef" href="qstring.html">QString</a> trailingSlash( <span class="keywordtype">int</span> _trailing, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;path )
<a name="l01266"></a>01266 {
<a name="l01267"></a>01267   <a class="codeRef" href="qstring.html">QString</a> result = <a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>;
<a name="l01268"></a>01268 
<a name="l01269"></a>01269   <span class="keywordflow">if</span> ( _trailing == 0 )
<a name="l01270"></a>01270     <span class="keywordflow">return</span> result;
<a name="l01271"></a>01271   <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( _trailing == 1 )
<a name="l01272"></a>01272   {
<a name="l01273"></a>01273     <span class="keywordtype">int</span> len = result.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l01274"></a>01274     <span class="keywordflow">if</span> ( (len == 0) || (result[ len - 1 ] != <span class="charliteral">&#39;/&#39;</span>) )
<a name="l01275"></a>01275       result += <span class="stringliteral">&quot;/&quot;</span>;
<a name="l01276"></a>01276     <span class="keywordflow">return</span> result;
<a name="l01277"></a>01277   }
<a name="l01278"></a>01278   <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( _trailing == -1 )
<a name="l01279"></a>01279   {
<a name="l01280"></a>01280     <span class="keywordflow">if</span> ( result == <span class="stringliteral">&quot;/&quot;</span> )
<a name="l01281"></a>01281       <span class="keywordflow">return</span> result;
<a name="l01282"></a>01282     <span class="keywordtype">int</span> len = result.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l01283"></a>01283     <span class="keywordflow">while</span> (len &gt; 1 &amp;&amp; result[ len - 1 ] == <span class="charliteral">&#39;/&#39;</span>)
<a name="l01284"></a>01284     {
<a name="l01285"></a>01285       len--;
<a name="l01286"></a>01286     }
<a name="l01287"></a>01287     result.<a class="codeRef" href="qstring.html#truncate">truncate</a>( len );
<a name="l01288"></a>01288     <span class="keywordflow">return</span> result;
<a name="l01289"></a>01289   }
<a name="l01290"></a>01290   <span class="keywordflow">else</span> {
<a name="l01291"></a>01291     assert( 0 );
<a name="l01292"></a>01292     <span class="keywordflow">return</span> QString::null;
<a name="l01293"></a>01293   }
<a name="l01294"></a>01294 }
<a name="l01295"></a>01295 
<a name="l01296"></a><a class="code" href="classKURL.html#a13576bca04c106cb92a7c33c36495654">01296</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a13576bca04c106cb92a7c33c36495654" title="Adds or removes a trailing slash to/from the path.">KURL::adjustPath</a>( <span class="keywordtype">int</span> _trailing )
<a name="l01297"></a>01297 {
<a name="l01298"></a>01298   <span class="keywordflow">if</span> (!m_strPath_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01299"></a>01299   {
<a name="l01300"></a>01300      m_strPath_encoded = trailingSlash( _trailing, m_strPath_encoded );
<a name="l01301"></a>01301   }
<a name="l01302"></a>01302   m_strPath = trailingSlash( _trailing, m_strPath );
<a name="l01303"></a>01303 }
<a name="l01304"></a>01304 
<a name="l01305"></a>01305 
<a name="l01306"></a><a class="code" href="classKURL.html#a12bb2c946469dafcc86989b2bca4dd4c">01306</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a12bb2c946469dafcc86989b2bca4dd4c" title="Returns the encoded path and the query.">KURL::encodedPathAndQuery</a>( <span class="keywordtype">int</span> _trailing, <span class="keywordtype">bool</span> _no_empty_path, <span class="keywordtype">int</span> encoding_hint )<span class="keyword"> const</span>
<a name="l01307"></a>01307 <span class="keyword"></span>{
<a name="l01308"></a>01308   <a class="codeRef" href="qstring.html">QString</a> tmp;
<a name="l01309"></a>01309   <span class="keywordflow">if</span> (!m_strPath_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() &amp;&amp; encoding_hint == 0)
<a name="l01310"></a>01310   {
<a name="l01311"></a>01311      tmp = trailingSlash( _trailing, m_strPath_encoded );
<a name="l01312"></a>01312   }
<a name="l01313"></a>01313   <span class="keywordflow">else</span>
<a name="l01314"></a>01314   {
<a name="l01315"></a>01315      tmp = <a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>( _trailing );
<a name="l01316"></a>01316      <span class="keywordflow">if</span> ( _no_empty_path &amp;&amp; tmp.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l01317"></a>01317         tmp = <span class="stringliteral">&quot;/&quot;</span>;
<a name="l01318"></a>01318      <span class="keywordflow">if</span> (m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25add1a21fcdf4c90f451c256191553c6f7" title="Mailto URI.">Mailto</a>)
<a name="l01319"></a>01319      {
<a name="l01320"></a>01320         tmp = encode( tmp, 2, encoding_hint );
<a name="l01321"></a>01321      }
<a name="l01322"></a>01322      <span class="keywordflow">else</span>
<a name="l01323"></a>01323      {
<a name="l01324"></a>01324         tmp = encode( tmp, 1, encoding_hint );
<a name="l01325"></a>01325      }
<a name="l01326"></a>01326   }
<a name="l01327"></a>01327 
<a name="l01328"></a>01328   <span class="comment">// TODO apply encoding_hint to the query</span>
<a name="l01329"></a>01329   <span class="keywordflow">if</span> (!m_strQuery_encoded.<a class="codeRef" href="qstring.html#isNull">isNull</a>())
<a name="l01330"></a>01330       tmp += <span class="charliteral">&#39;?&#39;</span> + m_strQuery_encoded;
<a name="l01331"></a>01331   <span class="keywordflow">return</span> tmp;
<a name="l01332"></a>01332 }
<a name="l01333"></a>01333 
<a name="l01334"></a><a class="code" href="classKURL.html#aab26a52864a868ea2eddb5e9e7c9057e">01334</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#aab26a52864a868ea2eddb5e9e7c9057e" title="Sets the (already encoded) path of the URL.">KURL::setEncodedPath</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _txt, <span class="keywordtype">int</span> encoding_hint )
<a name="l01335"></a>01335 {
<a name="l01336"></a>01336   m_strPath_encoded = _txt;
<a name="l01337"></a>01337 
<a name="l01338"></a>01338   decode( m_strPath_encoded, m_strPath, m_strPath_encoded, encoding_hint );
<a name="l01339"></a>01339   <span class="comment">// Throw away encoding for local files, makes file-operations faster.</span>
<a name="l01340"></a>01340   <span class="keywordflow">if</span> (m_strProtocol == fileProt)
<a name="l01341"></a>01341      m_strPath_encoded = QString::null;
<a name="l01342"></a>01342 
<a name="l01343"></a>01343   <span class="keywordflow">if</span> ( m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a9db85130d0702a27e41777d7c767acca" title="Automatically detected.">Auto</a> )
<a name="l01344"></a>01344     m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a>;
<a name="l01345"></a>01345 }
<a name="l01346"></a>01346 
<a name="l01347"></a>01347 
<a name="l01348"></a><a class="code" href="classKURL.html#ad243d1d3d12cdf0828b95203dc440284">01348</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#ad243d1d3d12cdf0828b95203dc440284" title="Sets both path and query of the URL in their encoded form.">KURL::setEncodedPathAndQuery</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _txt, <span class="keywordtype">int</span> encoding_hint )
<a name="l01349"></a>01349 {
<a name="l01350"></a>01350   <span class="keywordtype">int</span> pos = _txt.<a class="codeRef" href="qstring.html#find">find</a>( <span class="charliteral">&#39;?&#39;</span> );
<a name="l01351"></a>01351   <span class="keywordflow">if</span> ( pos == -1 )
<a name="l01352"></a>01352   {
<a name="l01353"></a>01353     <a class="code" href="classKURL.html#aab26a52864a868ea2eddb5e9e7c9057e" title="Sets the (already encoded) path of the URL.">setEncodedPath</a>(_txt, encoding_hint);
<a name="l01354"></a>01354     m_strQuery_encoded = QString::null;
<a name="l01355"></a>01355   }
<a name="l01356"></a>01356   <span class="keywordflow">else</span>
<a name="l01357"></a>01357   {
<a name="l01358"></a>01358     <a class="code" href="classKURL.html#aab26a52864a868ea2eddb5e9e7c9057e" title="Sets the (already encoded) path of the URL.">setEncodedPath</a>(_txt.<a class="codeRef" href="qstring.html#left">left</a>( pos ), encoding_hint);
<a name="l01359"></a>01359     _setQuery(_txt.<a class="codeRef" href="qstring.html#right">right</a>(_txt.<a class="codeRef" href="qstring.html#length">length</a>() - pos - 1), encoding_hint);
<a name="l01360"></a>01360   }
<a name="l01361"></a>01361 }
<a name="l01362"></a>01362 
<a name="l01363"></a><a class="code" href="classKURL.html#a0fd6a984e0f2e0fe38e1f67a11a98ff9">01363</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">KURL::path</a>( <span class="keywordtype">int</span> _trailing )<span class="keyword"> const</span>
<a name="l01364"></a>01364 <span class="keyword"></span>{
<a name="l01365"></a>01365   <span class="keywordflow">return</span> trailingSlash( _trailing, <a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>() );
<a name="l01366"></a>01366 }
<a name="l01367"></a>01367 
<a name="l01368"></a><a class="code" href="classKURL.html#a942448c47652c6453f3c6ce59ae62731">01368</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#a942448c47652c6453f3c6ce59ae62731" title="Tests if the file is local.">KURL::isLocalFile</a>()<span class="keyword"> const</span>
<a name="l01369"></a>01369 <span class="keyword"></span>{
<a name="l01370"></a>01370   <span class="keywordflow">if</span> ( (m_strProtocol != fileProt ) || <a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>() )
<a name="l01371"></a>01371      <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01372"></a>01372 
<a name="l01373"></a>01373   <span class="keywordflow">if</span> (m_strHost.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || (m_strHost == <span class="stringliteral">&quot;localhost&quot;</span>))
<a name="l01374"></a>01374      <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01375"></a>01375 
<a name="l01376"></a>01376   <span class="keywordtype">char</span> hostname[ 256 ];
<a name="l01377"></a>01377   hostname[ 0 ] = <span class="charliteral">&#39;\0&#39;</span>;
<a name="l01378"></a>01378   <span class="keywordflow">if</span> (!gethostname( hostname, 255 ))
<a name="l01379"></a>01379      hostname[<span class="keyword">sizeof</span>(hostname)-1] = <span class="charliteral">&#39;\0&#39;</span>;
<a name="l01380"></a>01380 
<a name="l01381"></a>01381   <span class="keywordflow">for</span>(<span class="keywordtype">char</span> *p = hostname; *p; p++)
<a name="l01382"></a>01382      *p = tolower(*p);
<a name="l01383"></a>01383 
<a name="l01384"></a>01384   <span class="keywordflow">return</span> (m_strHost == hostname);
<a name="l01385"></a>01385 }
<a name="l01386"></a>01386 
<a name="l01387"></a><a class="code" href="classKURL.html#ac3baacf0bb1d8f98970ea301a576dcdd">01387</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#ac3baacf0bb1d8f98970ea301a576dcdd" title="Adds file encoding information.">KURL::setFileEncoding</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;encoding)
<a name="l01388"></a>01388 {
<a name="l01389"></a>01389   <span class="keywordflow">if</span> (!<a class="code" href="classKURL.html#a942448c47652c6453f3c6ce59ae62731" title="Tests if the file is local.">isLocalFile</a>())
<a name="l01390"></a>01390      <span class="keywordflow">return</span>;
<a name="l01391"></a>01391 
<a name="l01392"></a>01392   <a class="codeRef" href="qstring.html">QString</a> q = <a class="code" href="classKURL.html#a0a28c0873806d04a7fd4e19feeb4bd63" title="Returns the encoded query of the URL.">query</a>();
<a name="l01393"></a>01393 
<a name="l01394"></a>01394   <span class="keywordflow">if</span> (!q.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() &amp;&amp; (q[0] == <span class="charliteral">&#39;?&#39;</span>))
<a name="l01395"></a>01395      q = q.<a class="codeRef" href="qstring.html#mid">mid</a>(1);
<a name="l01396"></a>01396 
<a name="l01397"></a>01397   <a class="codeRef" href="qstringlist.html">QStringList</a> args = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">QStringList::split</a>(<span class="charliteral">&#39;&amp;&#39;</span>, q);
<a name="l01398"></a>01398   <span class="keywordflow">for</span>(QStringList::Iterator it = args.begin();
<a name="l01399"></a>01399       it != args.end();)
<a name="l01400"></a>01400   {
<a name="l01401"></a>01401       <a class="codeRef" href="qstring.html">QString</a> s = <a class="code" href="classKURL.html#abbdd1c868880355a4eb6daa4a71926b0" title="Decodes a string as used in URLs.">decode_string</a>(*it);
<a name="l01402"></a>01402       <span class="keywordflow">if</span> (s.<a class="codeRef" href="qstring.html#startsWith">startsWith</a>(<span class="stringliteral">&quot;charset=&quot;</span>))
<a name="l01403"></a>01403          it = args.erase(it);
<a name="l01404"></a>01404       <span class="keywordflow">else</span>
<a name="l01405"></a>01405          ++it;
<a name="l01406"></a>01406   }
<a name="l01407"></a>01407   <span class="keywordflow">if</span> (!encoding.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01408"></a>01408      args.append(<span class="stringliteral">&quot;charset=&quot;</span>+encode_string(encoding));
<a name="l01409"></a>01409 
<a name="l01410"></a>01410   <span class="keywordflow">if</span> (args.isEmpty())
<a name="l01411"></a>01411      _setQuery(QString::null);
<a name="l01412"></a>01412   <span class="keywordflow">else</span>
<a name="l01413"></a>01413      _setQuery(args.<a class="codeRef" href="qstringlist.html#join">join</a>(<span class="stringliteral">&quot;&amp;&quot;</span>));
<a name="l01414"></a>01414 }
<a name="l01415"></a>01415 
<a name="l01416"></a><a class="code" href="classKURL.html#a49785c16a6ee9805236aaa210dfde124">01416</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a49785c16a6ee9805236aaa210dfde124" title="Returns encoding information of the URL.">KURL::fileEncoding</a>()<span class="keyword"> const</span>
<a name="l01417"></a>01417 <span class="keyword"></span>{
<a name="l01418"></a>01418   <span class="keywordflow">if</span> (!<a class="code" href="classKURL.html#a942448c47652c6453f3c6ce59ae62731" title="Tests if the file is local.">isLocalFile</a>())
<a name="l01419"></a>01419      <span class="keywordflow">return</span> QString::null;
<a name="l01420"></a>01420 
<a name="l01421"></a>01421   <a class="codeRef" href="qstring.html">QString</a> q = <a class="code" href="classKURL.html#a0a28c0873806d04a7fd4e19feeb4bd63" title="Returns the encoded query of the URL.">query</a>();
<a name="l01422"></a>01422 
<a name="l01423"></a>01423   <span class="keywordflow">if</span> (q.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01424"></a>01424      <span class="keywordflow">return</span> QString::null;
<a name="l01425"></a>01425 
<a name="l01426"></a>01426   <span class="keywordflow">if</span> (q[0] == <span class="charliteral">&#39;?&#39;</span>)
<a name="l01427"></a>01427      q = q.<a class="codeRef" href="qstring.html#mid">mid</a>(1);
<a name="l01428"></a>01428 
<a name="l01429"></a>01429   <a class="codeRef" href="qstringlist.html">QStringList</a> args = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">QStringList::split</a>(<span class="charliteral">&#39;&amp;&#39;</span>, q);
<a name="l01430"></a>01430   <span class="keywordflow">for</span>(QStringList::ConstIterator it = args.begin();
<a name="l01431"></a>01431       it != args.end();
<a name="l01432"></a>01432       ++it)
<a name="l01433"></a>01433   {
<a name="l01434"></a>01434       <a class="codeRef" href="qstring.html">QString</a> s = <a class="code" href="classKURL.html#abbdd1c868880355a4eb6daa4a71926b0" title="Decodes a string as used in URLs.">decode_string</a>(*it);
<a name="l01435"></a>01435       <span class="keywordflow">if</span> (s.<a class="codeRef" href="qstring.html#startsWith">startsWith</a>(<span class="stringliteral">&quot;charset=&quot;</span>))
<a name="l01436"></a>01436          <span class="keywordflow">return</span> s.<a class="codeRef" href="qstring.html#mid">mid</a>(8);
<a name="l01437"></a>01437   }
<a name="l01438"></a>01438   <span class="keywordflow">return</span> QString::null;
<a name="l01439"></a>01439 }
<a name="l01440"></a>01440 
<a name="l01441"></a><a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb">01441</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">KURL::hasSubURL</a>()<span class="keyword"> const</span>
<a name="l01442"></a>01442 <span class="keyword"></span>{
<a name="l01443"></a>01443   <span class="keywordflow">if</span> ( m_strProtocol.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || m_bIsMalformed )
<a name="l01444"></a>01444     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01445"></a>01445   <span class="keywordflow">if</span> (m_strRef_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01446"></a>01446      <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01447"></a>01447   <span class="keywordflow">if</span> (m_strRef_encoded.<a class="codeRef" href="qstring.html#startsWith">startsWith</a>(<span class="stringliteral">&quot;gzip:&quot;</span>))
<a name="l01448"></a>01448      <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01449"></a>01449   <span class="keywordflow">if</span> (m_strRef_encoded.<a class="codeRef" href="qstring.html#startsWith">startsWith</a>(<span class="stringliteral">&quot;bzip:&quot;</span>))
<a name="l01450"></a>01450      <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01451"></a>01451   <span class="keywordflow">if</span> (m_strRef_encoded.<a class="codeRef" href="qstring.html#startsWith">startsWith</a>(<span class="stringliteral">&quot;bzip2:&quot;</span>))
<a name="l01452"></a>01452      <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01453"></a>01453   <span class="keywordflow">if</span> (m_strRef_encoded.<a class="codeRef" href="qstring.html#startsWith">startsWith</a>(<span class="stringliteral">&quot;tar:&quot;</span>))
<a name="l01454"></a>01454      <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01455"></a>01455   <span class="keywordflow">if</span> (m_strRef_encoded.<a class="codeRef" href="qstring.html#startsWith">startsWith</a>(<span class="stringliteral">&quot;ar:&quot;</span>))
<a name="l01456"></a>01456      <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01457"></a>01457   <span class="keywordflow">if</span> (m_strRef_encoded.<a class="codeRef" href="qstring.html#startsWith">startsWith</a>(<span class="stringliteral">&quot;zip:&quot;</span>))
<a name="l01458"></a>01458      <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01459"></a>01459   <span class="keywordflow">if</span> ( m_strProtocol == <span class="stringliteral">&quot;error&quot;</span> ) <span class="comment">// anything that starts with error: has suburls</span>
<a name="l01460"></a>01460      <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01461"></a>01461   <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01462"></a>01462 }
<a name="l01463"></a>01463 
<a name="l01464"></a><a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a">01464</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">KURL::url</a>( <span class="keywordtype">int</span> _trailing, <span class="keywordtype">int</span> encoding_hint )<span class="keyword"> const</span>
<a name="l01465"></a>01465 <span class="keyword"></span>{
<a name="l01466"></a>01466   <span class="keywordflow">if</span>( m_bIsMalformed )
<a name="l01467"></a>01467   {
<a name="l01468"></a>01468     <span class="comment">// Return the whole url even when the url is</span>
<a name="l01469"></a>01469     <span class="comment">// malformed.  Under such conditions the url</span>
<a name="l01470"></a>01470     <span class="comment">// is stored in m_strProtocol.</span>
<a name="l01471"></a>01471     <span class="keywordflow">return</span> m_strProtocol;
<a name="l01472"></a>01472   }
<a name="l01473"></a>01473 
<a name="l01474"></a>01474   <a class="codeRef" href="qstring.html">QString</a> u = m_strProtocol;
<a name="l01475"></a>01475   <span class="keywordflow">if</span> (!u.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01476"></a>01476     u += <span class="stringliteral">&quot;:&quot;</span>;
<a name="l01477"></a>01477 
<a name="l01478"></a>01478   <span class="keywordflow">if</span> ( <a class="code" href="classKURL.html#ae086bae03d0eb7b01c1d4775ff008734" title="Tests if this URL has a hostname included in it.">hasHost</a>() || (m_strProtocol == fileProt) )
<a name="l01479"></a>01479   {
<a name="l01480"></a>01480     u += <span class="stringliteral">&quot;//&quot;</span>;
<a name="l01481"></a>01481     <span class="keywordflow">if</span> ( <a class="code" href="classKURL.html#a2c6b8f18351722e9280b99d869572989" title="Tests if this URL has a user name included in it.">hasUser</a>() )
<a name="l01482"></a>01482     {
<a name="l01483"></a>01483       u += encode(m_strUser, 0, encoding_hint);
<a name="l01484"></a>01484       <span class="keywordflow">if</span> ( <a class="code" href="classKURL.html#ab6aa391061678b69b314a6b403d0ace2" title="Tests if this URL has a password included in it.">hasPass</a>() )
<a name="l01485"></a>01485       {
<a name="l01486"></a>01486         u += <span class="stringliteral">&quot;:&quot;</span>;
<a name="l01487"></a>01487         u += encode(m_strPass, 0, encoding_hint);
<a name="l01488"></a>01488       }
<a name="l01489"></a>01489       u += <span class="stringliteral">&quot;@&quot;</span>;
<a name="l01490"></a>01490     }
<a name="l01491"></a>01491     <span class="keywordflow">if</span> ( m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a> )
<a name="l01492"></a>01492     {
<a name="l01493"></a>01493       <span class="keywordtype">bool</span> IPv6 = (m_strHost.<a class="codeRef" href="qstring.html#find">find</a>(<span class="charliteral">&#39;:&#39;</span>) != -1);
<a name="l01494"></a>01494       <span class="keywordflow">if</span> (IPv6)
<a name="l01495"></a>01495         u += <span class="charliteral">&#39;[&#39;</span> + m_strHost + <span class="charliteral">&#39;]&#39;</span>;
<a name="l01496"></a>01496       <span class="keywordflow">else</span>
<a name="l01497"></a>01497         u += encodeHost(m_strHost, <span class="keyword">true</span>, encoding_hint);
<a name="l01498"></a>01498       <span class="keywordflow">if</span> ( m_iPort != 0 ) {
<a name="l01499"></a>01499         <a class="codeRef" href="qstring.html">QString</a> buffer;
<a name="l01500"></a>01500         buffer.<a class="codeRef" href="qstring.html#sprintf">sprintf</a>( <span class="stringliteral">&quot;:%u&quot;</span>, m_iPort );
<a name="l01501"></a>01501         u += buffer;
<a name="l01502"></a>01502       }
<a name="l01503"></a>01503     }
<a name="l01504"></a>01504     <span class="keywordflow">else</span>
<a name="l01505"></a>01505     {
<a name="l01506"></a>01506       u += m_strHost;
<a name="l01507"></a>01507     }
<a name="l01508"></a>01508   }
<a name="l01509"></a>01509 
<a name="l01510"></a>01510   <span class="keywordflow">if</span> ( m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a> || m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25add1a21fcdf4c90f451c256191553c6f7" title="Mailto URI.">Mailto</a> )
<a name="l01511"></a>01511     u += <a class="code" href="classKURL.html#a12bb2c946469dafcc86989b2bca4dd4c" title="Returns the encoded path and the query.">encodedPathAndQuery</a>( _trailing, <span class="keyword">false</span>, encoding_hint );
<a name="l01512"></a>01512   <span class="keywordflow">else</span>
<a name="l01513"></a>01513     u += encode( m_strPath, 21, encoding_hint, <span class="keyword">true</span> );
<a name="l01514"></a>01514 
<a name="l01515"></a>01515   <span class="keywordflow">if</span> ( <a class="code" href="classKURL.html#add38e3181b6ebf71290f0353d6630518" title="Tests if the URL has a reference part.">hasRef</a>() )
<a name="l01516"></a>01516   {
<a name="l01517"></a>01517     u += <span class="stringliteral">&quot;#&quot;</span>;
<a name="l01518"></a>01518     u += m_strRef_encoded;
<a name="l01519"></a>01519   }
<a name="l01520"></a>01520 
<a name="l01521"></a>01521   <span class="keywordflow">return</span> u;
<a name="l01522"></a>01522 }
<a name="l01523"></a>01523 
<a name="l01524"></a><a class="code" href="classKURL.html#a9382bc0e035124e884f755cff962530f">01524</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a9382bc0e035124e884f755cff962530f" title="Returns the URL as string in human-friendly format.">KURL::prettyURL</a>( <span class="keywordtype">int</span> _trailing )<span class="keyword"> const</span>
<a name="l01525"></a>01525 <span class="keyword"></span>{
<a name="l01526"></a>01526   <span class="keywordflow">if</span>( m_bIsMalformed )
<a name="l01527"></a>01527   {
<a name="l01528"></a>01528     <span class="comment">// Return the whole url even when the url is</span>
<a name="l01529"></a>01529     <span class="comment">// malformed.  Under such conditions the url</span>
<a name="l01530"></a>01530     <span class="comment">// is stored in m_strProtocol.</span>
<a name="l01531"></a>01531     <span class="keywordflow">return</span> m_strProtocol;
<a name="l01532"></a>01532   }
<a name="l01533"></a>01533 
<a name="l01534"></a>01534   <a class="codeRef" href="qstring.html">QString</a> u = m_strProtocol;
<a name="l01535"></a>01535   <span class="keywordflow">if</span> (!u.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01536"></a>01536      u += <span class="stringliteral">&quot;:&quot;</span>;
<a name="l01537"></a>01537 
<a name="l01538"></a>01538   <span class="keywordflow">if</span> ( <a class="code" href="classKURL.html#ae086bae03d0eb7b01c1d4775ff008734" title="Tests if this URL has a hostname included in it.">hasHost</a>() || (m_strProtocol == fileProt) )
<a name="l01539"></a>01539   {
<a name="l01540"></a>01540     u += <span class="stringliteral">&quot;//&quot;</span>;
<a name="l01541"></a>01541     <span class="keywordflow">if</span> ( <a class="code" href="classKURL.html#a2c6b8f18351722e9280b99d869572989" title="Tests if this URL has a user name included in it.">hasUser</a>() )
<a name="l01542"></a>01542     {
<a name="l01543"></a>01543       u += encode(m_strUser, 0, 0);
<a name="l01544"></a>01544       <span class="comment">// Don&#39;t show password!</span>
<a name="l01545"></a>01545       u += <span class="stringliteral">&quot;@&quot;</span>;
<a name="l01546"></a>01546     }
<a name="l01547"></a>01547     <span class="keywordflow">if</span> ( m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a> )
<a name="l01548"></a>01548     {
<a name="l01549"></a>01549     <span class="keywordtype">bool</span> IPv6 = (m_strHost.<a class="codeRef" href="qstring.html#find">find</a>(<span class="charliteral">&#39;:&#39;</span>) != -1);
<a name="l01550"></a>01550     <span class="keywordflow">if</span> (IPv6)
<a name="l01551"></a>01551     {
<a name="l01552"></a>01552        u += <span class="charliteral">&#39;[&#39;</span> + m_strHost + <span class="charliteral">&#39;]&#39;</span>;
<a name="l01553"></a>01553     }
<a name="l01554"></a>01554     <span class="keywordflow">else</span>
<a name="l01555"></a>01555     {
<a name="l01556"></a>01556        u += lazy_encode(m_strHost);
<a name="l01557"></a>01557     }
<a name="l01558"></a>01558     }
<a name="l01559"></a>01559     <span class="keywordflow">else</span>
<a name="l01560"></a>01560     {
<a name="l01561"></a>01561       u += lazy_encode(m_strHost);
<a name="l01562"></a>01562     }
<a name="l01563"></a>01563     <span class="keywordflow">if</span> ( m_iPort != 0 ) {
<a name="l01564"></a>01564       <a class="codeRef" href="qstring.html">QString</a> buffer;
<a name="l01565"></a>01565       buffer.<a class="codeRef" href="qstring.html#sprintf">sprintf</a>( <span class="stringliteral">&quot;:%u&quot;</span>, m_iPort );
<a name="l01566"></a>01566       u += buffer;
<a name="l01567"></a>01567     }
<a name="l01568"></a>01568   }
<a name="l01569"></a>01569 
<a name="l01570"></a>01570   <span class="keywordflow">if</span> (m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25add1a21fcdf4c90f451c256191553c6f7" title="Mailto URI.">Mailto</a>)
<a name="l01571"></a>01571   {
<a name="l01572"></a>01572      u += lazy_encode( m_strPath, <span class="keyword">false</span> );
<a name="l01573"></a>01573   }
<a name="l01574"></a>01574   <span class="keywordflow">else</span>
<a name="l01575"></a>01575   {
<a name="l01576"></a>01576      u += trailingSlash( _trailing, lazy_encode( m_strPath ) );
<a name="l01577"></a>01577   }
<a name="l01578"></a>01578 
<a name="l01579"></a>01579   <span class="keywordflow">if</span> (!m_strQuery_encoded.<a class="codeRef" href="qstring.html#isNull">isNull</a>())
<a name="l01580"></a>01580       u += <span class="charliteral">&#39;?&#39;</span> + m_strQuery_encoded;
<a name="l01581"></a>01581 
<a name="l01582"></a>01582   <span class="keywordflow">if</span> ( <a class="code" href="classKURL.html#add38e3181b6ebf71290f0353d6630518" title="Tests if the URL has a reference part.">hasRef</a>() )
<a name="l01583"></a>01583   {
<a name="l01584"></a>01584     u += <span class="stringliteral">&quot;#&quot;</span>;
<a name="l01585"></a>01585     u += m_strRef_encoded;
<a name="l01586"></a>01586   }
<a name="l01587"></a>01587 
<a name="l01588"></a>01588   <span class="keywordflow">return</span> u;
<a name="l01589"></a>01589 }
<a name="l01590"></a>01590 
<a name="l01591"></a><a class="code" href="classKURL.html#ac12929211bbe1263cfad92d6e246d501">01591</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a9382bc0e035124e884f755cff962530f" title="Returns the URL as string in human-friendly format.">KURL::prettyURL</a>( <span class="keywordtype">int</span> _trailing, <a class="code" href="classKURL.html#a316e98d10f9c4dfd570f99c179e8b621" title="Flags to choose how file: URLs are treated when creating their QString representation with prettyURL(...">AdjustementFlags</a> _flags)<span class="keyword"> const</span>
<a name="l01592"></a>01592 <span class="keyword"></span>{
<a name="l01593"></a>01593   <a class="codeRef" href="qstring.html">QString</a> u = <a class="code" href="classKURL.html#a9382bc0e035124e884f755cff962530f" title="Returns the URL as string in human-friendly format.">prettyURL</a>(_trailing);
<a name="l01594"></a>01594   <span class="keywordflow">if</span> (_flags &amp; <a class="code" href="classKURL.html#a316e98d10f9c4dfd570f99c179e8b621a8ddf235a2eed58e8f915d4332dc16156" title="Strip the file: protocol from the string, i.e.">StripFileProtocol</a> &amp;&amp; u.<a class="codeRef" href="qstring.html#startsWith">startsWith</a>(<span class="stringliteral">&quot;file://&quot;</span>)) {
<a name="l01595"></a>01595     u.<a class="codeRef" href="qstring.html#remove">remove</a>(0, 7);
<a name="l01596"></a>01596 <span class="preprocessor">#ifdef Q_WS_WIN</span>
<a name="l01597"></a>01597 <span class="preprocessor"></span>    <span class="keywordflow">return</span> <a class="codeRef" href="qdir.html#convertSeparators">QDir::convertSeparators</a>(u);
<a name="l01598"></a>01598 <span class="preprocessor">#endif</span>
<a name="l01599"></a>01599 <span class="preprocessor"></span>  }
<a name="l01600"></a>01600   <span class="keywordflow">return</span> u;
<a name="l01601"></a>01601 }
<a name="l01602"></a>01602 
<a name="l01603"></a><a class="code" href="classKURL.html#a38ca30778962db93d7b47200b8e1578f">01603</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a38ca30778962db93d7b47200b8e1578f" title="Returns the URL as a string depending if it is a local file.">KURL::pathOrURL</a>()<span class="keyword"> const</span>
<a name="l01604"></a>01604 <span class="keyword"></span>{
<a name="l01605"></a>01605   <span class="keywordflow">if</span> ( <a class="code" href="classKURL.html#a942448c47652c6453f3c6ce59ae62731" title="Tests if the file is local.">isLocalFile</a>() &amp;&amp; m_strRef_encoded.<a class="codeRef" href="qstring.html#isNull">isNull</a>() &amp;&amp; m_strQuery_encoded.<a class="codeRef" href="qstring.html#isNull">isNull</a>() ) {
<a name="l01606"></a>01606     <span class="keywordflow">return</span> <a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>();
<a name="l01607"></a>01607   } <span class="keywordflow">else</span> {
<a name="l01608"></a>01608     <span class="keywordflow">return</span> <a class="code" href="classKURL.html#a9382bc0e035124e884f755cff962530f" title="Returns the URL as string in human-friendly format.">prettyURL</a>();
<a name="l01609"></a>01609   }
<a name="l01610"></a>01610 }
<a name="l01611"></a>01611 
<a name="l01612"></a><a class="code" href="classKURL.html#a1435c4cc9e9cda44c3490eba7a351101">01612</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a1435c4cc9e9cda44c3490eba7a351101" title="Returns the URL as string, escaped for HTML.">KURL::htmlURL</a>()<span class="keyword"> const</span>
<a name="l01613"></a>01613 <span class="keyword"></span>{
<a name="l01614"></a>01614   <span class="keywordflow">return</span> <a class="codeRef" href="qstylesheet.html#escape">QStyleSheet::escape</a>(<a class="code" href="classKURL.html#a9382bc0e035124e884f755cff962530f" title="Returns the URL as string in human-friendly format.">prettyURL</a>());
<a name="l01615"></a>01615 }
<a name="l01616"></a>01616 
<a name="l01617"></a><a class="code" href="classKURL.html#a5345022be672d2d6c646826d0b1f6af0">01617</a> <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">KURL::split</a>( <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a>&amp; _url )
<a name="l01618"></a>01618 {
<a name="l01619"></a>01619   <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a53f4194e147b11b678760340d62b3043" title="Returns the encoded reference of the URL.">ref</a>;
<a name="l01620"></a>01620   <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> lst;
<a name="l01621"></a>01621   <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> <a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a> = _url;
<a name="l01622"></a>01622 
<a name="l01623"></a>01623   <span class="keywordflow">while</span>(<span class="keyword">true</span>)
<a name="l01624"></a>01624   {
<a name="l01625"></a>01625      <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> u = <a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>;
<a name="l01626"></a>01626      u.m_strRef_encoded = QString::null;
<a name="l01627"></a>01627      lst.<a class="codeRef" href="qvaluelist.html#append">append</a>(u);
<a name="l01628"></a>01628      <span class="keywordflow">if</span> (url.<a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>())
<a name="l01629"></a>01629      {
<a name="l01630"></a>01630         url = <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL</a>(url.m_strRef_encoded);
<a name="l01631"></a>01631      }
<a name="l01632"></a>01632      <span class="keywordflow">else</span>
<a name="l01633"></a>01633      {
<a name="l01634"></a>01634         ref = url.m_strRef_encoded;
<a name="l01635"></a>01635         <span class="keywordflow">break</span>;
<a name="l01636"></a>01636      }
<a name="l01637"></a>01637   }
<a name="l01638"></a>01638 
<a name="l01639"></a>01639   <span class="comment">// Set HTML ref in all URLs.</span>
<a name="l01640"></a>01640   <a class="codeRef" href="qvaluelist.html#Iterator">KURL::List::Iterator</a> it;
<a name="l01641"></a>01641   <span class="keywordflow">for</span>( it = lst.<a class="codeRef" href="qvaluelist.html#begin">begin</a>() ; it != lst.<a class="codeRef" href="qvaluelist.html#end">end</a>(); ++it )
<a name="l01642"></a>01642   {
<a name="l01643"></a>01643      (*it).m_strRef_encoded = <a class="code" href="classKURL.html#a53f4194e147b11b678760340d62b3043" title="Returns the encoded reference of the URL.">ref</a>;
<a name="l01644"></a>01644   }
<a name="l01645"></a>01645 
<a name="l01646"></a>01646   <span class="keywordflow">return</span> lst;
<a name="l01647"></a>01647 }
<a name="l01648"></a>01648 
<a name="l01649"></a><a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316">01649</a> <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">KURL::split</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _url )
<a name="l01650"></a>01650 {
<a name="l01651"></a>01651   <span class="keywordflow">return</span> <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">split</a>(<a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL</a>(_url));
<a name="l01652"></a>01652 }
<a name="l01653"></a>01653 
<a name="l01654"></a><a class="code" href="classKURL.html#a95df01647f7ddf97be8c3ab018fd1f36">01654</a> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> <a class="code" href="classKURL.html#a95df01647f7ddf97be8c3ab018fd1f36" title="Joins a list of URLs into a single URL with sub URLs.">KURL::join</a>( <span class="keyword">const</span> <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> &amp; lst )
<a name="l01655"></a>01655 {
<a name="l01656"></a>01656   <span class="keywordflow">if</span> (lst.<a class="codeRef" href="qvaluelist.html#isEmpty">isEmpty</a>()) <span class="keywordflow">return</span> <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL</a>();
<a name="l01657"></a>01657   <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> tmp;
<a name="l01658"></a>01658 
<a name="l01659"></a>01659   <a class="codeRef" href="qvaluelist.html#ConstIterator">KURL::List::ConstIterator</a> first = lst.<a class="codeRef" href="qvaluelist.html#fromLast">fromLast</a>();
<a name="l01660"></a>01660   <span class="keywordflow">for</span>( <a class="codeRef" href="qvaluelist.html#ConstIterator">KURL::List::ConstIterator</a> it = first; it != lst.<a class="codeRef" href="qvaluelist.html#end">end</a>(); --it )
<a name="l01661"></a>01661   {
<a name="l01662"></a>01662      <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> u(*it);
<a name="l01663"></a>01663      <span class="keywordflow">if</span> (it != first)
<a name="l01664"></a>01664      {
<a name="l01665"></a>01665         <span class="keywordflow">if</span> (!u.m_strRef_encoded) u.m_strRef_encoded = tmp.<a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>();
<a name="l01666"></a>01666         <span class="keywordflow">else</span> u.m_strRef_encoded += <span class="stringliteral">&quot;#&quot;</span> + tmp.<a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>(); <span class="comment">// Support more than one suburl thingy</span>
<a name="l01667"></a>01667      }
<a name="l01668"></a>01668      tmp = u;
<a name="l01669"></a>01669   }
<a name="l01670"></a>01670 
<a name="l01671"></a>01671   <span class="keywordflow">return</span> tmp;
<a name="l01672"></a>01672 }
<a name="l01673"></a>01673 
<a name="l01674"></a><a class="code" href="classKURL.html#a0634d0fc02c9883ca164966b4764a692">01674</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a0634d0fc02c9883ca164966b4764a692" title="Returns the filename of the path.">KURL::fileName</a>( <span class="keywordtype">bool</span> _strip_trailing_slash )<span class="keyword"> const</span>
<a name="l01675"></a>01675 <span class="keyword"></span>{
<a name="l01676"></a>01676   <a class="codeRef" href="qstring.html">QString</a> fname;
<a name="l01677"></a>01677   <span class="keywordflow">if</span> (<a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>()) { <span class="comment">// If we have a suburl, then return the filename from there</span>
<a name="l01678"></a>01678     <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> list = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">KURL::split</a>(*<span class="keyword">this</span>);
<a name="l01679"></a>01679     <a class="codeRef" href="qvaluelist.html#Iterator">KURL::List::Iterator</a> it = list.<a class="codeRef" href="qvaluelist.html#fromLast">fromLast</a>();
<a name="l01680"></a>01680     <span class="keywordflow">return</span> (*it).fileName(_strip_trailing_slash);
<a name="l01681"></a>01681   }
<a name="l01682"></a>01682   <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;path = m_strPath;
<a name="l01683"></a>01683 
<a name="l01684"></a>01684   <span class="keywordtype">int</span> len = path.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l01685"></a>01685   <span class="keywordflow">if</span> ( len == 0 )
<a name="l01686"></a>01686     <span class="keywordflow">return</span> fname;
<a name="l01687"></a>01687 
<a name="l01688"></a>01688   <span class="keywordflow">if</span> ( _strip_trailing_slash )
<a name="l01689"></a>01689   {
<a name="l01690"></a>01690     <span class="keywordflow">while</span> ( len &gt;= 1 &amp;&amp; path[ len - 1 ] == <span class="charliteral">&#39;/&#39;</span> )
<a name="l01691"></a>01691       len--;
<a name="l01692"></a>01692   }
<a name="l01693"></a>01693   <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( path[ len - 1 ] == <span class="charliteral">&#39;/&#39;</span> )
<a name="l01694"></a>01694     <span class="keywordflow">return</span> fname;
<a name="l01695"></a>01695 
<a name="l01696"></a>01696   <span class="comment">// Does the path only consist of &#39;/&#39; characters ?</span>
<a name="l01697"></a>01697   <span class="keywordflow">if</span> ( len == 1 &amp;&amp; path[ 0 ] == <span class="charliteral">&#39;/&#39;</span> )
<a name="l01698"></a>01698     <span class="keywordflow">return</span> fname;
<a name="l01699"></a>01699 
<a name="l01700"></a>01700   <span class="comment">// Skip last n slashes</span>
<a name="l01701"></a>01701   <span class="keywordtype">int</span> n = 1;
<a name="l01702"></a>01702   <span class="keywordflow">if</span> (!m_strPath_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01703"></a>01703   {
<a name="l01704"></a>01704      <span class="comment">// This is hairy, we need the last unencoded slash.</span>
<a name="l01705"></a>01705      <span class="comment">// Count in the encoded string how many encoded slashes follow the last</span>
<a name="l01706"></a>01706      <span class="comment">// unencoded one.</span>
<a name="l01707"></a>01707      <span class="keywordtype">int</span> i = m_strPath_encoded.<a class="codeRef" href="qstring.html#findRev">findRev</a>( <span class="charliteral">&#39;/&#39;</span>, len - 1 );
<a name="l01708"></a>01708      <a class="codeRef" href="qstring.html">QString</a> fileName_encoded = m_strPath_encoded.<a class="codeRef" href="qstring.html#mid">mid</a>(i+1);
<a name="l01709"></a>01709      n += fileName_encoded.<a class="codeRef" href="qstring.html#contains">contains</a>(<span class="stringliteral">&quot;%2f&quot;</span>, <span class="keyword">false</span>);
<a name="l01710"></a>01710   }
<a name="l01711"></a>01711   <span class="keywordtype">int</span> i = len;
<a name="l01712"></a>01712   <span class="keywordflow">do</span> {
<a name="l01713"></a>01713     i = path.<a class="codeRef" href="qstring.html#findRev">findRev</a>( <span class="charliteral">&#39;/&#39;</span>, i - 1 );
<a name="l01714"></a>01714   }
<a name="l01715"></a>01715   <span class="keywordflow">while</span> (--n &amp;&amp; (i &gt; 0));
<a name="l01716"></a>01716 
<a name="l01717"></a>01717   <span class="comment">// If ( i == -1 ) =&gt; the first character is not a &#39;/&#39;</span>
<a name="l01718"></a>01718   <span class="comment">// So it&#39;s some URL like file:blah.tgz, return the whole path</span>
<a name="l01719"></a>01719   <span class="keywordflow">if</span> ( i == -1 ) {
<a name="l01720"></a>01720     <span class="keywordflow">if</span> ( len == (<span class="keywordtype">int</span>)path.<a class="codeRef" href="qstring.html#length">length</a>() )
<a name="l01721"></a>01721       fname = path;
<a name="l01722"></a>01722     <span class="keywordflow">else</span>
<a name="l01723"></a>01723       <span class="comment">// Might get here if _strip_trailing_slash is true</span>
<a name="l01724"></a>01724       fname = path.<a class="codeRef" href="qstring.html#left">left</a>( len );
<a name="l01725"></a>01725   }
<a name="l01726"></a>01726   <span class="keywordflow">else</span>
<a name="l01727"></a>01727   {
<a name="l01728"></a>01728      fname = path.<a class="codeRef" href="qstring.html#mid">mid</a>( i + 1, len - i - 1 ); <span class="comment">// TO CHECK</span>
<a name="l01729"></a>01729   }
<a name="l01730"></a>01730   <span class="keywordflow">return</span> fname;
<a name="l01731"></a>01731 }
<a name="l01732"></a>01732 
<a name="l01733"></a><a class="code" href="classKURL.html#a22950393da23aff8dc71dd86cdad9a1b">01733</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a22950393da23aff8dc71dd86cdad9a1b" title="Adds to the current path.">KURL::addPath</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _txt )
<a name="l01734"></a>01734 {
<a name="l01735"></a>01735   <span class="keywordflow">if</span> (<a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>())
<a name="l01736"></a>01736   {
<a name="l01737"></a>01737      <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> lst = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">split</a>( *<span class="keyword">this</span> );
<a name="l01738"></a>01738      <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> &amp;u = lst.<a class="codeRef" href="qvaluelist.html#last">last</a>();
<a name="l01739"></a>01739      u.<a class="code" href="classKURL.html#a22950393da23aff8dc71dd86cdad9a1b" title="Adds to the current path.">addPath</a>(_txt);
<a name="l01740"></a>01740      *<span class="keyword">this</span> = <a class="code" href="classKURL.html#a95df01647f7ddf97be8c3ab018fd1f36" title="Joins a list of URLs into a single URL with sub URLs.">join</a>( lst );
<a name="l01741"></a>01741      <span class="keywordflow">return</span>;
<a name="l01742"></a>01742   }
<a name="l01743"></a>01743 
<a name="l01744"></a>01744   m_strPath_encoded = QString::null;
<a name="l01745"></a>01745 
<a name="l01746"></a>01746   <span class="keywordflow">if</span> ( _txt.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l01747"></a>01747     <span class="keywordflow">return</span>;
<a name="l01748"></a>01748 
<a name="l01749"></a>01749   <span class="keywordtype">int</span> i = 0;
<a name="l01750"></a>01750   <span class="keywordtype">int</span> len = m_strPath.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l01751"></a>01751   <span class="comment">// Add the trailing &#39;/&#39; if it is missing</span>
<a name="l01752"></a>01752   <span class="keywordflow">if</span> ( _txt[0] != <span class="charliteral">&#39;/&#39;</span> &amp;&amp; ( len == 0 || m_strPath[ len - 1 ] != <span class="charliteral">&#39;/&#39;</span> ) )
<a name="l01753"></a>01753     m_strPath += <span class="stringliteral">&quot;/&quot;</span>;
<a name="l01754"></a>01754 
<a name="l01755"></a>01755   <span class="comment">// No double &#39;/&#39; characters</span>
<a name="l01756"></a>01756   i = 0;
<a name="l01757"></a>01757   <span class="keywordflow">if</span> ( len != 0 &amp;&amp; m_strPath[ len - 1 ] == <span class="charliteral">&#39;/&#39;</span> )
<a name="l01758"></a>01758   {
<a name="l01759"></a>01759     <span class="keywordflow">while</span>( _txt[i] == <span class="charliteral">&#39;/&#39;</span> )
<a name="l01760"></a>01760       ++i;
<a name="l01761"></a>01761   }
<a name="l01762"></a>01762 
<a name="l01763"></a>01763   m_strPath += _txt.<a class="codeRef" href="qstring.html#mid">mid</a>( i );
<a name="l01764"></a>01764 }
<a name="l01765"></a>01765 
<a name="l01766"></a><a class="code" href="classKURL.html#a0ff924855867aa98d0cbb5f3f20f4f87">01766</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a0ff924855867aa98d0cbb5f3f20f4f87" title="Returns the directory of the path.">KURL::directory</a>( <span class="keywordtype">bool</span> _strip_trailing_slash_from_result,
<a name="l01767"></a>01767                          <span class="keywordtype">bool</span> _ignore_trailing_slash_in_path )<span class="keyword"> const</span>
<a name="l01768"></a>01768 <span class="keyword"></span>{
<a name="l01769"></a>01769   <a class="codeRef" href="qstring.html">QString</a> result = m_strPath_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ? m_strPath : m_strPath_encoded;
<a name="l01770"></a>01770   <span class="keywordflow">if</span> ( _ignore_trailing_slash_in_path )
<a name="l01771"></a>01771     result = trailingSlash( -1, result );
<a name="l01772"></a>01772 
<a name="l01773"></a>01773   <span class="keywordflow">if</span> ( result.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || result == <span class="stringliteral">&quot;/&quot;</span> )
<a name="l01774"></a>01774     <span class="keywordflow">return</span> result;
<a name="l01775"></a>01775 
<a name="l01776"></a>01776   <span class="keywordtype">int</span> i = result.<a class="codeRef" href="qstring.html#findRev">findRev</a>( <span class="stringliteral">&quot;/&quot;</span> );
<a name="l01777"></a>01777   <span class="comment">// If ( i == -1 ) =&gt; the first character is not a &#39;/&#39;</span>
<a name="l01778"></a>01778   <span class="comment">// So it&#39;s some URL like file:blah.tgz, with no path</span>
<a name="l01779"></a>01779   <span class="keywordflow">if</span> ( i == -1 )
<a name="l01780"></a>01780     <span class="keywordflow">return</span> QString::null;
<a name="l01781"></a>01781 
<a name="l01782"></a>01782   <span class="keywordflow">if</span> ( i == 0 )
<a name="l01783"></a>01783   {
<a name="l01784"></a>01784     result = <span class="stringliteral">&quot;/&quot;</span>;
<a name="l01785"></a>01785     <span class="keywordflow">return</span> result;
<a name="l01786"></a>01786   }
<a name="l01787"></a>01787 
<a name="l01788"></a>01788   <span class="keywordflow">if</span> ( _strip_trailing_slash_from_result )
<a name="l01789"></a>01789     result = result.<a class="codeRef" href="qstring.html#left">left</a>( i );
<a name="l01790"></a>01790   <span class="keywordflow">else</span>
<a name="l01791"></a>01791     result = result.<a class="codeRef" href="qstring.html#left">left</a>( i + 1 );
<a name="l01792"></a>01792 
<a name="l01793"></a>01793   <span class="keywordflow">if</span> (!m_strPath_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01794"></a>01794     result = decode(result);
<a name="l01795"></a>01795 
<a name="l01796"></a>01796   <span class="keywordflow">return</span> result;
<a name="l01797"></a>01797 }
<a name="l01798"></a>01798 
<a name="l01799"></a>01799 
<a name="l01800"></a><a class="code" href="classKURL.html#a7d2e31526d61ed97a0132768d0270a3f">01800</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#a7d2e31526d61ed97a0132768d0270a3f" title="Changes the directory by descending into the given directory.">KURL::cd</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _dir )
<a name="l01801"></a>01801 {
<a name="l01802"></a>01802   <span class="keywordflow">if</span> ( _dir.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || m_bIsMalformed )
<a name="l01803"></a>01803     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01804"></a>01804 
<a name="l01805"></a>01805   <span class="keywordflow">if</span> (<a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>())
<a name="l01806"></a>01806   {
<a name="l01807"></a>01807      <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> lst = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">split</a>( *<span class="keyword">this</span> );
<a name="l01808"></a>01808      <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> &amp;u = lst.<a class="codeRef" href="qvaluelist.html#last">last</a>();
<a name="l01809"></a>01809      u.<a class="code" href="classKURL.html#a7d2e31526d61ed97a0132768d0270a3f" title="Changes the directory by descending into the given directory.">cd</a>(_dir);
<a name="l01810"></a>01810      *<span class="keyword">this</span> = <a class="code" href="classKURL.html#a95df01647f7ddf97be8c3ab018fd1f36" title="Joins a list of URLs into a single URL with sub URLs.">join</a>( lst );
<a name="l01811"></a>01811      <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01812"></a>01812   }
<a name="l01813"></a>01813 
<a name="l01814"></a>01814   <span class="comment">// absolute path ?</span>
<a name="l01815"></a>01815   <span class="keywordflow">if</span> ( _dir[0] == <span class="charliteral">&#39;/&#39;</span> )
<a name="l01816"></a>01816   {
<a name="l01817"></a>01817     m_strPath_encoded = QString::null;
<a name="l01818"></a>01818     m_strPath = _dir;
<a name="l01819"></a>01819     <a class="code" href="classKURL.html#abd27cfe74e1c54f0e1f43958d102f103" title="Sets the decoded HTML-style reference.">setHTMLRef</a>( QString::null );
<a name="l01820"></a>01820     m_strQuery_encoded = QString::null;
<a name="l01821"></a>01821     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01822"></a>01822   }
<a name="l01823"></a>01823 
<a name="l01824"></a>01824   <span class="comment">// Users home directory on the local disk ?</span>
<a name="l01825"></a>01825   <span class="keywordflow">if</span> ( ( _dir[0] == <span class="charliteral">&#39;~&#39;</span> ) &amp;&amp; ( m_strProtocol == fileProt ))
<a name="l01826"></a>01826   {
<a name="l01827"></a>01827     m_strPath_encoded = QString::null;
<a name="l01828"></a>01828     m_strPath = <a class="codeRef" href="qdir.html#homeDirPath">QDir::homeDirPath</a>();
<a name="l01829"></a>01829     m_strPath += <span class="stringliteral">&quot;/&quot;</span>;
<a name="l01830"></a>01830     m_strPath += _dir.<a class="codeRef" href="qstring.html#right">right</a>(m_strPath.<a class="codeRef" href="qstring.html#length">length</a>() - 1);
<a name="l01831"></a>01831     <a class="code" href="classKURL.html#abd27cfe74e1c54f0e1f43958d102f103" title="Sets the decoded HTML-style reference.">setHTMLRef</a>( QString::null );
<a name="l01832"></a>01832     m_strQuery_encoded = QString::null;
<a name="l01833"></a>01833     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01834"></a>01834   }
<a name="l01835"></a>01835 
<a name="l01836"></a>01836   <span class="comment">// relative path</span>
<a name="l01837"></a>01837   <span class="comment">// we always work on the past of the first url.</span>
<a name="l01838"></a>01838   <span class="comment">// Sub URLs are not touched.</span>
<a name="l01839"></a>01839 
<a name="l01840"></a>01840   <span class="comment">// append &#39;/&#39; if necessary</span>
<a name="l01841"></a>01841   <a class="codeRef" href="qstring.html">QString</a> p = <a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>(1);
<a name="l01842"></a>01842   p += _dir;
<a name="l01843"></a>01843   p = cleanpath( p, <span class="keyword">true</span>, <span class="keyword">false</span> );
<a name="l01844"></a>01844   <a class="code" href="classKURL.html#a6c0a0828b4b9f1126b13380076e2b2f3" title="Sets the decoded path of the URL.">setPath</a>( p );
<a name="l01845"></a>01845 
<a name="l01846"></a>01846   <a class="code" href="classKURL.html#abd27cfe74e1c54f0e1f43958d102f103" title="Sets the decoded HTML-style reference.">setHTMLRef</a>( QString::null );
<a name="l01847"></a>01847   m_strQuery_encoded = QString::null;
<a name="l01848"></a>01848 
<a name="l01849"></a>01849   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01850"></a>01850 }
<a name="l01851"></a>01851 
<a name="l01852"></a><a class="code" href="classKURL.html#acb769056af19c8c4b0458f9a6b317343">01852</a> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> <a class="code" href="classKURL.html#acb769056af19c8c4b0458f9a6b317343" title="Returns the URL that is the best possible candidate for on level higher in the path hierachy...">KURL::upURL</a>( )<span class="keyword"> const</span>
<a name="l01853"></a>01853 <span class="keyword"></span>{
<a name="l01854"></a>01854   <span class="keywordflow">if</span> (!<a class="code" href="classKURL.html#a0a28c0873806d04a7fd4e19feeb4bd63" title="Returns the encoded query of the URL.">query</a>().<a class="code" href="classKURL.html#af10f805c72d7223d88d7499fc5f39bd2" title="Tests if the KURL is empty.">isEmpty</a>())
<a name="l01855"></a>01855   {
<a name="l01856"></a>01856      <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> u(*<span class="keyword">this</span>);
<a name="l01857"></a>01857      u._setQuery(QString::null);
<a name="l01858"></a>01858      <span class="keywordflow">return</span> u;
<a name="l01859"></a>01859   };
<a name="l01860"></a>01860 
<a name="l01861"></a>01861   <span class="keywordflow">if</span> (!<a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>())
<a name="l01862"></a>01862   {
<a name="l01863"></a>01863      <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> u(*<span class="keyword">this</span>);
<a name="l01864"></a>01864 
<a name="l01865"></a>01865      u.<a class="code" href="classKURL.html#a7d2e31526d61ed97a0132768d0270a3f" title="Changes the directory by descending into the given directory.">cd</a>(<span class="stringliteral">&quot;../&quot;</span>);
<a name="l01866"></a>01866 
<a name="l01867"></a>01867      <span class="keywordflow">return</span> u;
<a name="l01868"></a>01868   }
<a name="l01869"></a>01869 
<a name="l01870"></a>01870   <span class="comment">// We have a subURL.</span>
<a name="l01871"></a>01871   <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> lst = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">split</a>( *<span class="keyword">this</span> );
<a name="l01872"></a>01872   <span class="keywordflow">if</span> (lst.<a class="codeRef" href="qvaluelist.html#isEmpty">isEmpty</a>())
<a name="l01873"></a>01873       <span class="keywordflow">return</span> <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL</a>(); <span class="comment">// Huh?</span>
<a name="l01874"></a>01874   <span class="keywordflow">while</span> (<span class="keyword">true</span>)
<a name="l01875"></a>01875   {
<a name="l01876"></a>01876      <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> &amp;u = lst.<a class="codeRef" href="qvaluelist.html#last">last</a>();
<a name="l01877"></a>01877      <a class="codeRef" href="qstring.html">QString</a> old = u.<a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>();
<a name="l01878"></a>01878      u.<a class="code" href="classKURL.html#a7d2e31526d61ed97a0132768d0270a3f" title="Changes the directory by descending into the given directory.">cd</a>(<span class="stringliteral">&quot;../&quot;</span>);
<a name="l01879"></a>01879      <span class="keywordflow">if</span> (u.<a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>() != old)
<a name="l01880"></a>01880          <span class="keywordflow">break</span>; <span class="comment">// Finshed.</span>
<a name="l01881"></a>01881      <span class="keywordflow">if</span> (lst.<a class="codeRef" href="qvaluelist.html#count">count</a>() == 1)
<a name="l01882"></a>01882          <span class="keywordflow">break</span>; <span class="comment">// Finished.</span>
<a name="l01883"></a>01883      lst.<a class="codeRef" href="qvaluelist.html#remove">remove</a>(lst.<a class="codeRef" href="qvaluelist.html#fromLast">fromLast</a>());
<a name="l01884"></a>01884   }
<a name="l01885"></a>01885   <span class="keywordflow">return</span> <a class="code" href="classKURL.html#a95df01647f7ddf97be8c3ab018fd1f36" title="Joins a list of URLs into a single URL with sub URLs.">join</a>( lst );
<a name="l01886"></a>01886 }
<a name="l01887"></a>01887 
<a name="l01888"></a><a class="code" href="classKURL.html#aed95d74660e8514cf91a9948ced8108c">01888</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#aed95d74660e8514cf91a9948ced8108c" title="Returns decoded the HTML-style reference (the part of the URL after &#39;#&#39;)">KURL::htmlRef</a>()<span class="keyword"> const</span>
<a name="l01889"></a>01889 <span class="keyword"></span>{
<a name="l01890"></a>01890   <span class="keywordflow">if</span> ( !<a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>() )
<a name="l01891"></a>01891   {
<a name="l01892"></a>01892     <span class="keywordflow">return</span> decode( <a class="code" href="classKURL.html#a53f4194e147b11b678760340d62b3043" title="Returns the encoded reference of the URL.">ref</a>() );
<a name="l01893"></a>01893   }
<a name="l01894"></a>01894 
<a name="l01895"></a>01895   <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">List</a> lst = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">split</a>( *<span class="keyword">this</span> );
<a name="l01896"></a>01896   <span class="keywordflow">return</span> decode( (*lst.<a class="codeRef" href="qvaluelist.html#begin">begin</a>()).<a class="code" href="classKURL.html#a53f4194e147b11b678760340d62b3043" title="Returns the encoded reference of the URL.">ref</a>() );
<a name="l01897"></a>01897 }
<a name="l01898"></a>01898 
<a name="l01899"></a><a class="code" href="classKURL.html#a27c969dca60a800d96238ed18337d008">01899</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a27c969dca60a800d96238ed18337d008" title="Returns the encoded HTML-style reference (the part of the URL after &#39;#&#39;)">KURL::encodedHtmlRef</a>()<span class="keyword"> const</span>
<a name="l01900"></a>01900 <span class="keyword"></span>{
<a name="l01901"></a>01901   <span class="keywordflow">if</span> ( !<a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>() )
<a name="l01902"></a>01902   {
<a name="l01903"></a>01903     <span class="keywordflow">return</span> <a class="code" href="classKURL.html#a53f4194e147b11b678760340d62b3043" title="Returns the encoded reference of the URL.">ref</a>();
<a name="l01904"></a>01904   }
<a name="l01905"></a>01905 
<a name="l01906"></a>01906   <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">List</a> lst = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">split</a>( *<span class="keyword">this</span> );
<a name="l01907"></a>01907   <span class="keywordflow">return</span> (*lst.<a class="codeRef" href="qvaluelist.html#begin">begin</a>()).<a class="code" href="classKURL.html#a53f4194e147b11b678760340d62b3043" title="Returns the encoded reference of the URL.">ref</a>();
<a name="l01908"></a>01908 }
<a name="l01909"></a>01909 
<a name="l01910"></a><a class="code" href="classKURL.html#abd27cfe74e1c54f0e1f43958d102f103">01910</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#abd27cfe74e1c54f0e1f43958d102f103" title="Sets the decoded HTML-style reference.">KURL::setHTMLRef</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _ref )
<a name="l01911"></a>01911 {
<a name="l01912"></a>01912   <span class="keywordflow">if</span> ( !<a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>() )
<a name="l01913"></a>01913   {
<a name="l01914"></a>01914     m_strRef_encoded = encode( _ref, 0, 0 <span class="comment">/*?*/</span>);
<a name="l01915"></a>01915     <span class="keywordflow">return</span>;
<a name="l01916"></a>01916   }
<a name="l01917"></a>01917 
<a name="l01918"></a>01918   <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">List</a> lst = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">split</a>( *<span class="keyword">this</span> );
<a name="l01919"></a>01919 
<a name="l01920"></a>01920   (*lst.<a class="codeRef" href="qvaluelist.html#begin">begin</a>()).<a class="code" href="classKURL.html#af531d16bdf3ac9a5a8ed27e16f61ebd7" title="Sets the encoded reference part (everything after &#39;#&#39;)">setRef</a>( encode( _ref, 0, 0 <span class="comment">/*?*/</span>) );
<a name="l01921"></a>01921 
<a name="l01922"></a>01922   *<span class="keyword">this</span> = <a class="code" href="classKURL.html#a95df01647f7ddf97be8c3ab018fd1f36" title="Joins a list of URLs into a single URL with sub URLs.">join</a>( lst );
<a name="l01923"></a>01923 }
<a name="l01924"></a>01924 
<a name="l01925"></a><a class="code" href="classKURL.html#a55f47b57289effd8e4bc7dc945b5b9f9">01925</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#a55f47b57289effd8e4bc7dc945b5b9f9" title="Tests if there is an HTML-style reference.">KURL::hasHTMLRef</a>()<span class="keyword"> const</span>
<a name="l01926"></a>01926 <span class="keyword"></span>{
<a name="l01927"></a>01927   <span class="keywordflow">if</span> ( !<a class="code" href="classKURL.html#a090c7e6d5d6293a6cbdde374bc1ebaeb" title="Tests if the URL has any sub URLs.">hasSubURL</a>() )
<a name="l01928"></a>01928   {
<a name="l01929"></a>01929     <span class="keywordflow">return</span> <a class="code" href="classKURL.html#add38e3181b6ebf71290f0353d6630518" title="Tests if the URL has a reference part.">hasRef</a>();
<a name="l01930"></a>01930   }
<a name="l01931"></a>01931 
<a name="l01932"></a>01932   <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">List</a> lst = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">split</a>( *<span class="keyword">this</span> );
<a name="l01933"></a>01933   <span class="keywordflow">return</span> (*lst.<a class="codeRef" href="qvaluelist.html#begin">begin</a>()).<a class="code" href="classKURL.html#add38e3181b6ebf71290f0353d6630518" title="Tests if the URL has a reference part.">hasRef</a>();
<a name="l01934"></a>01934 }
<a name="l01935"></a>01935 
<a name="l01936"></a>01936 <span class="keywordtype">void</span>
<a name="l01937"></a><a class="code" href="classKURL.html#a8992baac621d32c2aed7c97a26362b8d">01937</a> <a class="code" href="classKURL.html#a8992baac621d32c2aed7c97a26362b8d" title="Sets the protocol for the URL.">KURL::setProtocol</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _txt )
<a name="l01938"></a>01938 {
<a name="l01939"></a>01939    m_strProtocol = _txt;
<a name="l01940"></a>01940    <span class="keywordflow">if</span> ( m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a9db85130d0702a27e41777d7c767acca" title="Automatically detected.">Auto</a> ) m_iUriMode = <a class="code" href="classKURL.html#ad400be8a7ea5af29184581da39abe7ce" title="Determines which URI mode is suitable for processing URIs of a given protocol.">uriModeForProtocol</a>( m_strProtocol );
<a name="l01941"></a>01941    m_bIsMalformed = <span class="keyword">false</span>;
<a name="l01942"></a>01942 }
<a name="l01943"></a>01943 
<a name="l01944"></a>01944 <span class="keywordtype">void</span>
<a name="l01945"></a><a class="code" href="classKURL.html#a3ee8660de05aaac5e90893ca87ab07fe">01945</a> <a class="code" href="classKURL.html#a3ee8660de05aaac5e90893ca87ab07fe" title="Sets the user name (login, user id, etc) to include in the URL.">KURL::setUser</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _txt )
<a name="l01946"></a>01946 {
<a name="l01947"></a>01947    <span class="keywordflow">if</span> ( _txt.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l01948"></a>01948      m_strUser = QString::null;
<a name="l01949"></a>01949    <span class="keywordflow">else</span>
<a name="l01950"></a>01950      m_strUser = _txt;
<a name="l01951"></a>01951 }
<a name="l01952"></a>01952 
<a name="l01953"></a>01953 <span class="keywordtype">void</span>
<a name="l01954"></a><a class="code" href="classKURL.html#a34346c1a8873adc586efffb6d1376154">01954</a> <a class="code" href="classKURL.html#a34346c1a8873adc586efffb6d1376154" title="Sets the password (corresponding to user()) to include in the URL.">KURL::setPass</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _txt )
<a name="l01955"></a>01955 {
<a name="l01956"></a>01956    <span class="keywordflow">if</span> ( _txt.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l01957"></a>01957      m_strPass = QString::null;
<a name="l01958"></a>01958    <span class="keywordflow">else</span>
<a name="l01959"></a>01959      m_strPass = _txt;
<a name="l01960"></a>01960 }
<a name="l01961"></a>01961 
<a name="l01962"></a>01962 <span class="keywordtype">void</span>
<a name="l01963"></a><a class="code" href="classKURL.html#afbf05cea61e7c6f3c5de6a467d5f0534">01963</a> <a class="code" href="classKURL.html#afbf05cea61e7c6f3c5de6a467d5f0534" title="Sets the hostname to include in the URL.">KURL::setHost</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _txt )
<a name="l01964"></a>01964 {
<a name="l01965"></a>01965   <span class="keywordflow">if</span> ( m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a9db85130d0702a27e41777d7c767acca" title="Automatically detected.">Auto</a> )
<a name="l01966"></a>01966     m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a>;
<a name="l01967"></a>01967   <span class="keywordflow">switch</span> ( m_iUriMode )
<a name="l01968"></a>01968   {
<a name="l01969"></a>01969   <span class="keywordflow">case</span> <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a>:
<a name="l01970"></a>01970 <span class="preprocessor">#ifndef KDE_QT_ONLY</span>
<a name="l01971"></a>01971 <span class="preprocessor"></span>   m_strHost = KIDNA::toUnicode(_txt);
<a name="l01972"></a>01972    <span class="keywordflow">if</span> (m_strHost.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01973"></a>01973       m_strHost = _txt.<a class="codeRef" href="qstring.html#lower">lower</a>(); <span class="comment">// Probably an invalid hostname, but...</span>
<a name="l01974"></a>01974 <span class="preprocessor">#else</span>
<a name="l01975"></a>01975 <span class="preprocessor"></span>   m_strHost = _txt.<a class="codeRef" href="qstring.html#lower">lower</a>();
<a name="l01976"></a>01976 <span class="preprocessor">#endif</span>
<a name="l01977"></a>01977 <span class="preprocessor"></span>    <span class="keywordflow">break</span>;
<a name="l01978"></a>01978   <span class="keywordflow">default</span>:
<a name="l01979"></a>01979     m_strHost = _txt;
<a name="l01980"></a>01980     <span class="keywordflow">break</span>;
<a name="l01981"></a>01981   }
<a name="l01982"></a>01982 }
<a name="l01983"></a>01983 
<a name="l01984"></a>01984 <span class="keywordtype">void</span>
<a name="l01985"></a><a class="code" href="classKURL.html#a872ff8bd98d746e3356d9331d55421e8">01985</a> <a class="code" href="classKURL.html#a872ff8bd98d746e3356d9331d55421e8" title="Sets the port number to include in the URL.">KURL::setPort</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> <span class="keywordtype">int</span> _p )
<a name="l01986"></a>01986 {
<a name="l01987"></a>01987    m_iPort = _p;
<a name="l01988"></a>01988 }
<a name="l01989"></a>01989 
<a name="l01990"></a><a class="code" href="classKURL.html#a6c0a0828b4b9f1126b13380076e2b2f3">01990</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a6c0a0828b4b9f1126b13380076e2b2f3" title="Sets the decoded path of the URL.">KURL::setPath</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp; path )
<a name="l01991"></a>01991 {
<a name="l01992"></a>01992   <span class="keywordflow">if</span> (<a class="code" href="classKURL.html#af10f805c72d7223d88d7499fc5f39bd2" title="Tests if the KURL is empty.">isEmpty</a>())
<a name="l01993"></a>01993     m_bIsMalformed = <span class="keyword">false</span>;
<a name="l01994"></a>01994   <span class="keywordflow">if</span> (m_strProtocol.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l01995"></a>01995   {
<a name="l01996"></a>01996     m_strProtocol = fileProt;
<a name="l01997"></a>01997   }
<a name="l01998"></a>01998   m_strPath = <a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>;
<a name="l01999"></a>01999   m_strPath_encoded = QString::null;
<a name="l02000"></a>02000   <span class="keywordflow">if</span> ( m_iUriMode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a9db85130d0702a27e41777d7c767acca" title="Automatically detected.">Auto</a> )
<a name="l02001"></a>02001     m_iUriMode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a>;
<a name="l02002"></a>02002 }
<a name="l02003"></a>02003 
<a name="l02004"></a><a class="code" href="classKURL.html#a35ef4c9ffe4fa877f30c53ccfaf5a293">02004</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a35ef4c9ffe4fa877f30c53ccfaf5a293" title="Sets the directory of the path, leaving the filename empty.">KURL::setDirectory</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;dir)
<a name="l02005"></a>02005 {
<a name="l02006"></a>02006   <span class="keywordflow">if</span> ( dir.<a class="codeRef" href="qstring.html#endsWith">endsWith</a>(<span class="stringliteral">&quot;/&quot;</span>))
<a name="l02007"></a>02007      <a class="code" href="classKURL.html#a6c0a0828b4b9f1126b13380076e2b2f3" title="Sets the decoded path of the URL.">setPath</a>(dir);
<a name="l02008"></a>02008   <span class="keywordflow">else</span>
<a name="l02009"></a>02009      <a class="code" href="classKURL.html#a6c0a0828b4b9f1126b13380076e2b2f3" title="Sets the decoded path of the URL.">setPath</a>(dir+<span class="stringliteral">&quot;/&quot;</span>);
<a name="l02010"></a>02010 }
<a name="l02011"></a>02011 
<a name="l02012"></a><a class="code" href="classKURL.html#a9ffeaee79924b4156f5816fc95f874e5">02012</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a9ffeaee79924b4156f5816fc95f874e5" title="Sets the encoded query of the URL.">KURL::setQuery</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;_txt, <span class="keywordtype">int</span> encoding_hint)
<a name="l02013"></a>02013 {
<a name="l02014"></a>02014    <span class="keywordflow">if</span> (_txt[0] == <span class="charliteral">&#39;?&#39;</span>)
<a name="l02015"></a>02015       _setQuery( _txt.<a class="codeRef" href="qstring.html#length">length</a>() &gt; 1 ? _txt.<a class="codeRef" href="qstring.html#mid">mid</a>(1) : <span class="stringliteral">&quot;&quot;</span> <span class="comment">/*empty, not null*/</span>, encoding_hint );
<a name="l02016"></a>02016    <span class="keywordflow">else</span>
<a name="l02017"></a>02017       _setQuery( _txt, encoding_hint );
<a name="l02018"></a>02018 }
<a name="l02019"></a>02019 
<a name="l02020"></a>02020 <span class="comment">// This is a private function that expects a query without &#39;?&#39;</span>
<a name="l02021"></a>02021 <span class="keywordtype">void</span> KURL::_setQuery( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;_txt, <span class="keywordtype">int</span> encoding_hint)
<a name="l02022"></a>02022 {
<a name="l02023"></a>02023    m_strQuery_encoded = _txt;
<a name="l02024"></a>02024    <span class="keywordflow">if</span> (!_txt.<a class="codeRef" href="qstring.html#length">length</a>())
<a name="l02025"></a>02025       <span class="keywordflow">return</span>;
<a name="l02026"></a>02026 
<a name="l02027"></a>02027    <span class="keywordtype">int</span> l = m_strQuery_encoded.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l02028"></a>02028    <span class="keywordtype">int</span> i = 0;
<a name="l02029"></a>02029    <a class="codeRef" href="qstring.html">QString</a> result;
<a name="l02030"></a>02030    <span class="keywordflow">while</span> (i &lt; l)
<a name="l02031"></a>02031    {
<a name="l02032"></a>02032       <span class="keywordtype">int</span> s = i;
<a name="l02033"></a>02033       <span class="comment">// Re-encode. Break encoded string up according to the reserved</span>
<a name="l02034"></a>02034       <span class="comment">// characters &#39;&amp;:;=/?&#39; and re-encode part by part.</span>
<a name="l02035"></a>02035       <span class="keywordflow">while</span>(i &lt; l)
<a name="l02036"></a>02036       {
<a name="l02037"></a>02037          <span class="keywordtype">char</span> c = m_strQuery_encoded[i].<a class="codeRef" href="qstring.html#latin1">latin1</a>();
<a name="l02038"></a>02038          <span class="keywordflow">if</span> ((c == <span class="charliteral">&#39;&amp;&#39;</span>) || (c == <span class="charliteral">&#39;:&#39;</span>) || (c == <span class="charliteral">&#39;;&#39;</span>) ||
<a name="l02039"></a>02039              (c == <span class="charliteral">&#39;=&#39;</span>) || (c == <span class="charliteral">&#39;/&#39;</span>) || (c == <span class="charliteral">&#39;?&#39;</span>))
<a name="l02040"></a>02040             <span class="keywordflow">break</span>;
<a name="l02041"></a>02041          i++;
<a name="l02042"></a>02042       }
<a name="l02043"></a>02043       <span class="keywordflow">if</span> (i &gt; s)
<a name="l02044"></a>02044       {
<a name="l02045"></a>02045          <a class="codeRef" href="qstring.html">QString</a> tmp = m_strQuery_encoded.<a class="codeRef" href="qstring.html#mid">mid</a>(s, i-s);
<a name="l02046"></a>02046          <a class="codeRef" href="qstring.html">QString</a> newTmp;
<a name="l02047"></a>02047          decode( tmp, newTmp, tmp, encoding_hint, <span class="keyword">false</span> );
<a name="l02048"></a>02048          result += tmp;
<a name="l02049"></a>02049       }
<a name="l02050"></a>02050       <span class="keywordflow">if</span> (i &lt; l)
<a name="l02051"></a>02051       {
<a name="l02052"></a>02052          result += m_strQuery_encoded[i];
<a name="l02053"></a>02053          i++;
<a name="l02054"></a>02054       }
<a name="l02055"></a>02055    }
<a name="l02056"></a>02056    m_strQuery_encoded = result;
<a name="l02057"></a>02057 }
<a name="l02058"></a>02058 
<a name="l02059"></a><a class="code" href="classKURL.html#a0a28c0873806d04a7fd4e19feeb4bd63">02059</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a0a28c0873806d04a7fd4e19feeb4bd63" title="Returns the encoded query of the URL.">KURL::query</a>()<span class="keyword"> const</span>
<a name="l02060"></a>02060 <span class="keyword"></span>{
<a name="l02061"></a>02061     <span class="keywordflow">if</span> (m_strQuery_encoded.<a class="codeRef" href="qstring.html#isNull">isNull</a>())
<a name="l02062"></a>02062         <span class="keywordflow">return</span> QString::null;
<a name="l02063"></a>02063     <span class="keywordflow">return</span> <span class="charliteral">&#39;?&#39;</span>+m_strQuery_encoded;
<a name="l02064"></a>02064 }
<a name="l02065"></a>02065 
<a name="l02066"></a><a class="code" href="classKURL.html#abbdd1c868880355a4eb6daa4a71926b0">02066</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#abbdd1c868880355a4eb6daa4a71926b0" title="Decodes a string as used in URLs.">KURL::decode_string</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;str, <span class="keywordtype">int</span> encoding_hint)
<a name="l02067"></a>02067 {
<a name="l02068"></a>02068    <span class="keywordflow">return</span> decode(str, encoding_hint);
<a name="l02069"></a>02069 }
<a name="l02070"></a>02070 
<a name="l02071"></a><a class="code" href="classKURL.html#a5a12896c25a17ab12abf2097a7c75713">02071</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a5a12896c25a17ab12abf2097a7c75713" title="Encodes a string for use in URLs.">KURL::encode_string</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;str, <span class="keywordtype">int</span> encoding_hint)
<a name="l02072"></a>02072 {
<a name="l02073"></a>02073    <span class="keywordflow">return</span> encode(str, 1, encoding_hint);
<a name="l02074"></a>02074 }
<a name="l02075"></a>02075 
<a name="l02076"></a><a class="code" href="classKURL.html#a2c68cba73fe2d65b926d6f9cc3667790">02076</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a2c68cba73fe2d65b926d6f9cc3667790" title="Encodes a string for use in URLs.">KURL::encode_string_no_slash</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;str, <span class="keywordtype">int</span> encoding_hint)
<a name="l02077"></a>02077 {
<a name="l02078"></a>02078    <span class="keywordflow">return</span> encode(str, 0, encoding_hint);
<a name="l02079"></a>02079 }
<a name="l02080"></a>02080 
<a name="l02081"></a><a class="code" href="classKURL.html#a2694d0d7d254eacf3c39cf3eebe17eda">02081</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#a2694d0d7d254eacf3c39cf3eebe17eda">urlcmp</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _url1, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _url2 )
<a name="l02082"></a>02082 {
<a name="l02083"></a>02083   <span class="comment">// Both empty ?</span>
<a name="l02084"></a>02084   <span class="keywordflow">if</span> ( _url1.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() &amp;&amp; _url2.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l02085"></a>02085     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02086"></a>02086   <span class="comment">// Only one empty ?</span>
<a name="l02087"></a>02087   <span class="keywordflow">if</span> ( _url1.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || _url2.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l02088"></a>02088     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02089"></a>02089 
<a name="l02090"></a>02090   <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> list1 = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">KURL::split</a>( _url1 );
<a name="l02091"></a>02091   <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> list2 = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">KURL::split</a>( _url2 );
<a name="l02092"></a>02092 
<a name="l02093"></a>02093   <span class="comment">// Malformed ?</span>
<a name="l02094"></a>02094   <span class="keywordflow">if</span> ( list1.<a class="codeRef" href="qvaluelist.html#isEmpty">isEmpty</a>() || list2.<a class="codeRef" href="qvaluelist.html#isEmpty">isEmpty</a>() )
<a name="l02095"></a>02095     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02096"></a>02096 
<a name="l02097"></a>02097   <span class="keywordflow">return</span> ( list1 == list2 );
<a name="l02098"></a>02098 }
<a name="l02099"></a>02099 
<a name="l02100"></a><a class="code" href="classKURL.html#a0b58ea663513546270fd380a811b209a">02100</a> <span class="keywordtype">bool</span> <a class="code" href="classKURL.html#a2694d0d7d254eacf3c39cf3eebe17eda">urlcmp</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _url1, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _url2, <span class="keywordtype">bool</span> _ignore_trailing, <span class="keywordtype">bool</span> _ignore_ref )
<a name="l02101"></a>02101 {
<a name="l02102"></a>02102   <span class="comment">// Both empty ?</span>
<a name="l02103"></a>02103   <span class="keywordflow">if</span> ( _url1.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() &amp;&amp; _url2.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l02104"></a>02104     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02105"></a>02105   <span class="comment">// Only one empty ?</span>
<a name="l02106"></a>02106   <span class="keywordflow">if</span> ( _url1.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || _url2.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l02107"></a>02107     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02108"></a>02108 
<a name="l02109"></a>02109   <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> list1 = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">KURL::split</a>( _url1 );
<a name="l02110"></a>02110   <a class="code" href="classKURL_1_1List.html" title="KURL::List is a QValueList that contains KURLs with a few convenience methods.">KURL::List</a> list2 = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">KURL::split</a>( _url2 );
<a name="l02111"></a>02111 
<a name="l02112"></a>02112   <span class="comment">// Malformed ?</span>
<a name="l02113"></a>02113   <span class="keywordflow">if</span> ( list1.<a class="codeRef" href="qvaluelist.html#isEmpty">isEmpty</a>() || list2.<a class="codeRef" href="qvaluelist.html#isEmpty">isEmpty</a>() )
<a name="l02114"></a>02114     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02115"></a>02115 
<a name="l02116"></a>02116   <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size = list1.<a class="codeRef" href="qvaluelist.html#count">count</a>();
<a name="l02117"></a>02117   <span class="keywordflow">if</span> ( list2.<a class="codeRef" href="qvaluelist.html#count">count</a>() != size )
<a name="l02118"></a>02118     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02119"></a>02119 
<a name="l02120"></a>02120   <span class="keywordflow">if</span> ( _ignore_ref )
<a name="l02121"></a>02121   {
<a name="l02122"></a>02122     (*list1.<a class="codeRef" href="qvaluelist.html#begin">begin</a>()).<a class="code" href="classKURL.html#af531d16bdf3ac9a5a8ed27e16f61ebd7" title="Sets the encoded reference part (everything after &#39;#&#39;)">setRef</a>(QString::null);
<a name="l02123"></a>02123     (*list2.<a class="codeRef" href="qvaluelist.html#begin">begin</a>()).<a class="code" href="classKURL.html#af531d16bdf3ac9a5a8ed27e16f61ebd7" title="Sets the encoded reference part (everything after &#39;#&#39;)">setRef</a>(QString::null);
<a name="l02124"></a>02124   }
<a name="l02125"></a>02125 
<a name="l02126"></a>02126   <a class="codeRef" href="qvaluelist.html#Iterator">KURL::List::Iterator</a> it1 = list1.<a class="codeRef" href="qvaluelist.html#begin">begin</a>();
<a name="l02127"></a>02127   <a class="codeRef" href="qvaluelist.html#Iterator">KURL::List::Iterator</a> it2 = list2.<a class="codeRef" href="qvaluelist.html#begin">begin</a>();
<a name="l02128"></a>02128   <span class="keywordflow">for</span>( ; it1 != list1.<a class="codeRef" href="qvaluelist.html#end">end</a>() ; ++it1, ++it2 )
<a name="l02129"></a>02129     <span class="keywordflow">if</span> ( !(*it1).equals( *it2, _ignore_trailing ) )
<a name="l02130"></a>02130       <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02131"></a>02131 
<a name="l02132"></a>02132   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02133"></a>02133 }
<a name="l02134"></a>02134 
<a name="l02135"></a>02135 <a class="codeRef" href="qmap.html">QMap&lt; QString, QString &gt;</a> KURL::queryItems( <span class="keywordtype">int</span> options )<span class="keyword"> const </span>{
<a name="l02136"></a>02136   <span class="keywordflow">return</span> queryItems(options, 0);
<a name="l02137"></a>02137 }
<a name="l02138"></a>02138 
<a name="l02139"></a><a class="code" href="classKURL.html#ae52346d421301e1108b6c19cfd33294f">02139</a> <a class="codeRef" href="qmap.html">QMap&lt; QString, QString &gt;</a> KURL::queryItems( <span class="keywordtype">int</span> options, <span class="keywordtype">int</span> encoding_hint )<span class="keyword"> const </span>{
<a name="l02140"></a>02140   <span class="keywordflow">if</span> ( m_strQuery_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l02141"></a>02141     <span class="keywordflow">return</span> <a class="codeRef" href="qmap.html">QMap&lt;QString,QString&gt;</a>();
<a name="l02142"></a>02142 
<a name="l02143"></a>02143   <a class="codeRef" href="qmap.html">QMap&lt; QString, QString &gt;</a> result;
<a name="l02144"></a>02144   <a class="codeRef" href="qstringlist.html">QStringList</a> items = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">QStringList::split</a>( <span class="charliteral">&#39;&amp;&#39;</span>, m_strQuery_encoded );
<a name="l02145"></a>02145   <span class="keywordflow">for</span> ( QStringList::const_iterator it = items.begin() ; it != items.end() ; ++it ) {
<a name="l02146"></a>02146     <span class="keywordtype">int</span> equal_pos = (*it).find( <span class="charliteral">&#39;=&#39;</span> );
<a name="l02147"></a>02147     <span class="keywordflow">if</span> ( equal_pos &gt; 0 ) { <span class="comment">// = is not the first char...</span>
<a name="l02148"></a>02148       <a class="codeRef" href="qstring.html">QString</a> name = (*it).left( equal_pos );
<a name="l02149"></a>02149       <span class="keywordflow">if</span> ( options &amp; <a class="code" href="classKURL.html#aace5360569cdbcf648569f45e92e9002a676bc8515e367e5614f4aea0e618f3c7" title="Normalize query keys to lowercase.">CaseInsensitiveKeys</a> )
<a name="l02150"></a>02150     name = name.<a class="codeRef" href="qstring.html#lower">lower</a>();
<a name="l02151"></a>02151       <a class="codeRef" href="qstring.html">QString</a> value = (*it).<a class="codeRef" href="qstring.html#mid">mid</a>( equal_pos + 1 );
<a name="l02152"></a>02152       <span class="keywordflow">if</span> ( value.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l02153"></a>02153     result.<a class="codeRef" href="qmap.html#insert">insert</a>( name, <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>(<span class="stringliteral">&quot;&quot;</span>) );
<a name="l02154"></a>02154       <span class="keywordflow">else</span> {
<a name="l02155"></a>02155     <span class="comment">// ### why is decoding name not necessary?</span>
<a name="l02156"></a>02156     value.<a class="codeRef" href="qstring.html#replace">replace</a>( <span class="charliteral">&#39;+&#39;</span>, <span class="charliteral">&#39; &#39;</span> ); <span class="comment">// + in queries means space</span>
<a name="l02157"></a>02157     result.<a class="codeRef" href="qmap.html#insert">insert</a>( name, <a class="code" href="classKURL.html#abbdd1c868880355a4eb6daa4a71926b0" title="Decodes a string as used in URLs.">decode_string</a>( value, encoding_hint ) );
<a name="l02158"></a>02158       }
<a name="l02159"></a>02159     } <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( equal_pos &lt; 0 ) { <span class="comment">// no =</span>
<a name="l02160"></a>02160       <a class="codeRef" href="qstring.html">QString</a> name = (*it);
<a name="l02161"></a>02161       <span class="keywordflow">if</span> ( options &amp; <a class="code" href="classKURL.html#aace5360569cdbcf648569f45e92e9002a676bc8515e367e5614f4aea0e618f3c7" title="Normalize query keys to lowercase.">CaseInsensitiveKeys</a> )
<a name="l02162"></a>02162     name = name.<a class="codeRef" href="qstring.html#lower">lower</a>();
<a name="l02163"></a>02163       result.<a class="codeRef" href="qmap.html#insert">insert</a>( name, QString::null );
<a name="l02164"></a>02164     }
<a name="l02165"></a>02165   }
<a name="l02166"></a>02166 
<a name="l02167"></a>02167   <span class="keywordflow">return</span> result;
<a name="l02168"></a>02168 }
<a name="l02169"></a>02169 
<a name="l02170"></a><a class="code" href="classKURL.html#a24115e5a48e1ea3a5247002dcbf3a18e">02170</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a24115e5a48e1ea3a5247002dcbf3a18e" title="Returns the value of a certain query item.">KURL::queryItem</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _item )<span class="keyword"> const</span>
<a name="l02171"></a>02171 <span class="keyword"></span>{
<a name="l02172"></a>02172   <span class="keywordflow">return</span> <a class="code" href="classKURL.html#a24115e5a48e1ea3a5247002dcbf3a18e" title="Returns the value of a certain query item.">queryItem</a>( _item, 0 );
<a name="l02173"></a>02173 }
<a name="l02174"></a>02174 
<a name="l02175"></a><a class="code" href="classKURL.html#a84d79633bc77b8dda2a91977a6ba0594">02175</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a24115e5a48e1ea3a5247002dcbf3a18e" title="Returns the value of a certain query item.">KURL::queryItem</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _item, <span class="keywordtype">int</span> encoding_hint )<span class="keyword"> const</span>
<a name="l02176"></a>02176 <span class="keyword"></span>{
<a name="l02177"></a>02177   <a class="codeRef" href="qstring.html">QString</a> item = _item + <span class="charliteral">&#39;=&#39;</span>;
<a name="l02178"></a>02178   <span class="keywordflow">if</span> ( m_strQuery_encoded.<a class="codeRef" href="qstring.html#length">length</a>() &lt;= 1 )
<a name="l02179"></a>02179     <span class="keywordflow">return</span> QString::null;
<a name="l02180"></a>02180 
<a name="l02181"></a>02181   <a class="codeRef" href="qstringlist.html">QStringList</a> items = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">QStringList::split</a>( <span class="charliteral">&#39;&amp;&#39;</span>, m_strQuery_encoded );
<a name="l02182"></a>02182   <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> _len = item.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l02183"></a>02183   <span class="keywordflow">for</span> ( QStringList::ConstIterator it = items.begin(); it != items.end(); ++it )
<a name="l02184"></a>02184   {
<a name="l02185"></a>02185     <span class="keywordflow">if</span> ( (*it).startsWith( item ) )
<a name="l02186"></a>02186     {
<a name="l02187"></a>02187       <span class="keywordflow">if</span> ( (*it).length() &gt; _len )
<a name="l02188"></a>02188       {
<a name="l02189"></a>02189         <a class="codeRef" href="qstring.html">QString</a> str = (*it).<a class="codeRef" href="qstring.html#mid">mid</a>( _len );
<a name="l02190"></a>02190         str.<a class="codeRef" href="qstring.html#replace">replace</a>( <span class="charliteral">&#39;+&#39;</span>, <span class="charliteral">&#39; &#39;</span> ); <span class="comment">// + in queries means space.</span>
<a name="l02191"></a>02191         <span class="keywordflow">return</span> <a class="code" href="classKURL.html#abbdd1c868880355a4eb6daa4a71926b0" title="Decodes a string as used in URLs.">decode_string</a>( str, encoding_hint );
<a name="l02192"></a>02192       }
<a name="l02193"></a>02193       <span class="keywordflow">else</span> <span class="comment">// empty value</span>
<a name="l02194"></a>02194         <span class="keywordflow">return</span> <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>(<span class="stringliteral">&quot;&quot;</span>);
<a name="l02195"></a>02195     }
<a name="l02196"></a>02196   }
<a name="l02197"></a>02197 
<a name="l02198"></a>02198   <span class="keywordflow">return</span> QString::null;
<a name="l02199"></a>02199 }
<a name="l02200"></a>02200 
<a name="l02201"></a><a class="code" href="classKURL.html#a86529c33c0fd3f281fdc2e8b01f2d84c">02201</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a86529c33c0fd3f281fdc2e8b01f2d84c" title="Removea an item from the query.">KURL::removeQueryItem</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _item )
<a name="l02202"></a>02202 {
<a name="l02203"></a>02203   <a class="codeRef" href="qstring.html">QString</a> item = _item + <span class="charliteral">&#39;=&#39;</span>;
<a name="l02204"></a>02204   <span class="keywordflow">if</span> ( m_strQuery_encoded.<a class="codeRef" href="qstring.html#length">length</a>() &lt;= 1 )
<a name="l02205"></a>02205     <span class="keywordflow">return</span>;
<a name="l02206"></a>02206 
<a name="l02207"></a>02207   <a class="codeRef" href="qstringlist.html">QStringList</a> items = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">QStringList::split</a>( <span class="charliteral">&#39;&amp;&#39;</span>, m_strQuery_encoded );
<a name="l02208"></a>02208   <span class="keywordflow">for</span> ( QStringList::Iterator it = items.begin(); it != items.end(); )
<a name="l02209"></a>02209   {
<a name="l02210"></a>02210     <span class="keywordflow">if</span> ( (*it).startsWith( item ) || (*it == _item) )
<a name="l02211"></a>02211     {
<a name="l02212"></a>02212       QStringList::Iterator deleteIt = it;
<a name="l02213"></a>02213       ++it;
<a name="l02214"></a>02214       items.remove(deleteIt);
<a name="l02215"></a>02215     }
<a name="l02216"></a>02216     <span class="keywordflow">else</span>
<a name="l02217"></a>02217     {
<a name="l02218"></a>02218        ++it;
<a name="l02219"></a>02219     }
<a name="l02220"></a>02220   }
<a name="l02221"></a>02221   m_strQuery_encoded = items.<a class="codeRef" href="qstringlist.html#join">join</a>( <span class="stringliteral">&quot;&amp;&quot;</span> );
<a name="l02222"></a>02222 }
<a name="l02223"></a>02223 
<a name="l02224"></a><a class="code" href="classKURL.html#a324fac18c2e755dc1cc0b479b75a1bbb">02224</a> <span class="keywordtype">void</span> <a class="code" href="classKURL.html#a324fac18c2e755dc1cc0b479b75a1bbb" title="Adds an additional query item.">KURL::addQueryItem</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _item, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _value, <span class="keywordtype">int</span> encoding_hint )
<a name="l02225"></a>02225 {
<a name="l02226"></a>02226   <a class="codeRef" href="qstring.html">QString</a> item = _item + <span class="charliteral">&#39;=&#39;</span>;
<a name="l02227"></a>02227   <a class="codeRef" href="qstring.html">QString</a> value = encode( _value, 0, encoding_hint );
<a name="l02228"></a>02228 
<a name="l02229"></a>02229   <span class="keywordflow">if</span> (!m_strQuery_encoded.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l02230"></a>02230      m_strQuery_encoded += <span class="charliteral">&#39;&amp;&#39;</span>;
<a name="l02231"></a>02231   m_strQuery_encoded += item + value;
<a name="l02232"></a>02232 }
<a name="l02233"></a>02233 
<a name="l02234"></a>02234 <span class="comment">// static</span>
<a name="l02235"></a><a class="code" href="classKURL.html#a5c3370590e8fbae93d5c10197489fcfc">02235</a> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> <a class="code" href="classKURL.html#a5c3370590e8fbae93d5c10197489fcfc" title="Creates a KURL object from a QString representing either an absolute path or a real URL...">KURL::fromPathOrURL</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; text )
<a name="l02236"></a>02236 {
<a name="l02237"></a>02237     <span class="keywordflow">if</span> ( text.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l02238"></a>02238         <span class="keywordflow">return</span> <a class="code" href="classKURL.html#a71e859f230741869c427ba2e7a9c90a9" title="Constructs an empty URL.">KURL</a>();
<a name="l02239"></a>02239 
<a name="l02240"></a>02240     <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> <a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>;
<a name="l02241"></a>02241     <span class="keywordflow">if</span> (!<a class="codeRef" href="qdir.html#isRelativePath">QDir::isRelativePath</a>(text))
<a name="l02242"></a>02242         url.<a class="code" href="classKURL.html#a6c0a0828b4b9f1126b13380076e2b2f3" title="Sets the decoded path of the URL.">setPath</a>( text );
<a name="l02243"></a>02243     <span class="keywordflow">else</span>
<a name="l02244"></a>02244         url = text;
<a name="l02245"></a>02245 
<a name="l02246"></a>02246     <span class="keywordflow">return</span> <a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>;
<a name="l02247"></a>02247 }
<a name="l02248"></a>02248 
<a name="l02249"></a>02249 <span class="keyword">static</span> <a class="codeRef" href="qstring.html">QString</a> _relativePath(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;base_dir, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;path, <span class="keywordtype">bool</span> &amp;isParent)
<a name="l02250"></a>02250 {
<a name="l02251"></a>02251    <a class="codeRef" href="qstring.html">QString</a> _base_dir(<a class="codeRef" href="qdir.html#cleanDirPath">QDir::cleanDirPath</a>(base_dir));
<a name="l02252"></a>02252    <a class="codeRef" href="qstring.html">QString</a> _path(<a class="codeRef" href="qdir.html#cleanDirPath">QDir::cleanDirPath</a>(path.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || (path[0] != <span class="charliteral">&#39;/&#39;</span>) ? _base_dir+<span class="stringliteral">&quot;/&quot;</span>+path : path));
<a name="l02253"></a>02253 
<a name="l02254"></a>02254    <span class="keywordflow">if</span> (_base_dir.isEmpty())
<a name="l02255"></a>02255       <span class="keywordflow">return</span> _path;
<a name="l02256"></a>02256 
<a name="l02257"></a>02257    <span class="keywordflow">if</span> (_base_dir[_base_dir.length()-1] != <span class="charliteral">&#39;/&#39;</span>)
<a name="l02258"></a>02258       _base_dir.<a class="codeRef" href="qstring.html#append">append</a>(<span class="charliteral">&#39;/&#39;</span>);
<a name="l02259"></a>02259 
<a name="l02260"></a>02260    <a class="codeRef" href="qstringlist.html">QStringList</a> list1 = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">QStringList::split</a>(<span class="charliteral">&#39;/&#39;</span>, _base_dir);
<a name="l02261"></a>02261    <a class="codeRef" href="qstringlist.html">QStringList</a> list2 = <a class="code" href="classKURL.html#a411d9ebf2f0c66e58721776271537316" title="Splits nested URLs into a list of URLs.">QStringList::split</a>(<span class="charliteral">&#39;/&#39;</span>, _path);
<a name="l02262"></a>02262 
<a name="l02263"></a>02263    <span class="comment">// Find where they meet</span>
<a name="l02264"></a>02264    uint level = 0;
<a name="l02265"></a>02265    uint maxLevel = QMIN(list1.count(), list2.count());
<a name="l02266"></a>02266    <span class="keywordflow">while</span>((level &lt; maxLevel) &amp;&amp; (list1[level] == list2[level])) level++;
<a name="l02267"></a>02267 
<a name="l02268"></a>02268    <a class="codeRef" href="qstring.html">QString</a> result;
<a name="l02269"></a>02269    <span class="comment">// Need to go down out of the first path to the common branch.</span>
<a name="l02270"></a>02270    <span class="keywordflow">for</span>(uint i = level; i &lt; list1.count(); i++)
<a name="l02271"></a>02271       result.<a class="codeRef" href="qstring.html#append">append</a>(<span class="stringliteral">&quot;../&quot;</span>);
<a name="l02272"></a>02272 
<a name="l02273"></a>02273    <span class="comment">// Now up up from the common branch to the second path.</span>
<a name="l02274"></a>02274    <span class="keywordflow">for</span>(uint i = level; i &lt; list2.count(); i++)
<a name="l02275"></a>02275       result.<a class="codeRef" href="qstring.html#append">append</a>(list2[i]).append(<span class="stringliteral">&quot;/&quot;</span>);
<a name="l02276"></a>02276 
<a name="l02277"></a>02277    <span class="keywordflow">if</span> ((level &lt; list2.count()) &amp;&amp; (path[path.<a class="codeRef" href="qstring.html#length">length</a>()-1] != <span class="charliteral">&#39;/&#39;</span>))
<a name="l02278"></a>02278       result.<a class="codeRef" href="qstring.html#truncate">truncate</a>(result.<a class="codeRef" href="qstring.html#length">length</a>()-1);
<a name="l02279"></a>02279 
<a name="l02280"></a>02280    isParent = (level == list1.count());
<a name="l02281"></a>02281 
<a name="l02282"></a>02282    <span class="keywordflow">return</span> result;
<a name="l02283"></a>02283 }
<a name="l02284"></a>02284 
<a name="l02285"></a><a class="code" href="classKURL.html#a8cc9fd7108ba1c161dcc88993e8e4923">02285</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a8cc9fd7108ba1c161dcc88993e8e4923" title="Creates a path relative to a base path for a given input path.">KURL::relativePath</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;base_dir, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;path, <span class="keywordtype">bool</span> *isParent)
<a name="l02286"></a>02286 {
<a name="l02287"></a>02287    <span class="keywordtype">bool</span> parent = <span class="keyword">false</span>;
<a name="l02288"></a>02288    <a class="codeRef" href="qstring.html">QString</a> result = _relativePath(base_dir, path, parent);
<a name="l02289"></a>02289    <span class="keywordflow">if</span> (parent)
<a name="l02290"></a>02290       result.<a class="codeRef" href="qstring.html#prepend">prepend</a>(<span class="stringliteral">&quot;./&quot;</span>);
<a name="l02291"></a>02291 
<a name="l02292"></a>02292    <span class="keywordflow">if</span> (isParent)
<a name="l02293"></a>02293       *isParent = parent;
<a name="l02294"></a>02294 
<a name="l02295"></a>02295    <span class="keywordflow">return</span> result;
<a name="l02296"></a>02296 }
<a name="l02297"></a>02297 
<a name="l02298"></a>02298 
<a name="l02299"></a><a class="code" href="classKURL.html#a7f7c85dfee5668f24aba599b7f05f175">02299</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKURL.html#a7f7c85dfee5668f24aba599b7f05f175" title="Creates an URL relative to a base URL for a given input URL.">KURL::relativeURL</a>(<span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> &amp;base_url, <span class="keyword">const</span> <a class="code" href="classKURL.html" title="Represents and parses a URL.">KURL</a> &amp;<a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>, <span class="keywordtype">int</span> encoding_hint)
<a name="l02300"></a>02300 {
<a name="l02301"></a>02301    <span class="keywordflow">if</span> ((url.<a class="code" href="classKURL.html#a4be1d1602a1d0f0afeee230167ebfdc4" title="Returns the protocol for the URL.">protocol</a>() != base_url.<a class="code" href="classKURL.html#a4be1d1602a1d0f0afeee230167ebfdc4" title="Returns the protocol for the URL.">protocol</a>()) ||
<a name="l02302"></a>02302        (url.<a class="code" href="classKURL.html#adf3ad35581a0ca25ecc16e073f8275ca" title="Returns the decoded hostname included in the URL.">host</a>() != base_url.<a class="code" href="classKURL.html#adf3ad35581a0ca25ecc16e073f8275ca" title="Returns the decoded hostname included in the URL.">host</a>()) ||
<a name="l02303"></a>02303        (url.<a class="code" href="classKURL.html#a205598afc6842db13e4ad996ba1d9422" title="Returns the port number included in the URL.">port</a>() &amp;&amp; url.<a class="code" href="classKURL.html#a205598afc6842db13e4ad996ba1d9422" title="Returns the port number included in the URL.">port</a>() != base_url.<a class="code" href="classKURL.html#a205598afc6842db13e4ad996ba1d9422" title="Returns the port number included in the URL.">port</a>()) ||
<a name="l02304"></a>02304        (url.<a class="code" href="classKURL.html#a2c6b8f18351722e9280b99d869572989" title="Tests if this URL has a user name included in it.">hasUser</a>() &amp;&amp; url.<a class="code" href="classKURL.html#ae5459bd5b7101d5bbfbff17ce2a43027" title="Returns the decoded user name (login, user id, etc) included in the URL.">user</a>() != base_url.<a class="code" href="classKURL.html#ae5459bd5b7101d5bbfbff17ce2a43027" title="Returns the decoded user name (login, user id, etc) included in the URL.">user</a>()) ||
<a name="l02305"></a>02305        (url.<a class="code" href="classKURL.html#ab6aa391061678b69b314a6b403d0ace2" title="Tests if this URL has a password included in it.">hasPass</a>() &amp;&amp; url.<a class="code" href="classKURL.html#a0bd95e7e1a54ab12b56439495f00bff6" title="Returns the decoded password (corresponding to user()) included in the URL.">pass</a>() != base_url.<a class="code" href="classKURL.html#a0bd95e7e1a54ab12b56439495f00bff6" title="Returns the decoded password (corresponding to user()) included in the URL.">pass</a>()))
<a name="l02306"></a>02306    {
<a name="l02307"></a>02307       <span class="keywordflow">return</span> url.<a class="code" href="classKURL.html#aaf8593b924647a9db73016fbeab1812a" title="Returns the URL as string, with all escape sequences intact, encoded in a given charset.">url</a>(0, encoding_hint);
<a name="l02308"></a>02308    }
<a name="l02309"></a>02309 
<a name="l02310"></a>02310    <a class="codeRef" href="qstring.html">QString</a> relURL;
<a name="l02311"></a>02311 
<a name="l02312"></a>02312    <span class="keywordflow">if</span> ((base_url.<a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>() != url.<a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>()) || (base_url.<a class="code" href="classKURL.html#a0a28c0873806d04a7fd4e19feeb4bd63" title="Returns the encoded query of the URL.">query</a>() != url.<a class="code" href="classKURL.html#a0a28c0873806d04a7fd4e19feeb4bd63" title="Returns the encoded query of the URL.">query</a>()))
<a name="l02313"></a>02313    {
<a name="l02314"></a>02314       <span class="keywordtype">bool</span> dummy;
<a name="l02315"></a>02315       <a class="codeRef" href="qstring.html">QString</a> basePath = base_url.<a class="code" href="classKURL.html#a0ff924855867aa98d0cbb5f3f20f4f87" title="Returns the directory of the path.">directory</a>(<span class="keyword">false</span>, <span class="keyword">false</span>);
<a name="l02316"></a>02316       relURL = encode( _relativePath(basePath, url.<a class="code" href="classKURL.html#add464ac157c5ee326847ddaef7ae2d19" title="Returns the current decoded path.">path</a>(), dummy), 1, encoding_hint);
<a name="l02317"></a>02317       relURL += url.<a class="code" href="classKURL.html#a0a28c0873806d04a7fd4e19feeb4bd63" title="Returns the encoded query of the URL.">query</a>();
<a name="l02318"></a>02318    }
<a name="l02319"></a>02319 
<a name="l02320"></a>02320    <span class="keywordflow">if</span> ( url.<a class="code" href="classKURL.html#add38e3181b6ebf71290f0353d6630518" title="Tests if the URL has a reference part.">hasRef</a>() )
<a name="l02321"></a>02321    {
<a name="l02322"></a>02322       relURL += <span class="stringliteral">&quot;#&quot;</span>;
<a name="l02323"></a>02323       relURL += url.<a class="code" href="classKURL.html#a53f4194e147b11b678760340d62b3043" title="Returns the encoded reference of the URL.">ref</a>();
<a name="l02324"></a>02324    }
<a name="l02325"></a>02325 
<a name="l02326"></a>02326    <span class="keywordflow">if</span> ( relURL.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l02327"></a>02327       <span class="keywordflow">return</span> <span class="stringliteral">&quot;./&quot;</span>;
<a name="l02328"></a>02328 
<a name="l02329"></a>02329    <span class="keywordflow">return</span> relURL;
<a name="l02330"></a>02330 }
<a name="l02331"></a>02331 
<a name="l02332"></a><a class="code" href="classKURL.html#a5f99cb1b7d49f3ddb2a56aa036957269">02332</a> <span class="keywordtype">int</span> <a class="code" href="classKURL.html#a5f99cb1b7d49f3ddb2a56aa036957269" title="Returns the URI processing mode for the URL.">KURL::uriMode</a>()<span class="keyword"> const</span>
<a name="l02333"></a>02333 <span class="keyword"></span>{
<a name="l02334"></a>02334   <span class="keywordflow">return</span> m_iUriMode;
<a name="l02335"></a>02335 }
<a name="l02336"></a>02336 
<a name="l02337"></a><a class="code" href="classKURL.html#ad400be8a7ea5af29184581da39abe7ce">02337</a> <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25" title="Defines the type of URI we are processing.">KURL::URIMode</a> <a class="code" href="classKURL.html#ad400be8a7ea5af29184581da39abe7ce" title="Determines which URI mode is suitable for processing URIs of a given protocol.">KURL::uriModeForProtocol</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; <a class="code" href="classKURL.html#a4be1d1602a1d0f0afeee230167ebfdc4" title="Returns the protocol for the URL.">protocol</a>)
<a name="l02338"></a>02338 {
<a name="l02339"></a>02339 <span class="preprocessor">#ifndef KDE_QT_ONLY</span>
<a name="l02340"></a>02340 <span class="preprocessor"></span>    <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25" title="Defines the type of URI we are processing.">KURL::URIMode</a> mode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a9db85130d0702a27e41777d7c767acca" title="Automatically detected.">Auto</a>;
<a name="l02341"></a>02341     <span class="keywordflow">if</span> (protocol == fileProt)
<a name="l02342"></a>02342         <span class="keywordflow">return</span> <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a>;
<a name="l02343"></a>02343     <span class="keywordflow">if</span> (KGlobal::_instance)
<a name="l02344"></a>02344         mode = KProtocolInfo::uriParseMode(protocol);
<a name="l02345"></a>02345     <span class="keywordflow">if</span> (mode == <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a9db85130d0702a27e41777d7c767acca" title="Automatically detected.">Auto</a> ) {
<a name="l02346"></a>02346 <span class="preprocessor">#else</span>
<a name="l02347"></a>02347 <span class="preprocessor"></span>        <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25" title="Defines the type of URI we are processing.">KURL::URIMode</a> mode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a9db85130d0702a27e41777d7c767acca" title="Automatically detected.">Auto</a>;
<a name="l02348"></a>02348 <span class="preprocessor">#endif</span>
<a name="l02349"></a>02349 <span class="preprocessor"></span>    <span class="keywordflow">if</span> ( protocol == <span class="stringliteral">&quot;ed2k&quot;</span> || protocol == <span class="stringliteral">&quot;sig2dat&quot;</span> || protocol == <span class="stringliteral">&quot;slsk&quot;</span> || protocol == <span class="stringliteral">&quot;data&quot;</span> ) mode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25ae1438b681934016b65507c804f933c30" title="Raw URI.">RawURI</a>;
<a name="l02350"></a>02350     <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( protocol == <span class="stringliteral">&quot;mailto&quot;</span> ) mode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25add1a21fcdf4c90f451c256191553c6f7" title="Mailto URI.">Mailto</a>;
<a name="l02351"></a>02351     <span class="keywordflow">else</span> mode = <a class="code" href="classKURL.html#ae02a2dbcced8e7219eec8d30bada0d25a5b1d60824c0e38e36c28ddd5f34a9569" title="Standards compliant URL.">URL</a>;
<a name="l02352"></a>02352 <span class="preprocessor">#ifndef KDE_QT_ONLY</span>
<a name="l02353"></a>02353 <span class="preprocessor"></span>    }
<a name="l02354"></a>02354 <span class="preprocessor">#endif</span>
<a name="l02355"></a>02355 <span class="preprocessor"></span>    <span class="keywordflow">return</span> mode;
<a name="l02356"></a>02356 }
</pre></div></div>
</div>
    </div></div>


      </td>
  </tr>
  <tr>
    <td valign="top" id="leftmenu" width="25%">
      <a name="navigation"></a>
      <div class="menu_box"><h2>kdecore</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="modules.html">Modules</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
  <option value="classKAboutData.html">kaboutdata</option>,  <option value="classKAboutPerson.html">kaboutperson</option>,  <option value="classKAboutTranslator.html">kabouttranslator</option>,  <option value="classKAccel.html">kaccel</option>,  <option value="classKAcceleratorManager.html">kacceleratormanager</option>,  <option value="classKAccelManagerAlgorithm.html">kaccelmanageralgorithm</option>,  <option value="classKAccelShortcutList.html">kaccelshortcutlist</option>,  <option value="classKAccelString.html">kaccelstring</option>,  <option value="classKAddressInfo.html">kaddressinfo</option>,  <option value="classKAppDCOPInterface.html">kappdcopinterface</option>,  <option value="classKApplication.html">kapplication</option>,  <option value="classKAsyncIO.html">kasyncio</option>,  <option value="classKAudioPlayer.html">kaudioplayer</option>,  <option value="classKBufferedIO.html">kbufferedio</option>,  <option value="classKCalendarSystem.html">kcalendarsystem</option>,  <option value="classKCalendarSystemFactory.html">kcalendarsystemfactory</option>,  <option value="classKCalendarSystemJalali.html">kcalendarsystemjalali</option>,  <option value="classKCatalogue.html">kcatalogue</option>,  <option value="classKCharMacroExpander.html">kcharmacroexpander</option>,  <option value="classKCharsets.html">kcharsets</option>,  <option value="classKClipboardSynchronizer.html">kclipboardsynchronizer</option>,  <option value="classKCmdLineArgs.html">kcmdlineargs</option>,  <option value="classKCodecs.html">kcodecs</option>,  <option value="classKCompletion.html">kcompletion</option>,  <option value="classKCompletionBase.html">kcompletionbase</option>,  <option value="classKCompletionMatches.html">kcompletionmatches</option>,  <option value="classKCompTreeNode.html">kcomptreenode</option>,  <option value="classKConfig.html">kconfig</option>,  <option value="classKConfigBackEnd.html">kconfigbackend</option>,  <option value="classKConfigBase.html">kconfigbase</option>,  <option value="classKConfigDialogManager.html">kconfigdialogmanager</option>,  <option value="classKConfigGroup.html">kconfiggroup</option>,  <option value="classKConfigGroupSaver.html">kconfiggroupsaver</option>,  <option value="classKConfigINIBackEnd.html">kconfiginibackend</option>,  <option value="classKConfigSkeleton.html">kconfigskeleton</option>,  <option value="classKConfigSkeleton_1_1ItemBool.html">kconfigskeleton::itembool</option>,  <option value="classKConfigSkeleton_1_1ItemColor.html">kconfigskeleton::itemcolor</option>,  <option value="classKConfigSkeleton_1_1ItemDateTime.html">kconfigskeleton::itemdatetime</option>,  <option value="classKConfigSkeleton_1_1ItemDouble.html">kconfigskeleton::itemdouble</option>,  <option value="classKConfigSkeleton_1_1ItemEnum.html">kconfigskeleton::itemenum</option>,  <option value="classKConfigSkeleton_1_1ItemFont.html">kconfigskeleton::itemfont</option>,  <option value="classKConfigSkeleton_1_1ItemInt.html">kconfigskeleton::itemint</option>,  <option value="classKConfigSkeleton_1_1ItemInt64.html">kconfigskeleton::itemint64</option>,  <option value="classKConfigSkeleton_1_1ItemIntList.html">kconfigskeleton::itemintlist</option>,  <option value="classKConfigSkeleton_1_1ItemLong.html">kconfigskeleton::itemlong</option>,  <option value="classKConfigSkeleton_1_1ItemPassword.html">kconfigskeleton::itempassword</option>,  <option value="classKConfigSkeleton_1_1ItemPath.html">kconfigskeleton::itempath</option>,  <option value="classKConfigSkeleton_1_1ItemPathList.html">kconfigskeleton::itempathlist</option>,  <option value="classKConfigSkeleton_1_1ItemPoint.html">kconfigskeleton::itempoint</option>,  <option value="classKConfigSkeleton_1_1ItemProperty.html">kconfigskeleton::itemproperty</option>,  <option value="classKConfigSkeleton_1_1ItemRect.html">kconfigskeleton::itemrect</option>,  <option value="classKConfigSkeleton_1_1ItemSize.html">kconfigskeleton::itemsize</option>,  <option value="classKConfigSkeleton_1_1ItemString.html">kconfigskeleton::itemstring</option>,  <option value="classKConfigSkeleton_1_1ItemStringList.html">kconfigskeleton::itemstringlist</option>,  <option value="classKConfigSkeleton_1_1ItemUInt.html">kconfigskeleton::itemuint</option>,  <option value="classKConfigSkeleton_1_1ItemUInt64.html">kconfigskeleton::itemuint64</option>,  <option value="classKConfigSkeleton_1_1ItemULong.html">kconfigskeleton::itemulong</option>,  <option value="classKConfigSkeletonItem.html">kconfigskeletonitem</option>,  <option value="classKCrash.html">kcrash</option>,  <option value="classKDCOPPropertyProxy.html">kdcoppropertyproxy</option>,  <option value="classKDebugDCOPIface.html">kdebugdcopiface</option>,  <option value="classKDesktopFile.html">kdesktopfile</option>,  <option value="classKExtendedSocket.html">kextendedsocket</option>,  <option value="classKGenericFactory.html">kgenericfactory</option>,  <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01KTypeList_3_01Pare1ed8d1e5a9847c99711cad3b12c7e96c.html">kgenericfactory< ktypelist< product, productlisttail >, ktypelist< pare1ed8d1e5a9847c99711cad3b12c7e96c</option>,  <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01KTypeList_3_01Paref6a00f76851e0daa2cb662bb8a41fc7f.html">kgenericfactory< ktypelist< product, productlisttail >, ktypelist< paref6a00f76851e0daa2cb662bb8a41fc7f</option>,  <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01QObject_01_4.html">kgenericfactory< ktypelist< product, productlisttail >, qobject ></option>,  <option value="classKGlobal.html">kglobal</option>,  <option value="classKGlobalAccel.html">kglobalaccel</option>,  <option value="classKGlobalSettings.html">kglobalsettings</option>,  <option value="classKIcon.html">kicon</option>,  <option value="classKIconEffect.html">kiconeffect</option>,  <option value="classKIconLoader.html">kiconloader</option>,  <option value="classKIconTheme.html">kicontheme</option>,  <option value="classKInetSocketAddress.html">kinetsocketaddress</option>,  <option value="classKInstance.html">kinstance</option>,  <option value="classKIOBufferBase.html">kiobufferbase</option>,  <option value="classKIPC.html">kipc</option>,  <option value="classKKey.html">kkey</option>,  <option value="classKKeyNative.html">kkeynative</option>,  <option value="classKKeySequence.html">kkeysequence</option>,  <option value="classKLibFactory.html">klibfactory</option>,  <option value="classKLibLoader.html">klibloader</option>,  <option value="classKLibrary.html">klibrary</option>,  <option value="classKLocale.html">klocale</option>,  <option value="classKLockFile.html">klockfile</option>,  <option value="classKMacroExpanderBase.html">kmacroexpanderbase</option>,  <option value="classKMD4.html">kmd4</option>,  <option value="classKMD5.html">kmd5</option>,  <option value="classKMimeSourceFactory.html">kmimesourcefactory</option>,  <option value="classKMountPoint.html">kmountpoint</option>,  <option value="classKMultipleDrag.html">kmultipledrag</option>,  <option value="classKNetwork_1_1KActiveSocketBase.html">knetwork::kactivesocketbase</option>,  <option value="classKNetwork_1_1KBufferedSocket.html">knetwork::kbufferedsocket</option>,  <option value="classKNetwork_1_1KClientSocketBase.html">knetwork::kclientsocketbase</option>,  <option value="classKNetwork_1_1KDatagramPacket.html">knetwork::kdatagrampacket</option>,  <option value="classKNetwork_1_1KDatagramSocket.html">knetwork::kdatagramsocket</option>,  <option value="classKNetwork_1_1KHttpProxySocketDevice.html">knetwork::khttpproxysocketdevice</option>,  <option value="classKNetwork_1_1KInetSocketAddress.html">knetwork::kinetsocketaddress</option>,  <option value="classKNetwork_1_1KIpAddress.html">knetwork::kipaddress</option>,  <option value="classKNetwork_1_1KMulticastSocket.html">knetwork::kmulticastsocket</option>,  <option value="classKNetwork_1_1KMulticastSocketImpl.html">knetwork::kmulticastsocketimpl</option>,  <option value="classKNetwork_1_1KNetworkInterface.html">knetwork::knetworkinterface</option>,  <option value="classKNetwork_1_1KPassiveSocketBase.html">knetwork::kpassivesocketbase</option>,  <option value="classKNetwork_1_1KResolver.html">knetwork::kresolver</option>,  <option value="classKNetwork_1_1KResolverEntry.html">knetwork::kresolverentry</option>,  <option value="classKNetwork_1_1KResolverResults.html">knetwork::kresolverresults</option>,  <option value="classKNetwork_1_1KResolverWorkerBase_1_1ResolverLocker.html">knetwork::kresolverworkerbase::resolverlocker</option>,  <option value="classKNetwork_1_1KReverseResolver.html">knetwork::kreverseresolver</option>,  <option value="classKNetwork_1_1KServerSocket.html">knetwork::kserversocket</option>,  <option value="classKNetwork_1_1KSocketAddress.html">knetwork::ksocketaddress</option>,  <option value="classKNetwork_1_1KSocketBase.html">knetwork::ksocketbase</option>,  <option value="classKNetwork_1_1KSocketDevice.html">knetwork::ksocketdevice</option>,  <option value="classKNetwork_1_1KSocketDeviceFactory.html">knetwork::ksocketdevicefactory</option>,  <option value="classKNetwork_1_1KSocksSocketDevice.html">knetwork::ksockssocketdevice</option>,  <option value="classKNetwork_1_1KStreamSocket.html">knetwork::kstreamsocket</option>,  <option value="classKNetwork_1_1KUnixSocketAddress.html">knetwork::kunixsocketaddress</option>,  <option value="classKNotifyClient_1_1Instance.html">knotifyclient::instance</option>,  <option value="classKPalette.html">kpalette</option>,  <option value="classKPixmapProvider.html">kpixmapprovider</option>,  <option value="classKPopupAccelManager.html">kpopupaccelmanager</option>,  <option value="classKProcess.html">kprocess</option>,  <option value="classKProcessController.html">kprocesscontroller</option>,  <option value="classKProcIO.html">kprocio</option>,  <option value="classKProtocolInfoFactory.html">kprotocolinfofactory</option>,  <option value="classKPty.html">kpty</option>,  <option value="classKRandomSequence.html">krandomsequence</option>,  <option value="classKRegExp.html">kregexp</option>,  <option value="classKRegExpPrivate.html">kregexpprivate</option>,  <option value="classKRFCDate.html">krfcdate</option>,  <option value="classKRootProp.html">krootprop</option>,  <option value="classKSaveFile.html">ksavefile</option>,  <option value="classKServerSocket.html">kserversocket</option>,  <option value="classKSessionManaged.html">ksessionmanaged</option>,  <option value="classKShared.html">kshared</option>,  <option value="classKSharedConfig.html">ksharedconfig</option>,  <option value="classKSharedPtr.html">ksharedptr</option>,  <option value="classKShellProcess.html">kshellprocess</option>,  <option value="classKShortcut.html">kshortcut</option>,  <option value="classKShortcutList.html">kshortcutlist</option>,  <option value="classKSimpleConfig.html">ksimpleconfig</option>,  <option value="classKSocket.html">ksocket</option>,  <option value="classKSocketAddress.html">ksocketaddress</option>,  <option value="classKSocks.html">ksocks</option>,  <option value="classKSortableItem.html">ksortableitem</option>,  <option value="classKSortableValueList.html">ksortablevaluelist</option>,  <option value="classKStandardDirs.html">kstandarddirs</option>,  <option value="classKStaticDeleter.html">kstaticdeleter</option>,  <option value="classKStaticDeleterBase.html">kstaticdeleterbase</option>,  <option value="classKStdAccel_1_1ShortcutList.html">kstdaccel::shortcutlist</option>,  <option value="classKStringHandler.html">kstringhandler</option>,  <option value="classKSycocaEntry.html">ksycocaentry</option>,  <option value="classKSycocaFactoryList.html">ksycocafactorylist</option>,  <option value="classKTempDir.html">ktempdir</option>,  <option value="classKTempFile.html">ktempfile</option>,  <option value="classKTimezone.html">ktimezone</option>,  <option value="classKTimezoneDetails.html">ktimezonedetails</option>,  <option value="classKTimezones.html">ktimezones</option>,  <option value="classKTimezoneSource.html">ktimezonesource</option>,  <option value="classKUniqueApplication.html">kuniqueapplication</option>,  <option value="classKUnixSocketAddress.html">kunixsocketaddress</option>,  <option value="classKURL.html">kurl</option>,  <option value="classKURL_1_1List.html">kurl::list</option>,  <option value="classKURLDrag.html">kurldrag</option>,  <option value="classKUser.html">kuser</option>,  <option value="classKUserGroup.html">kusergroup</option>,  <option value="classKVMAllocator.html">kvmallocator</option>,  <option value="classKWin.html">kwin</option>,  <option value="classKWin_1_1WindowInfo.html">kwin::windowinfo</option>,  <option value="classKWinModule.html">kwinmodule</option>,  <option value="classKWordMacroExpander.html">kwordmacroexpander</option>,  <option value="classKXErrorHandler.html">kxerrorhandler</option>,  <option value="classKZoneAllocator.html">kzoneallocator</option>,  <option value="classNET.html">net</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../arts/html/index.html">arts</a></li><li><a href="../../dcop/html/index.html">dcop</a></li><li><a href="../../dnssd/html/index.html">dnssd</a></li><li><a href="../../interfaces/html/index.html">interfaces</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../interfaces/kimproxy/library/html/index.html">library</a></li><li>&nbsp;&nbsp;<a href="../../interfaces/kspeech/html/index.html">kspeech</a></li><li>&nbsp;&nbsp;<a href="../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kate/html/index.html">kate</a></li><li><a href="../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../kdecore/html/index.html">kdecore</a></li><li><a href="../../kded/html/index.html">kded</a></li><li><a href="../../kdefx/html/index.html">kdefx</a></li><li><a href="../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../kdesu/html/index.html">kdesu</a></li><li><a href="../../kdeui/html/index.html">kdeui</a></li><li><a href="../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../khtml/html/index.html">khtml</a></li><li><a href="../../kimgio/html/index.html">kimgio</a></li><li><a href="../../kinit/html/index.html">kinit</a></li><li><a href="../../kio/html/index.html">kio</a></li><li>&nbsp;&nbsp;<a href="../../kio/bookmarks/html/index.html">bookmarks</a></li><li>&nbsp;&nbsp;<a href="../../kio/httpfilter/html/index.html">httpfilter</a></li><li>&nbsp;&nbsp;<a href="../../kio/kfile/html/index.html">kfile</a></li><li>&nbsp;&nbsp;<a href="../../kio/kio/html/index.html">kio</a></li><li>&nbsp;&nbsp;<a href="../../kio/kioexec/html/index.html">kioexec</a></li><li>&nbsp;&nbsp;<a href="../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li>&nbsp;&nbsp;<a href="../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li>&nbsp;&nbsp;<a href="../../kioslave/http/html/index.html">http</a></li><li><a href="../../kjs/html/index.html">kjs</a></li><li><a href="../../kmdi/html/index.html">kmdi</a></li><li>&nbsp;&nbsp;<a href="../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../kparts/html/index.html">kparts</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../kspell2/html/index.html">kspell2</a></li><li><a href="../../kunittest/html/index.html">kunittest</a></li><li><a href="../../kutils/html/index.html">kutils</a></li><li><a href="../../kwallet/html/index.html">kwallet</a></li><li><a href="../../libkmid/html/index.html">libkmid</a></li><li><a href="../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>


        </td>
</tr>
</table>

<span class="doNotDisplay">
  <a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
  <a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
  <a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>


<div style="height: 8px"></div>

<div id="footer">
  <div id="footer_left">
    Maintained by <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;groo&#116;&#64;kde&#46;or&#x67;">Adriaan de Groot</a>
and
<a href="&#109;a&#105;&#108;&#116;&#111;&#58;w&#105;nter&#64;kde&#46;or&#x67">Allen Winter</a>.
<br/>
    KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
    <a href="http://www.kde.org/contact/impressum.php">Legal</a>
  </div>
  <div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>

<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->

</body>
</html>