<?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" xml:lang="en">
<head>
<title>KUrl</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<link rel="stylesheet" type="text/css" href="../common/doxygen.css" />
<link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../common/kde.css" />
</head>
<body>
<div id="container">
<div id="header">
<div id="header_top">
<div>
<div>
<img alt ="" src="../common/top-kde.jpg"/>
KDE 4.4 PyKDE API Reference
</div>
</div>
</div>
<div id="header_bottom">
<div id="location">
<ul>
<li>KDE's Python API</li>
</ul>
</div>
<div id="menu">
<ul>
<li><a href="../modules.html">Overview</a></li>
<li><a href="http://techbase.kde.org/Development/Languages/Python">PyKDE Home</a></li>
<li><a href="http://kde.org/family/">Sitemap</a></li>
<li><a href="http://kde.org/contact/">Contact Us</a></li>
</ul>
</div>
</div>
</div>
<div id="body_wrapper">
<div id="body">
<div id="right">
<div class="content">
<div id="main">
<div class="clearer"> </div>
<h1>KUrl Class Reference</h1>
<code>from PyKDE4.kdecore import *</code>
<p>
Inherits: <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qurl.html">QUrl</a><br />
<h2>Detailed Description</h2>
<p>\class KUrl kurl.h <KUrl>
</p>
<p>
Represents and parses a URL.
</p>
<p>
A prototypical URL looks like:
<pre class="fragment">
protocol://user:password\@hostname:port/path/to/file.ext#reference
</pre>
</p>
<p>
KUrl handles escaping of URLs. This means that the specification
of a full URL will differ from the corresponding string that would specify a
local file or directory in file-operations like fopen. This is because an URL
doesn't allow certain characters and escapes them. (e.g. '#'->"%23", space->"%20")
(In a URL the hash-character '#' is used to specify a "reference", i.e. the position
within a document).
</p>
<p>
The constructor KUrl(const QString&) expects a string properly escaped,
or at least non-ambiguous.
If you have the absolute path you should use KUrl.fromPath(const QString&).
<pre class="fragment">
KUrl kurl = KUrl.fromPath("/bar/#foo#");
QString url = kurl.url(); // -> "file:bar/%23foo%23"
</pre>
</p>
<p>
If you have the URL of a local file or directory and need the absolute path,
you would use toLocalFile().
<pre class="fragment">
KUrl url( "file:bar/%23foo%23" );
...
if ( url.isLocalFile() )
QString path = url.toLocalFile(); // -> "/bar/#foo#"
</pre>
</p>
<p>
This must also be considered when you have separated directory and file
strings and need to put them together.
While you can simply concatenate normal path strings, you must take care if
the directory-part is already an escaped URL.
(This might be needed if the user specifies a relative path, and your
program supplies the rest from elsewhere.)
</p>
<p>
Wrong:
<pre class="fragment">
QString dirUrl = "file:bar/";
QString fileName = "#foo#";
QString invalidURL = dirUrl + fileName; // -> "file:bar/#foo#" won't behave like you would expect.
</pre>
Instead you should use addPath():
Right:
<pre class="fragment">
KUrl url( "file:bar/" );
QString fileName = "#foo#";
url.addPath( fileName );
QString validURL = url.url(); // -> "file:bar/%23foo%23"
</pre>
</p>
<p>
Also consider that some URLs contain the password, but this shouldn't be
visible. Your program should use prettyUrl() every time it displays a
URL, whether in the GUI or in debug output or...
</p>
<p>
<pre class="fragment">
KUrl url( "ftp://name:password@ftp.faraway.org/bar/%23foo%23");
QString visibleURL = url.prettyUrl(); // -> "ftp://name@ftp.faraway.org/bar/%23foo%23"
</pre>
Note that prettyUrl() doesn't change the character escapes (like "%23").
Otherwise the URL would be invalid and the user wouldn't be able to use it in another
context.
</p>
<table border="0" cellpadding="0" cellspacing="0"><tr><td colspan="2"><br><h2>Enumerations</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#AdjustPathOption">AdjustPathOption</a> </td><td class="memItemRight" valign="bottom">{ RemoveTrailingSlash, LeaveTrailingSlash, AddTrailingSlash }</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#CleanPathOption">CleanPathOption</a> </td><td class="memItemRight" valign="bottom">{ SimplifyDirSeparators, KeepDirSeparators }</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#DirectoryOption">DirectoryOption</a> </td><td class="memItemRight" valign="bottom">{ ObeyTrailingSlash, AppendTrailingSlash, IgnoreTrailingSlash }</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#EncodedPathAndQueryOption">EncodedPathAndQueryOption</a> </td><td class="memItemRight" valign="bottom">{ PermitEmptyPath, AvoidEmptyPath }</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#EqualsOption">EqualsOption</a> </td><td class="memItemRight" valign="bottom">{ CompareWithoutTrailingSlash, CompareWithoutFragment }</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#MimeDataFlags">MimeDataFlags</a> </td><td class="memItemRight" valign="bottom">{ DefaultMimeDataFlags, NoTextExport }</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#QueryItemsOption">QueryItemsOption</a> </td><td class="memItemRight" valign="bottom">{ CaseInsensitiveKeys }</td></tr>
<tr><td colspan="2"><br><h2>Methods</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KUrl">__init__</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KUrl">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> urlOrPath)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KUrl">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> urlOrPath)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KUrl">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qbytearray.html">QByteArray</a> urlOrPath)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KUrl">__init__</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> u)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KUrl">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qurl.html">QUrl</a> u)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KUrl">__init__</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> _baseurl, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _rel_url)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#addPath">addPath</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> txt)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#addQueryItem">addQueryItem</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _item, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _value)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#adjustPath">adjustPath</a> (self, <a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> trailing)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#cd">cd</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _dir)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#cleanPath">cleanPath</a> (self, <a href="../kdecore/KUrl.html#CleanPathOption">KUrl.CleanPathOption</a> options=KUrl.SimplifyDirSeparators)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#cmp">cmp</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> u, bool ignore_trailing=0)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#decode_string">decode_string</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> str)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#directory">directory</a> (self, <a href="../kdecore/KUrl.DirectoryOptions.html">KUrl.DirectoryOptions</a> options=KUrl.IgnoreTrailingSlash)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#encode_string">encode_string</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> str)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#encode_string_no_slash">encode_string_no_slash</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> str)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#encodedHtmlRef">encodedHtmlRef</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#encodedPathAndQuery">encodedPathAndQuery</a> (self, <a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> trailing=KUrl.LeaveTrailingSlash, <a href="../kdecore/KUrl.EncodedPathAndQueryOptions.html">KUrl.EncodedPathAndQueryOptions</a> options=KUrl.PermitEmptyPath)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#equals">equals</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> u, <a href="../kdecore/KUrl.EqualsOptions.html">KUrl.EqualsOptions</a> options=0)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#fileEncoding">fileEncoding</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#fileName">fileName</a> (self, <a href="../kdecore/KUrl.DirectoryOptions.html">KUrl.DirectoryOptions</a> options=KUrl.IgnoreTrailingSlash)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KUrl.html">KUrl</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#fromMimeDataByteArray">fromMimeDataByteArray</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qbytearray.html">QByteArray</a> str)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KUrl.html">KUrl</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#fromPath">fromPath</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> text)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KUrl.html">KUrl</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#fromPathOrUrl">fromPathOrUrl</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> text)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#hasHTMLRef">hasHTMLRef</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#hasHost">hasHost</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#hasPass">hasPass</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#hasPath">hasPath</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#hasRef">hasRef</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#hasSubUrl">hasSubUrl</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#hasUser">hasUser</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#htmlRef">htmlRef</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isLocalFile">isLocalFile</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isParentOf">isParentOf</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> u)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isRelativeUrl">isRelativeUrl</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _url)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KUrl.html">KUrl</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#join">join</a> (self, <a href="../kdecore/KUrl.List.html">KUrl.List</a> _list)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#operator !=">operator !=</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> _u)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#operator !=">operator !=</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _u)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#operator ==">operator ==</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> _u)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#operator ==">operator ==</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _u)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#pass">pass_</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#path">path</a> (self, <a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> trailing=KUrl.LeaveTrailingSlash)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#pathOrUrl">pathOrUrl</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#pathOrUrl">pathOrUrl</a> (self, <a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> trailing)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#populateMimeData">populateMimeData</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qmimedata.html">QMimeData</a> mimeData, <a href="../kdecore/KUrl.MetaDataMap.html">KUrl.MetaDataMap</a> metaData=KUrl.MetaDataMap(), <a href="../kdecore/KUrl.html#MimeDataFlags">KUrl.MimeDataFlags</a> flags=KUrl.DefaultMimeDataFlags)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#prettyUrl">prettyUrl</a> (self, <a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> trailing=KUrl.LeaveTrailingSlash)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#protocol">protocol</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#query">query</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#queryItem">queryItem</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> item)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">QMap<QString,QString> </td><td class="memItemRight" valign="bottom"><a class="el" href="#queryItems">queryItems</a> (self, <a href="../kdecore/KUrl.QueryItemsOptions.html">KUrl.QueryItemsOptions</a> options=0)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#ref">ref</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a>, bool isParent </td><td class="memItemRight" valign="bottom"><a class="el" href="#relativePath">relativePath</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> base_dir, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> path)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#relativeUrl">relativeUrl</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> base_url, <a href="../kdecore/KUrl.html">KUrl</a> url)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setDirectory">setDirectory</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> dir)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setEncodedPathAndQuery">setEncodedPathAndQuery</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _txt)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setFileEncoding">setFileEncoding</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> encoding)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setFileName">setFileName</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _txt)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setHTMLRef">setHTMLRef</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _ref)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setPass">setPass</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> pass)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setPath">setPath</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> path)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setProtocol">setProtocol</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> proto)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setQuery">setQuery</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> query)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setRef">setRef</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> fragment)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setUser">setUser</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> user)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KUrl.List.html">KUrl.List</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#split">split</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> _url)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KUrl.List.html">KUrl.List</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#split">split</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> _url)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#toLocalFile">toLocalFile</a> (self, <a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> trailing=KUrl.LeaveTrailingSlash)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#toMimeDataString">toMimeDataString</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KUrl.html">KUrl</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#upUrl">upUrl</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#url">url</a> (self, <a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> trailing=KUrl.LeaveTrailingSlash)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#user">user</a> (self)</td></tr>
</table>
<hr><h2>Method Documentation</h2><a class="anchor" name="KUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Constructs an empty URL.
</p></div></div><a class="anchor" name="KUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>urlOrPath</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Constructor taking a QByteArray <b>urlOrPath,</b> which is an _encoded_ representation
of the URL, exactly like the usual constructor. This is useful when
the URL, in its encoded form, is strictly ascii.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>urlOrPath</em> </td><td> An encoded URL, or a path.
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="KUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>urlOrPath</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Constructor taking a QByteArray <b>urlOrPath,</b> which is an _encoded_ representation
of the URL, exactly like the usual constructor. This is useful when
the URL, in its encoded form, is strictly ascii.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>urlOrPath</em> </td><td> An encoded URL, or a path.
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="KUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qbytearray.html">QByteArray</a> </td>
<td class="paramname"><em>urlOrPath</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Constructor taking a QByteArray <b>urlOrPath,</b> which is an _encoded_ representation
of the URL, exactly like the usual constructor. This is useful when
the URL, in its encoded form, is strictly ascii.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>urlOrPath</em> </td><td> An encoded URL, or a path.
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="KUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td>
<td class="paramname"><em>u</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Converts from a QUrl.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>u</em> </td><td> the QUrl
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="KUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qurl.html">QUrl</a> </td>
<td class="paramname"><em>u</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Converts from a QUrl.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>u</em> </td><td> the QUrl
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="KUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td>
<td class="paramname"><em>_baseurl</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_rel_url</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Constructor allowing relative URLs.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>_baseurl</em> </td><td> The base url.
<tr><td></td><td valign="top"><em>_rel_url</em> </td><td> A relative or absolute URL.
If this is an absolute URL then <b>_baseurl</b> will be ignored.
If this is a relative URL it will be combined with <b>_baseurl.</b>
Note that _rel_url should be encoded too, in any case.
So do NOT pass a path here (use setPath or addPath instead).
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="addPath"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> addPath</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>txt</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Adds to the current path.
Assumes that the current path is a directory. <b>txt</b> is appended to the
current path. The function adds '/' if needed while concatenating.
This means it does not matter whether the current path has a trailing
'/' or not. If there is none, it becomes appended. If <b>txt</b>
has a leading '/' then this one is stripped.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>txt</em> </td><td> The text to add. It is considered to be decoded.
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="addQueryItem"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> addQueryItem</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_item</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_value</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Add an additional query item.
To replace an existing query item, the item should first be
removed with removeQueryItem()
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>_item</em> </td><td> Name of item to add
<tr><td></td><td valign="top"><em>_value</em> </td><td> Value of item to add
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="adjustPath"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> adjustPath</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> </td>
<td class="paramname"><em>trailing</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Add or remove a trailing slash to/from the path.
</p>
<p>
If the URL has no path, then no '/' is added
anyway. And on the other side: If the path is "/", then this
character won't be stripped. Reason: "ftp://weis\@host" means something
completely different than "ftp://weis\@host/". So adding or stripping
the '/' would really alter the URL, while "ftp://host/path" and
"ftp://host/path/" mean the same directory.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>trailing</em> </td><td> RemoveTrailingSlash strips any trailing '/' and
AddTrailingSlash adds a trailing '/' if there is none yet
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="cd"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool cd</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_dir</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Changes the directory by descending into the given directory.
It is assumed the current URL represents a directory.
If <b>dir</b> starts with a "/" the
current URL will be "protocol://host/dir" otherwise <b>_dir</b> will
be appended to the path. <b>_dir</b> can be ".."
This function won't strip protocols. That means that when you are in
file:dir/dir2/my.tgz#tar:/ and you do cd("..") you will
still be in file:dir/dir2/my.tgz#tar:/
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>_dir</em> </td><td> the directory to change to
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if successful
</dd></dl>
</p></div></div><a class="anchor" name="cleanPath"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> cleanPath</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html#CleanPathOption">KUrl.CleanPathOption</a> </td>
<td class="paramname"><em>options=KUrl.SimplifyDirSeparators</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Resolves "." and ".." components in path.
Some servers seem not to like the removal of extra '/'
even though it is against the specification in RFC 2396.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>options</em> </td><td> use KeepDirSeparators if you don't want to remove consecutive
occurrences of directory separator
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="cmp"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool cmp</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td>
<td class="paramname"><em>u</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>ignore_trailing=0</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>The same as equals(), just with a less obvious name.
Compares this url with <b>u.</b>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>u</em> </td><td> the URL to compare this one with.
<tr><td></td><td valign="top"><em>ignore_trailing</em> </td><td> set to true to ignore trailing '/' characters.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> True if both urls are the same. If at least one of the urls is invalid,
false is returned.
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> operator==. This function should be used if you want to
ignore trailing '/' characters.
</dd></dl> <dl class="deprecated" compact><dt><b>Deprecated:</b></dt><dd> Use equals() instead.
</dd></dl>
</p></div></div><a class="anchor" name="decode_string"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> decode_string</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>str</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Decode %-style encoding and convert from local encoding to unicode.
Reverse of encode_string()
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>str</em> </td><td> String to decode (can be QString()).
</td></tr>
</table></dl>
<p> <dl class="deprecated" compact><dt><b>Deprecated:</b></dt><dd> use QUrl.fromPercentEncoding(encodedURL) instead, but
note that it takes a QByteArray and not a QString. Which makes sense since
everything is 7 bit (ascii) when being percent-encoded.
</dd></dl>
</p></div></div><a class="anchor" name="directory"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> directory</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.DirectoryOptions.html">KUrl.DirectoryOptions</a> </td>
<td class="paramname"><em>options=KUrl.IgnoreTrailingSlash</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the directory of the path.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>options</em> </td><td> a set of DirectoryOption flags
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The directory part of the current path. Everything between the last and the second last '/'
is returned. For example <tt>file:hallo/torben/</tt> would return "/hallo/torben/" while
<tt>file:hallo/torben</tt> would return "hallo/". The returned string is decoded.
QString() is returned when there is no path.
</dd></dl>
</p></div></div><a class="anchor" name="encode_string"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> encode_string</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>str</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Convert unicoded string to local encoding and use %-style
encoding for all common delimiters / non-ascii characters.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>str</em> </td><td> String to encode (can be QString()).
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the encoded string
</dd></dl> </p>
<p>
<dl class="deprecated" compact><dt><b>Deprecated:</b></dt><dd> use QUrl.toPercentEncoding instead, but note that it
returns a QByteArray and not a QString. Which makes sense since
everything is 7 bit (ascii) after being percent-encoded.
</dd></dl>
</p></div></div><a class="anchor" name="encode_string_no_slash"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> encode_string_no_slash</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>str</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Convert unicoded string to local encoding and use %-style
encoding for all common delimiters / non-ascii characters
as well as the slash '/'.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>str</em> </td><td> String to encode
</td></tr>
</table></dl>
<p> <dl class="deprecated" compact><dt><b>Deprecated:</b></dt><dd> use QUrl.toPercentEncoding(str,"/") instead, but note that it
returns a QByteArray and not a QString. Which makes sense since
everything is 7 bit (ascii) after being percent-encoded.
</dd></dl>
</p></div></div><a class="anchor" name="encodedHtmlRef"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> encodedHtmlRef</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the HTML reference (the part of the URL after "#") in
encoded form.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> The HTML-style reference in its original form.
</dd></dl>
</p></div></div><a class="anchor" name="encodedPathAndQuery"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> encodedPathAndQuery</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> </td>
<td class="paramname"><em>trailing=KUrl.LeaveTrailingSlash</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.EncodedPathAndQueryOptions.html">KUrl.EncodedPathAndQueryOptions</a> </td>
<td class="paramname"><em>options=KUrl.PermitEmptyPath</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the encoded path and the query.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>trailing</em> </td><td> add or remove a trailing '/', see adjustPath
<tr><td></td><td valign="top"><em>options</em> </td><td> a set of flags from EncodedPathAndQueryOption
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The concatenation of the encoded path , '?' and the encoded query.
</dd></dl>
</p></div></div><a class="anchor" name="equals"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool equals</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td>
<td class="paramname"><em>u</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.EqualsOptions.html">KUrl.EqualsOptions</a> </td>
<td class="paramname"><em>options=0</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Compares this url with <b>u.</b>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>u</em> </td><td> the URL to compare this one with.
<tr><td></td><td valign="top"><em>options</em> </td><td> a set of EqualsOption flags
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> True if both urls are the same. If at least one of the urls is invalid,
false is returned.
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> operator==. This function should be used if you want to
ignore trailing '/' characters.
</dd></dl>
</p></div></div><a class="anchor" name="fileEncoding"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> fileEncoding</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns encoding information from url, the content of the "charset"
parameter.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> An encoding suitable for QTextCodec.codecForName()
or QString() if not encoding was specified.
</dd></dl>
</p></div></div><a class="anchor" name="fileName"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> fileName</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.DirectoryOptions.html">KUrl.DirectoryOptions</a> </td>
<td class="paramname"><em>options=KUrl.IgnoreTrailingSlash</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the filename of the path.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>options</em> </td><td> a set of DirectoryOption flags. (StripTrailingSlashFromResult has no effect)
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The filename of the current path. The returned string is decoded. Null
if there is no file (and thus no path).
</dd></dl>
</p></div></div><a class="anchor" name="fromMimeDataByteArray"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KUrl.html">KUrl</a> fromMimeDataByteArray</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qbytearray.html">QByteArray</a> </td>
<td class="paramname"><em>str</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Creates a KUrl from a string, using the standard conventions for mime data
(drag-n-drop or copy-n-paste).
Internally used by KUrl.List.fromMimeData, which is probably what you want to use instead.
</p></div></div><a class="anchor" name="fromPath"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KUrl.html">KUrl</a> fromPath</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>text</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Creates a KUrl object from a QString representing an absolute path.
KUrl url( somePath ) does the same, but this method is more explicit
and avoids the path-or-url detection in the KUrl constructor.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>text</em> </td><td> the path
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the new KUrl
</dd></dl>
</p></div></div><a class="anchor" name="fromPathOrUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KUrl.html">KUrl</a> fromPathOrUrl</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>text</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p><dl class="deprecated" compact><dt><b>Deprecated:</b></dt><dd>
Since KDE4 you can pass both urls and paths to the KUrl constructors.
Use KUrl(text) instead.
</dd></dl>
</p></div></div><a class="anchor" name="hasHTMLRef"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool hasHTMLRef</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Checks whether there is a HTML reference.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the URL has an HTML-style reference.
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> htmlRef()
</dd></dl>
</p></div></div><a class="anchor" name="hasHost"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool hasHost</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Test to see if this URL has a hostname included in it.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the URL has a host
</dd></dl>
</p></div></div><a class="anchor" name="hasPass"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool hasPass</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Test to see if this URL has a password included in it.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if there is a non-empty password set
</dd></dl>
</p></div></div><a class="anchor" name="hasPath"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool hasPath</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Test to see if this URL has a path is included in it.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if there is a path
</dd></dl>
</p></div></div><a class="anchor" name="hasRef"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool hasRef</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Checks whether the URL has a reference part.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the URL has a reference part. In a URL like
http://www.kde.org/kdebase.tar#tar:/README it would
return true, too.
</dd></dl>
</p></div></div><a class="anchor" name="hasSubUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool hasSubUrl</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Checks whether the URL has any sub URLs. See split()
for examples for sub URLs.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the file has at least one sub URL.
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> split
</dd></dl>
</p></div></div><a class="anchor" name="hasUser"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool hasUser</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Test to see if this URL has a user name included in it.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the URL has an non-empty user name
</dd></dl>
</p></div></div><a class="anchor" name="htmlRef"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> htmlRef</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the HTML reference (the part of the URL after "#").
<dl class="return" compact><dt><b>Returns:</b></dt><dd> The HTML-style reference.
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> split
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> hasSubUrl
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> encodedHtmlRef
</dd></dl>
</p></div></div><a class="anchor" name="isLocalFile"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isLocalFile</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Checks whether the file is local.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the file is a plain local file and has no filter protocols
attached to it.
</dd></dl>
</p></div></div><a class="anchor" name="isParentOf"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isParentOf</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td>
<td class="paramname"><em>u</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Checks whether the given URL is parent of this URL.
For instance, ftp://host/dir/ is a parent of ftp://host/dir/subdir/subsubdir/.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if this url is a parent of <b>u</b> (or the same URL as <b>u)</b>
</dd></dl>
</p></div></div><a class="anchor" name="isRelativeUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isRelativeUrl</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_url</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Convenience function.
</p>
<p>
Returns whether '_url' is likely to be a "relative" URL instead of
an "absolute" URL.
</p>
<p>
This is mostly meant for KUrl(url, relativeUrl).
</p>
<p>
If you are looking for the notion of "relative path" (foo) vs "absolute path" (/foo),
use QUrl.isRelative() instead.
Indeed, isRelativeUrl() returns true for the string "/foo" since it doesn't contain a protocol,
while KUrl("/foo").isRelative() is false since the KUrl constructor turns it into file:foo.
The two methods basically test the same thing, but this one takes a string (which is faster)
while the class method requires a QUrl/KUrl which gives a more expected result, given
the "magic" in the KUrl constructor.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>_url</em> </td><td> URL to examine
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true when the URL is likely to be "relative", false otherwise.
</dd></dl>
</p></div></div><a class="anchor" name="join"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KUrl.html">KUrl</a> join</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.List.html">KUrl.List</a> </td>
<td class="paramname"><em>_list</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Reverses split(). Only the first URL may have a reference. This reference
is considered to be HTML-like and is appended at the end of the resulting
joined URL.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>_list</em> </td><td> the list to join
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the joined URL
</dd></dl>
</p></div></div><a class="anchor" name="operator !="></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool operator !=</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td>
<td class="paramname"><em>_u</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="operator !="></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool operator !=</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_u</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="operator =="></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool operator ==</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td>
<td class="paramname"><em>_u</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="operator =="></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool operator ==</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_u</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="pass"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> pass_</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the decoded password (corresponding to user()) included in the URL.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the password or QString() if it does not exist
</dd></dl>
</p></div></div><a class="anchor" name="path"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> path</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> </td>
<td class="paramname"><em>trailing=KUrl.LeaveTrailingSlash</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p></p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>trailing</em> </td><td> use to add or remove a trailing slash to/from the path. see adjustPath
</td></tr>
</table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The current decoded path. This does not include the query. Can
be QString() if no path is set.
</dd></dl>
</p></div></div><a class="anchor" name="pathOrUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> pathOrUrl</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Overload with <b>trailing</b> parameter
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>trailing</em> </td><td> use to add or remove a trailing slash to/from the path. see adjustPath.
</td></tr> </table></dl>
<p> <dl class="since" compact><dt><b>Since:</b></dt><dd> 4.2
</dd></dl>
</p></div></div><a class="anchor" name="pathOrUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> pathOrUrl</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> </td>
<td class="paramname"><em>trailing</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Overload with <b>trailing</b> parameter
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>trailing</em> </td><td> use to add or remove a trailing slash to/from the path. see adjustPath.
</td></tr> </table></dl>
<p> <dl class="since" compact><dt><b>Since:</b></dt><dd> 4.2
</dd></dl>
</p></div></div><a class="anchor" name="populateMimeData"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> populateMimeData</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qmimedata.html">QMimeData</a> </td>
<td class="paramname"><em>mimeData</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.MetaDataMap.html">KUrl.MetaDataMap</a> </td>
<td class="paramname"><em>metaData=KUrl.MetaDataMap()</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html#MimeDataFlags">KUrl.MimeDataFlags</a> </td>
<td class="paramname"><em>flags=KUrl.DefaultMimeDataFlags</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Adds URL data into the given QMimeData.
</p>
<p>
By default, populateMimeData also exports the URL as plain text, for e.g. dropping
onto a text editor.
But in some cases this might not be wanted, e.g. if adding other mime data
which provides better plain text data.
</p>
<p>
WARNING: do not call this method multiple times, use KUrl.List.populateMimeData instead.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>mimeData</em> </td><td> the QMimeData instance used to drag or copy this URL
<tr><td></td><td valign="top"><em>metaData</em> </td><td> KIO metadata shipped in the mime data, which is used for instance to
set a correct HTTP referrer (some websites require it for downloading e.g. an image)
<tr><td></td><td valign="top"><em>flags</em> </td><td> set NoTextExport to prevent setting plain/text data into <b>mimeData</b>
In such a case, setExportAsText( false ) should be called.
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="prettyUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> prettyUrl</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> </td>
<td class="paramname"><em>trailing=KUrl.LeaveTrailingSlash</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the URL as string in human-friendly format.
Example:
<pre class="fragment">
http://localhost:8080/test.cgi?test=hello world&name=fred
</pre>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>trailing</em> </td><td> use to add or remove a trailing slash to/from the path. see adjustPath.
</td></tr>
</table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> A human readable URL, with no non-necessary encodings/escaped
characters. Password will not be shown.
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> url()
</dd></dl>
</p></div></div><a class="anchor" name="protocol"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> protocol</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the protocol for the URL (i.e., file, http, etc.), lowercased.
<dl class="see" compact><dt><b>See also:</b></dt><dd> QUrl.scheme
</dd></dl>
</p></div></div><a class="anchor" name="query"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> query</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the query of the URL.
The query may contain the 0 character.
If a query is present it always starts with a '?'.
A single '?' means an empty query.
An empty string means no query.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> The encoded query, or QString() if there is none.
</dd></dl>
</p></div></div><a class="anchor" name="queryItem"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> queryItem</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>item</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the value of a certain query item.
</p>
<p>
This does the same as QUrl.queryItemValue(), except that it
decodes "+" into " " in the value.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>item</em> </td><td> Item whose value we want
</td></tr>
</table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the value of the given query item name or QString() if the
specified item does not exist.
</dd></dl>
</p></div></div><a class="anchor" name="queryItems"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">QMap<QString,QString> queryItems</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.QueryItemsOptions.html">KUrl.QueryItemsOptions</a> </td>
<td class="paramname"><em>options=0</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the list of query items as a map mapping keys to values.
</p>
<p>
This does the same as QUrl.queryItems(), except that it
decodes "+" into " " in the value, supports CaseInsensitiveKeys,
and returns a different data type.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>options</em> </td><td> any of QueryItemsOption <em>or</em>ed together.
</td></tr>
</table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the map of query items or the empty map if the url has no
query items.
</dd></dl>
</p></div></div><a class="anchor" name="ref"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> ref</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>The reference is <b>never</b> decoded automatically.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the undecoded reference, or QString() if there is none
</dd></dl>
</p></div></div><a class="anchor" name="relativePath"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a>, bool isParent relativePath</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>base_dir</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>path</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Convenience function
</p>
<p>
Returns a relative path based on <b>base_dir</b> that points to <b>path.</b>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>base_dir</em> </td><td> the base directory to derive from
<tr><td></td><td valign="top"><em>path</em> </td><td> the new target directory
<tr><td></td><td valign="top"><em>isParent</em> </td><td> A pointer to a boolean which, if provided, will be set to reflect
whether <b>path</b> has <b>base_dir</b> is a parent dir.
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="relativeUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> relativeUrl</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td>
<td class="paramname"><em>base_url</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td>
<td class="paramname"><em>url</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Convenience function
</p>
<p>
Returns a "relative URL" based on <b>base_url</b> that points to <b>url.</b>
</p>
<p>
If no "relative URL" can be created, e.g. because the protocol
and/or hostname differ between <b>base_url</b> and <b>url</b> an absolute
URL is returned.
Note that if <b>base_url</b> represents a directory, it should contain
a trailing slash.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>base_url</em> </td><td> the URL to derive from
<tr><td></td><td valign="top"><em>url</em> </td><td> new URL
</td></tr> </table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> adjustPath()
</dd></dl>
</p></div></div><a class="anchor" name="setDirectory"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setDirectory</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>dir</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Set the directory to <b>dir,</b> leaving the filename empty.
</p></div></div><a class="anchor" name="setEncodedPathAndQuery"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setEncodedPathAndQuery</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_txt</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>This is useful for HTTP. It looks first for '?' and decodes then.
The encoded path is the concatenation of the current path and the query.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>_txt</em> </td><td> the new path and query.
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="setFileEncoding"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setFileEncoding</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>encoding</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Adds encoding information to url by adding a "charset" parameter. If there
is already a charset parameter, it will be replaced.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>encoding</em> </td><td> the encoding to add or QString() to remove the
encoding.
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="setFileName"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setFileName</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_txt</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the filename of the path.
In comparison to addPath() this function does not assume that the current
path is a directory. This is only assumed if the current path ends with '/'.
</p>
<p>
Any reference is reset.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>_txt</em> </td><td> The filename to be set. It is considered to be decoded. If the
current path ends with '/' then <b>_txt</b> int just appended, otherwise
all text behind the last '/' in the current path is erased and
<b>_txt</b> is appended then. It does not matter whether <b>_txt</b> starts
with '/' or not.
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="setHTMLRef"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setHTMLRef</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_ref</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the HTML-style reference.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>_ref</em> </td><td> The new reference. This is considered to be <b>not</b> encoded in
contrast to setRef(). Use QString() to remove it.
</td></tr> </table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> htmlRef()
</dd></dl>
</p></div></div><a class="anchor" name="setPass"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setPass</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>pass</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the password (corresponding to user()) included in the URL.
</p>
<p>
Special characters in the password will appear encoded in the URL.
Note that a password can only appear in a URL string if you also set
a user.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>pass</em> </td><td> the password to set or QString() to remove the password
</td></tr> </table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> setUser
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> hasUser
</dd></dl>
</p></div></div><a class="anchor" name="setPath"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setPath</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>path</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="setProtocol"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setProtocol</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>proto</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the protocol for the URL (i.e., file, http, etc.)
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>proto</em> </td><td> the new protocol of the URL (without colon)
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="setQuery"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setQuery</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>query</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p></p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>query</em> </td><td> This is considered to be encoded. This has a good reason:
The query may contain the 0 character.
</td></tr>
</table></dl>
<p> The query should start with a '?'. If it doesn't '?' is prepended.
</p></div></div><a class="anchor" name="setRef"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setRef</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>fragment</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the reference part (everything after '#').
If you have an encoded fragment already (as a QByteArray), you can call setFragment directly.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>fragment</em> </td><td> the encoded reference (or QString() to remove it).
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="setUser"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setUser</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>user</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the user name (login, user id, ...) included in the URL.
</p>
<p>
Special characters in the user name will appear encoded in the URL.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>user</em> </td><td> the name of the user or QString() to remove the user
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="split"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KUrl.List.html">KUrl.List</a> split</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>_url</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Splits nested URLs like file:home/weis/kde.tgz#gzip:/#tar:/kdebase
A URL like http://www.kde.org#tar:/kde/README.hml#ref1 will be split in
http://www.kde.org and tar:/kde/README.html#ref1.
That means in turn that "#ref1" is an HTML-style reference and not a new sub URL.
Since HTML-style references mark
a certain position in a document this reference is appended to every URL.
The idea behind this is that browsers, for example, only look at the first URL while
the rest is not of interest to them.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> An empty list on error or the list of split URLs.
</dd></dl> </p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>_url</em> </td><td> The URL that has to be split.
</td></tr> </table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> hasSubUrl
</dd></dl>
</p></div></div><a class="anchor" name="split"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KUrl.List.html">KUrl.List</a> split</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td>
<td class="paramname"><em>_url</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Splits nested URLs like file:home/weis/kde.tgz#gzip:/#tar:/kdebase
A URL like http://www.kde.org#tar:/kde/README.hml#ref1 will be split in
http://www.kde.org and tar:/kde/README.html#ref1.
That means in turn that "#ref1" is an HTML-style reference and not a new sub URL.
Since HTML-style references mark
a certain position in a document this reference is appended to every URL.
The idea behind this is that browsers, for example, only look at the first URL while
the rest is not of interest to them.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> An empty list on error or the list of split URLs.
</dd></dl> </p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>_url</em> </td><td> The URL that has to be split.
</td></tr> </table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> hasSubUrl
</dd></dl>
</p></div></div><a class="anchor" name="toLocalFile"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> toLocalFile</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> </td>
<td class="paramname"><em>trailing=KUrl.LeaveTrailingSlash</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p></p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>trailing</em> </td><td> use to add or remove a trailing slash to/from the local path. see adjustPath
</td></tr>
</table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The current local path. Can
be QString() if no path is set.
</dd></dl>
</p></div></div><a class="anchor" name="toMimeDataString"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> toMimeDataString</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the URL as a string, using the standard conventions for mime data
(drag-n-drop or copy-n-paste).
Internally used by KUrl.List.fromMimeData, which is probably what you want to use instead.
</p></div></div><a class="anchor" name="upUrl"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KUrl.html">KUrl</a> upUrl</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>This function is useful to implement the "Up" button in a file manager for example.
cd() never strips a sub-protocol. That means that if you are in
file:home/x.tgz#gzip:/#tar:/ and hit the up button you expect to see
file:home. The algorithm tries to go up on the right-most URL. If that is not
possible it strips the right most URL. It continues stripping URLs.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> a URL that is a level higher
</dd></dl>
</p></div></div><a class="anchor" name="url"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> url</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KUrl.html#AdjustPathOption">KUrl.AdjustPathOption</a> </td>
<td class="paramname"><em>trailing=KUrl.LeaveTrailingSlash</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the URL as string, with all escape sequences intact,
encoded in a given charset.
This is used in particular for encoding URLs in UTF-8 before using them
in a drag and drop operation.
Please note that the string returned by url() will include
the password of the URL. If you want to show the URL to the
user, use prettyUrl().
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>trailing</em> </td><td> use to add or remove a trailing slash to/from the path. See adjustPath
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The complete URL, with all escape sequences intact, encoded
in a given charset.
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> prettyUrl()
</dd></dl>
</p></div></div><a class="anchor" name="user"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> user</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the decoded user name (login, user id, ...) included in the URL.
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the user name or QString() if there is no user name
</dd></dl>
</p></div></div><hr><h2>Enumeration Documentation</h2><a class="anchor" name="AdjustPathOption"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">AdjustPathOption</td>
</tr>
</table>
</div>
<div class="memdoc"><p>Options to be used in adjustPath
</p><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>RemoveTrailingSlash</em> </td><td><tr><td valign="top"><em>LeaveTrailingSlash</em> </td><td><tr><td valign="top"><em>AddTrailingSlash</em> </td><td></table>
</dl>
</div></div><p><a class="anchor" name="CleanPathOption"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">CleanPathOption</td>
</tr>
</table>
</div>
<div class="memdoc"><p>Options to be used in cleanPath
</p><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>SimplifyDirSeparators</em> = 0x00</td><td><tr><td valign="top"><em>KeepDirSeparators</em> = 0x01</td><td></table>
</dl>
</div></div><p><a class="anchor" name="DirectoryOption"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">DirectoryOption</td>
</tr>
</table>
</div>
<div class="memdoc"><p>option to be used in fileName and directory
</p><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>ObeyTrailingSlash</em> = 0x02</td><td><tr><td valign="top"><em>AppendTrailingSlash</em> = 0x04</td><td><tr><td valign="top"><em>IgnoreTrailingSlash</em> = 0x01</td><td></table>
</dl>
</div></div><p><a class="anchor" name="EncodedPathAndQueryOption"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">EncodedPathAndQueryOption</td>
</tr>
</table>
</div>
<div class="memdoc"><p>Option to be used in encodedPathAndQuery
</p><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>PermitEmptyPath</em> = 0x00</td><td><tr><td valign="top"><em>AvoidEmptyPath</em> = 0x01</td><td></table>
</dl>
</div></div><p><a class="anchor" name="EqualsOption"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">EqualsOption</td>
</tr>
</table>
</div>
<div class="memdoc"><p>flags to be used in url compartators function like equal, or urlcmp
</p><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>CompareWithoutTrailingSlash</em> = 0x01</td><td><tr><td valign="top"><em>CompareWithoutFragment</em> = 0x02</td><td></table>
</dl>
</div></div><p><a class="anchor" name="MimeDataFlags"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">MimeDataFlags</td>
</tr>
</table>
</div>
<div class="memdoc"><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>DefaultMimeDataFlags</em> = 0</td><td><tr><td valign="top"><em>NoTextExport</em> = 1</td><td></table>
</dl>
</div></div><p><a class="anchor" name="QueryItemsOption"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">QueryItemsOption</td>
</tr>
</table>
</div>
<div class="memdoc"><p>Options for queryItems. Currently, only one option is
defined:
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>CaseInsensitiveKeys</em> </td><td> normalize query keys to lowercase.
</td></tr>
</table></dl>
<p>
</p><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>CaseInsensitiveKeys</em> = 1</td><td></table>
</dl>
</div></div><p>
</div>
</div>
</div>
<div id="left">
<div class="menu_box">
<div class="nav_list">
<ul>
<li><a href="../allclasses.html">Full Index</a></li>
</ul>
</div>
<a name="cp-menu" /><div class="menutitle"><div>
<h2 id="cp-menu-project">Modules</h2>
</div></div>
<div class="nav_list">
<ul><li><a href="../akonadi/index.html">akonadi</a></li>
<li><a href="../dnssd/index.html">dnssd</a></li>
<li><a href="../kdecore/index.html">kdecore</a></li>
<li><a href="../kdeui/index.html">kdeui</a></li>
<li><a href="../khtml/index.html">khtml</a></li>
<li><a href="../kio/index.html">kio</a></li>
<li><a href="../knewstuff/index.html">knewstuff</a></li>
<li><a href="../kparts/index.html">kparts</a></li>
<li><a href="../kutils/index.html">kutils</a></li>
<li><a href="../nepomuk/index.html">nepomuk</a></li>
<li><a href="../phonon/index.html">phonon</a></li>
<li><a href="../plasma/index.html">plasma</a></li>
<li><a href="../polkitqt/index.html">polkitqt</a></li>
<li><a href="../solid/index.html">solid</a></li>
<li><a href="../soprano/index.html">soprano</a></li>
</ul></div></div>
</div>
</div>
<div class="clearer"/>
</div>
<div id="end_body"></div>
</div>
<div id="footer"><div id="footer_text">
This documentation is maintained by <a href="mailto:simon@simonzone.com">Simon Edwards</a>.<br />
KDE<sup>®</sup> and <a href="../images/kde_gear_black.png">the K Desktop Environment<sup>®</sup> logo</a> are registered trademarks of <a href="http://ev.kde.org/" 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>
</body>
</html>
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
b77dda48f87d4eda8cc559e40c49a652
>
files
>
348
