<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qurl.cpp -->
<title>Obsolete Members for QUrl | Qt Core 5.9</title>
<link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
<script type="text/javascript">
document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
// loading style sheet breaks anchors that were jumped to before
// so force jumping to anchor again
setTimeout(function() {
var anchor = location.hash;
// need to jump to different anchor first (e.g. none)
location.hash = "#";
setTimeout(function() {
location.hash = anchor;
}, 0);
}, 0);
</script>
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<table><tr>
<td >Qt 5.9</td><td ><a href="qtcore-index.html">Qt Core</a></td><td ><a href="qtcore-module.html">C++ Classes</a></td><td >QUrl</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right">Qt 5.9.4 Reference Documentation</td>
</tr></table>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar"><div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Obsolete Members for QUrl</h1>
<p><b>The following members of class <a href="qurl.html">QUrl</a> are obsolete.</b> They are provided to keep old source code working. We strongly advise against using them in new code.</p>
<h2>Public Functions</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#addEncodedQueryItem">addEncodedQueryItem</a></b>(const QByteArray &<i>key</i>, const QByteArray &<i>value</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#addQueryItem">addQueryItem</a></b>(const QString &<i>key</i>, const QString &<i>value</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QList<QByteArray> </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#allEncodedQueryItemValues">allEncodedQueryItemValues</a></b>(const QByteArray &<i>key</i>) const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QStringList </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#allQueryItemValues">allQueryItemValues</a></b>(const QString &<i>key</i>) const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#encodedFragment">encodedFragment</a></b>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#encodedHost">encodedHost</a></b>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#encodedPassword">encodedPassword</a></b>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#encodedPath">encodedPath</a></b>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#encodedQuery">encodedQuery</a></b>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#encodedQueryItemValue">encodedQueryItemValue</a></b>(const QByteArray &<i>key</i>) const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QList<QPair<QByteArray, QByteArray> > </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#encodedQueryItems">encodedQueryItems</a></b>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#encodedUserName">encodedUserName</a></b>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>bool </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#hasEncodedQueryItem">hasEncodedQueryItem</a></b>(const QByteArray &<i>key</i>) const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>bool </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#hasQueryItem">hasQueryItem</a></b>(const QString &<i>key</i>) const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QString </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#queryItemValue">queryItemValue</a></b>(const QString &<i>key</i>) const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QList<QPair<QString, QString> > </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#queryItems">queryItems</a></b>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#removeAllEncodedQueryItems">removeAllEncodedQueryItems</a></b>(const QByteArray &<i>key</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#removeAllQueryItems">removeAllQueryItems</a></b>(const QString &<i>key</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#removeEncodedQueryItem">removeEncodedQueryItem</a></b>(const QByteArray &<i>key</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#removeQueryItem">removeQueryItem</a></b>(const QString &<i>key</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#setEncodedFragment">setEncodedFragment</a></b>(const QByteArray &<i>fragment</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#setEncodedHost">setEncodedHost</a></b>(const QByteArray &<i>host</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#setEncodedPassword">setEncodedPassword</a></b>(const QByteArray &<i>password</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#setEncodedPath">setEncodedPath</a></b>(const QByteArray &<i>path</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#setEncodedQuery">setEncodedQuery</a></b>(const QByteArray &<i>query</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#setEncodedQueryItems">setEncodedQueryItems</a></b>(const QList<QPair<QByteArray, QByteArray> > &<i>query</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#setEncodedUrl">setEncodedUrl</a></b>(const QByteArray &<i>encodedUrl</i>, ParsingMode <i>parsingMode</i> = TolerantMode)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#setEncodedUserName">setEncodedUserName</a></b>(const QByteArray &<i>userName</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#setQueryItems">setQueryItems</a></b>(const QList<QPair<QString, QString> > &<i>query</i>)</td></tr>
</table></div>
<h2>Static Public Members</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QString </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#fromPunycode">fromPunycode</a></b>(const QByteArray &<i>pc</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qurl-obsolete.html#toPunycode">toPunycode</a></b>(const QString &<i>uc</i>)</td></tr>
</table></div>
<h2>Member Function Documentation</h2>
<!-- $$$addEncodedQueryItem[overload1]$$$addEncodedQueryItemconstQByteArray&constQByteArray& -->
<h3 class="fn" id="addEncodedQueryItem"><a name="addEncodedQueryItem"></a><span class="type">void</span> QUrl::<span class="name">addEncodedQueryItem</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>key</i>, const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>value</i>)</h3>
<p>Inserts the pair <i>key</i> = <i>value</i> into the query string of the URL.</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#addQueryItem">addQueryItem</a>().</p>
<!-- @@@addEncodedQueryItem -->
<!-- $$$addQueryItem[overload1]$$$addQueryItemconstQString&constQString& -->
<h3 class="fn" id="addQueryItem"><a name="addQueryItem"></a><span class="type">void</span> QUrl::<span class="name">addQueryItem</span>(const <span class="type"><a href="qstring.html">QString</a></span> &<i>key</i>, const <span class="type"><a href="qstring.html">QString</a></span> &<i>value</i>)</h3>
<p>Inserts the pair <i>key</i> = <i>value</i> into the query string of the URL.</p>
<p>The key-value pair is encoded before it is added to the query. The pair is converted into separate strings internally. The <i>key</i> and <i>value</i> is first encoded into UTF-8 and then delimited by the character returned by <a href="qurlquery.html#queryValueDelimiter">queryValueDelimiter()</a>. Each key-value pair is delimited by the character returned by <a href="qurlquery.html#queryPairDelimiter">queryPairDelimiter()</a></p>
<p><b>Note: </b>This method does not encode spaces (ASCII 0x20) as plus (+) signs, like HTML forms do. If you need that kind of encoding, you must encode the value yourself and use <a href="qurl-obsolete.html#addEncodedQueryItem">QUrl::addEncodedQueryItem</a>.</p><p><b>See also </b><a href="qurl-obsolete.html#addEncodedQueryItem">addEncodedQueryItem</a>().</p>
<!-- @@@addQueryItem -->
<!-- $$$allEncodedQueryItemValues[overload1]$$$allEncodedQueryItemValuesconstQByteArray& -->
<h3 class="fn" id="allEncodedQueryItemValues"><a name="allEncodedQueryItemValues"></a><span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qbytearray.html">QByteArray</a></span>> QUrl::<span class="name">allEncodedQueryItemValues</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>key</i>) const</h3>
<p>Returns the a list of query string values whose key is equal to <i>key</i> from the URL.</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#allQueryItemValues">allQueryItemValues</a>(), <a href="qurl-obsolete.html#queryItemValue">queryItemValue</a>(), and <a href="qurl-obsolete.html#encodedQueryItemValue">encodedQueryItemValue</a>().</p>
<!-- @@@allEncodedQueryItemValues -->
<!-- $$$allQueryItemValues[overload1]$$$allQueryItemValuesconstQString& -->
<h3 class="fn" id="allQueryItemValues"><a name="allQueryItemValues"></a><span class="type"><a href="qstringlist.html">QStringList</a></span> QUrl::<span class="name">allQueryItemValues</span>(const <span class="type"><a href="qstring.html">QString</a></span> &<i>key</i>) const</h3>
<p>Returns the a list of query string values whose key is equal to <i>key</i> from the URL.</p>
<p><b>Note: </b>This method does not decode spaces plus (+) signs as spaces (ASCII 0x20), like HTML forms do. If you need that kind of decoding, you must use <a href="qurl-obsolete.html#allEncodedQueryItemValues">QUrl::allEncodedQueryItemValues</a> and decode the data yourself.</p><p><b>See also </b><a href="qurl-obsolete.html#queryItemValue">queryItemValue</a>().</p>
<!-- @@@allQueryItemValues -->
<!-- $$$encodedFragment[overload1]$$$encodedFragment -->
<h3 class="fn" id="encodedFragment"><a name="encodedFragment"></a><span class="type"><a href="qbytearray.html">QByteArray</a></span> QUrl::<span class="name">encodedFragment</span>() const</h3>
<p>Returns the fragment of the URL if it is defined; otherwise an empty string is returned. The returned value will have its non-ASCII and other control characters percent-encoded, as in <a href="qurl.html#toEncoded">toEncoded</a>().</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#setEncodedFragment">setEncodedFragment</a>() and <a href="qurl.html#toEncoded">toEncoded</a>().</p>
<!-- @@@encodedFragment -->
<!-- $$$encodedHost[overload1]$$$encodedHost -->
<h3 class="fn" id="encodedHost"><a name="encodedHost"></a><span class="type"><a href="qbytearray.html">QByteArray</a></span> QUrl::<span class="name">encodedHost</span>() const</h3>
<p>Returns the host part of the URL if it is defined; otherwise an empty string is returned.</p>
<p>Note: encodedHost() does not return percent-encoded hostnames. Instead, the ACE-encoded (bare ASCII in Punycode encoding) form will be returned for any non-ASCII hostname.</p>
<p>This function is equivalent to calling <a href="qurl.html#toAce">QUrl::toAce</a>() on the return value of <a href="qurl.html#host">host</a>().</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#setEncodedHost">setEncodedHost</a>().</p>
<!-- @@@encodedHost -->
<!-- $$$encodedPassword[overload1]$$$encodedPassword -->
<h3 class="fn" id="encodedPassword"><a name="encodedPassword"></a><span class="type"><a href="qbytearray.html">QByteArray</a></span> QUrl::<span class="name">encodedPassword</span>() const</h3>
<p>Returns the password of the URL if it is defined; otherwise an empty string is returned. The returned value will have its non-ASCII and other control characters percent-encoded, as in <a href="qurl.html#toEncoded">toEncoded</a>().</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#setEncodedPassword">setEncodedPassword</a>() and <a href="qurl.html#toEncoded">toEncoded</a>().</p>
<!-- @@@encodedPassword -->
<!-- $$$encodedPath[overload1]$$$encodedPath -->
<h3 class="fn" id="encodedPath"><a name="encodedPath"></a><span class="type"><a href="qbytearray.html">QByteArray</a></span> QUrl::<span class="name">encodedPath</span>() const</h3>
<p>Returns the path of the URL if it is defined; otherwise an empty string is returned. The returned value will have its non-ASCII and other control characters percent-encoded, as in <a href="qurl.html#toEncoded">toEncoded</a>().</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#setEncodedPath">setEncodedPath</a>() and <a href="qurl.html#toEncoded">toEncoded</a>().</p>
<!-- @@@encodedPath -->
<!-- $$$encodedQuery[overload1]$$$encodedQuery -->
<h3 class="fn" id="encodedQuery"><a name="encodedQuery"></a><span class="type"><a href="qbytearray.html">QByteArray</a></span> QUrl::<span class="name">encodedQuery</span>() const</h3>
<p>Returns the query string of the URL in percent encoded form.</p>
<p><b>See also </b><a href="qurl-obsolete.html#setEncodedQuery">setEncodedQuery</a>() and <a href="qurl.html#query">query</a>().</p>
<!-- @@@encodedQuery -->
<!-- $$$encodedQueryItemValue[overload1]$$$encodedQueryItemValueconstQByteArray& -->
<h3 class="fn" id="encodedQueryItemValue"><a name="encodedQueryItemValue"></a><span class="type"><a href="qbytearray.html">QByteArray</a></span> QUrl::<span class="name">encodedQueryItemValue</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>key</i>) const</h3>
<p>Returns the first query string value whose key is equal to <i>key</i> from the URL.</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#queryItemValue">queryItemValue</a>() and <a href="qurl-obsolete.html#allQueryItemValues">allQueryItemValues</a>().</p>
<!-- @@@encodedQueryItemValue -->
<!-- $$$encodedQueryItems[overload1]$$$encodedQueryItems -->
<h3 class="fn" id="encodedQueryItems"><a name="encodedQueryItems"></a><span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qpair.html">QPair</a></span><<span class="type"><a href="qbytearray.html">QByteArray</a></span>, <span class="type"><a href="qbytearray.html">QByteArray</a></span>> > QUrl::<span class="name">encodedQueryItems</span>() const</h3>
<p>Returns the query string of the URL, as a map of encoded keys and values.</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#setEncodedQueryItems">setEncodedQueryItems</a>(), <a href="qurl-obsolete.html#setQueryItems">setQueryItems</a>(), and <a href="qurl-obsolete.html#setEncodedQuery">setEncodedQuery</a>().</p>
<!-- @@@encodedQueryItems -->
<!-- $$$encodedUserName[overload1]$$$encodedUserName -->
<h3 class="fn" id="encodedUserName"><a name="encodedUserName"></a><span class="type"><a href="qbytearray.html">QByteArray</a></span> QUrl::<span class="name">encodedUserName</span>() const</h3>
<p>Returns the user name of the URL if it is defined; otherwise an empty string is returned. The returned value will have its non-ASCII and other control characters percent-encoded, as in <a href="qurl.html#toEncoded">toEncoded</a>().</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#setEncodedUserName">setEncodedUserName</a>().</p>
<!-- @@@encodedUserName -->
<!-- $$$fromPunycode[overload1]$$$fromPunycodeconstQByteArray& -->
<h3 class="fn" id="fromPunycode"><a name="fromPunycode"></a><code>[static] </code><span class="type"><a href="qstring.html">QString</a></span> QUrl::<span class="name">fromPunycode</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>pc</i>)</h3>
<p>Returns the Punycode decoded representation of <i>pc</i>.</p>
<p>Punycode is a Unicode encoding used for internationalized domain names, as defined in RFC3492. If you want to convert a domain from its ASCII-compatible encoding to the Unicode representation, use <a href="qurl.html#fromAce">fromAce</a>().</p>
<!-- @@@fromPunycode -->
<!-- $$$hasEncodedQueryItem[overload1]$$$hasEncodedQueryItemconstQByteArray& -->
<h3 class="fn" id="hasEncodedQueryItem"><a name="hasEncodedQueryItem"></a><span class="type">bool</span> QUrl::<span class="name">hasEncodedQueryItem</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>key</i>) const</h3>
<p>Returns <code>true</code> if there is a query string pair whose key is equal to <i>key</i> from the URL.</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#hasQueryItem">hasQueryItem</a>().</p>
<!-- @@@hasEncodedQueryItem -->
<!-- $$$hasQueryItem[overload1]$$$hasQueryItemconstQString& -->
<h3 class="fn" id="hasQueryItem"><a name="hasQueryItem"></a><span class="type">bool</span> QUrl::<span class="name">hasQueryItem</span>(const <span class="type"><a href="qstring.html">QString</a></span> &<i>key</i>) const</h3>
<p>Returns <code>true</code> if there is a query string pair whose key is equal to <i>key</i> from the URL.</p>
<p><b>See also </b><a href="qurl-obsolete.html#hasEncodedQueryItem">hasEncodedQueryItem</a>().</p>
<!-- @@@hasQueryItem -->
<!-- $$$queryItemValue[overload1]$$$queryItemValueconstQString& -->
<h3 class="fn" id="queryItemValue"><a name="queryItemValue"></a><span class="type"><a href="qstring.html">QString</a></span> QUrl::<span class="name">queryItemValue</span>(const <span class="type"><a href="qstring.html">QString</a></span> &<i>key</i>) const</h3>
<p>Returns the first query string value whose key is equal to <i>key</i> from the URL.</p>
<p><b>Note: </b>This method does not decode spaces plus (+) signs as spaces (ASCII 0x20), like HTML forms do. If you need that kind of decoding, you must use <a href="qurl-obsolete.html#encodedQueryItemValue">QUrl::encodedQueryItemValue</a> and decode the data yourself.</p><p><b>See also </b><a href="qurl-obsolete.html#allQueryItemValues">allQueryItemValues</a>().</p>
<!-- @@@queryItemValue -->
<!-- $$$queryItems[overload1]$$$queryItems -->
<h3 class="fn" id="queryItems"><a name="queryItems"></a><span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qpair.html">QPair</a></span><<span class="type"><a href="qstring.html">QString</a></span>, <span class="type"><a href="qstring.html">QString</a></span>> > QUrl::<span class="name">queryItems</span>() const</h3>
<p>Returns the query string of the URL, as a map of keys and values.</p>
<p><b>Note: </b>This method does not decode spaces plus (+) signs as spaces (ASCII 0x20), like HTML forms do. If you need that kind of decoding, you must use <a href="qurl-obsolete.html#encodedQueryItems">QUrl::encodedQueryItems</a> and decode the data yourself.</p><p><b>See also </b><a href="qurl-obsolete.html#setQueryItems">setQueryItems</a>() and <a href="qurl-obsolete.html#setEncodedQuery">setEncodedQuery</a>().</p>
<!-- @@@queryItems -->
<!-- $$$removeAllEncodedQueryItems[overload1]$$$removeAllEncodedQueryItemsconstQByteArray& -->
<h3 class="fn" id="removeAllEncodedQueryItems"><a name="removeAllEncodedQueryItems"></a><span class="type">void</span> QUrl::<span class="name">removeAllEncodedQueryItems</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>key</i>)</h3>
<p>Removes all the query string pairs whose key is equal to <i>key</i> from the URL.</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#removeQueryItem">removeQueryItem</a>().</p>
<!-- @@@removeAllEncodedQueryItems -->
<!-- $$$removeAllQueryItems[overload1]$$$removeAllQueryItemsconstQString& -->
<h3 class="fn" id="removeAllQueryItems"><a name="removeAllQueryItems"></a><span class="type">void</span> QUrl::<span class="name">removeAllQueryItems</span>(const <span class="type"><a href="qstring.html">QString</a></span> &<i>key</i>)</h3>
<p>Removes all the query string pairs whose key is equal to <i>key</i> from the URL.</p>
<p><b>See also </b><a href="qurl-obsolete.html#removeQueryItem">removeQueryItem</a>().</p>
<!-- @@@removeAllQueryItems -->
<!-- $$$removeEncodedQueryItem[overload1]$$$removeEncodedQueryItemconstQByteArray& -->
<h3 class="fn" id="removeEncodedQueryItem"><a name="removeEncodedQueryItem"></a><span class="type">void</span> QUrl::<span class="name">removeEncodedQueryItem</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>key</i>)</h3>
<p>Removes the first query string pair whose key is equal to <i>key</i> from the URL.</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#removeQueryItem">removeQueryItem</a>() and <a href="qurl-obsolete.html#removeAllQueryItems">removeAllQueryItems</a>().</p>
<!-- @@@removeEncodedQueryItem -->
<!-- $$$removeQueryItem[overload1]$$$removeQueryItemconstQString& -->
<h3 class="fn" id="removeQueryItem"><a name="removeQueryItem"></a><span class="type">void</span> QUrl::<span class="name">removeQueryItem</span>(const <span class="type"><a href="qstring.html">QString</a></span> &<i>key</i>)</h3>
<p>Removes the first query string pair whose key is equal to <i>key</i> from the URL.</p>
<p><b>See also </b><a href="qurl-obsolete.html#removeAllQueryItems">removeAllQueryItems</a>().</p>
<!-- @@@removeQueryItem -->
<!-- $$$setEncodedFragment[overload1]$$$setEncodedFragmentconstQByteArray& -->
<h3 class="fn" id="setEncodedFragment"><a name="setEncodedFragment"></a><span class="type">void</span> QUrl::<span class="name">setEncodedFragment</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>fragment</i>)</h3>
<p>Sets the URL's fragment to the percent-encoded <i>fragment</i>. The fragment is the last part of the URL, represented by a '#' followed by a string of characters. It is typically used in HTTP for referring to a certain link or point on a page:</p>
<p class="centerAlign"><img src="images/qurl-fragment.png" alt="" /></p><p>The fragment is sometimes also referred to as the URL "reference".</p>
<p>Passing an argument of QByteArray() (a null <a href="qbytearray.html">QByteArray</a>) will unset the fragment. Passing an argument of <a href="qbytearray.html">QByteArray</a>("") (an empty but not null <a href="qbytearray.html">QByteArray</a>) will set the fragment to an empty string (as if the original URL had a lone "#").</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl.html#setFragment">setFragment</a>() and <a href="qurl-obsolete.html#encodedFragment">encodedFragment</a>().</p>
<!-- @@@setEncodedFragment -->
<!-- $$$setEncodedHost[overload1]$$$setEncodedHostconstQByteArray& -->
<h3 class="fn" id="setEncodedHost"><a name="setEncodedHost"></a><span class="type">void</span> QUrl::<span class="name">setEncodedHost</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>host</i>)</h3>
<p>Sets the URL's host to the ACE- or percent-encoded <i>host</i>. The <i>host</i> is part of the user info element in the authority of the URL, as described in <a href="qurl.html#setAuthority">setAuthority</a>().</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl.html#setHost">setHost</a>(), <a href="qurl-obsolete.html#encodedHost">encodedHost</a>(), <a href="qurl.html#setAuthority">setAuthority</a>(), and <a href="qurl.html#fromAce">fromAce</a>().</p>
<!-- @@@setEncodedHost -->
<!-- $$$setEncodedPassword[overload1]$$$setEncodedPasswordconstQByteArray& -->
<h3 class="fn" id="setEncodedPassword"><a name="setEncodedPassword"></a><span class="type">void</span> QUrl::<span class="name">setEncodedPassword</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>password</i>)</h3>
<p>Sets the URL's password to the percent-encoded <i>password</i>. The <i>password</i> is part of the user info element in the authority of the URL, as described in <a href="qurl.html#setUserInfo">setUserInfo</a>().</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl.html#setPassword">setPassword</a>(), <a href="qurl-obsolete.html#encodedPassword">encodedPassword</a>(), and <a href="qurl.html#setUserInfo">setUserInfo</a>().</p>
<!-- @@@setEncodedPassword -->
<!-- $$$setEncodedPath[overload1]$$$setEncodedPathconstQByteArray& -->
<h3 class="fn" id="setEncodedPath"><a name="setEncodedPath"></a><span class="type">void</span> QUrl::<span class="name">setEncodedPath</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>path</i>)</h3>
<p>Sets the URL's path to the percent-encoded <i>path</i>. The path is the part of the URL that comes after the authority but before the query string.</p>
<p class="centerAlign"><img src="images/qurl-ftppath.png" alt="" /></p><p>For non-hierarchical schemes, the path will be everything following the scheme declaration, as in the following example:</p>
<p class="centerAlign"><img src="images/qurl-mailtopath.png" alt="" /></p><p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl.html#setPath">setPath</a>(), <a href="qurl-obsolete.html#encodedPath">encodedPath</a>(), and <a href="qurl.html#setUserInfo">setUserInfo</a>().</p>
<!-- @@@setEncodedPath -->
<!-- $$$setEncodedQuery[overload1]$$$setEncodedQueryconstQByteArray& -->
<h3 class="fn" id="setEncodedQuery"><a name="setEncodedQuery"></a><span class="type">void</span> QUrl::<span class="name">setEncodedQuery</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>query</i>)</h3>
<p>Sets the query string of the URL to <i>query</i>. The string is inserted as-is, and no further encoding is performed when calling <a href="qurl.html#toEncoded">toEncoded</a>().</p>
<p>This function is useful if you need to pass a query string that does not fit into the key-value pattern, or that uses a different scheme for encoding special characters than what is suggested by <a href="qurl.html">QUrl</a>.</p>
<p>Passing a value of QByteArray() to <i>query</i> (a null <a href="qbytearray.html">QByteArray</a>) unsets the query completely. However, passing a value of <a href="qbytearray.html">QByteArray</a>("") will set the query to an empty value, as if the original URL had a lone "?".</p>
<p><b>See also </b><a href="qurl-obsolete.html#encodedQuery">encodedQuery</a>() and <a href="qurl.html#hasQuery">hasQuery</a>().</p>
<!-- @@@setEncodedQuery -->
<!-- $$$setEncodedQueryItems[overload1]$$$setEncodedQueryItemsconstQList<QPair<QByteArray,QByteArray>>& -->
<h3 class="fn" id="setEncodedQueryItems"><a name="setEncodedQueryItems"></a><span class="type">void</span> QUrl::<span class="name">setEncodedQueryItems</span>(const <span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qpair.html">QPair</a></span><<span class="type"><a href="qbytearray.html">QByteArray</a></span>, <span class="type"><a href="qbytearray.html">QByteArray</a></span>> > &<i>query</i>)</h3>
<p>Sets the query string of the URL to the encoded version of <i>query</i>. The contents of <i>query</i> are converted to a string internally, each pair delimited by the character returned by <a href="qurlquery.html#queryPairDelimiter">queryPairDelimiter()</a>, and the key and value are delimited by <a href="qurlquery.html#queryValueDelimiter">queryValueDelimiter()</a>.</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl-obsolete.html#encodedQueryItems">encodedQueryItems</a>() and <a href="qurl-obsolete.html#setQueryItems">setQueryItems</a>().</p>
<!-- @@@setEncodedQueryItems -->
<!-- $$$setEncodedUrl[overload1]$$$setEncodedUrlconstQByteArray&ParsingMode -->
<h3 class="fn" id="setEncodedUrl"><a name="setEncodedUrl"></a><span class="type">void</span> QUrl::<span class="name">setEncodedUrl</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>encodedUrl</i>, <span class="type"><a href="qurl.html#ParsingMode-enum">ParsingMode</a></span> <i>parsingMode</i> = TolerantMode)</h3>
<p>Constructs a URL by parsing the contents of <i>encodedUrl</i>.</p>
<p><i>encodedUrl</i> is assumed to be a URL string in percent encoded form, containing only ASCII characters.</p>
<p>The parsing mode <i>parsingMode</i> is used for parsing <i>encodedUrl</i>.</p>
<p><b>See also </b><a href="qurl.html#setUrl">setUrl</a>().</p>
<!-- @@@setEncodedUrl -->
<!-- $$$setEncodedUserName[overload1]$$$setEncodedUserNameconstQByteArray& -->
<h3 class="fn" id="setEncodedUserName"><a name="setEncodedUserName"></a><span class="type">void</span> QUrl::<span class="name">setEncodedUserName</span>(const <span class="type"><a href="qbytearray.html">QByteArray</a></span> &<i>userName</i>)</h3>
<p>Sets the URL's user name to the percent-encoded <i>userName</i>. The <i>userName</i> is part of the user info element in the authority of the URL, as described in <a href="qurl.html#setUserInfo">setUserInfo</a>().</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also </b><a href="qurl.html#setUserName">setUserName</a>(), <a href="qurl-obsolete.html#encodedUserName">encodedUserName</a>(), and <a href="qurl.html#setUserInfo">setUserInfo</a>().</p>
<!-- @@@setEncodedUserName -->
<!-- $$$setQueryItems[overload1]$$$setQueryItemsconstQList<QPair<QString,QString>>& -->
<h3 class="fn" id="setQueryItems"><a name="setQueryItems"></a><span class="type">void</span> QUrl::<span class="name">setQueryItems</span>(const <span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qpair.html">QPair</a></span><<span class="type"><a href="qstring.html">QString</a></span>, <span class="type"><a href="qstring.html">QString</a></span>> > &<i>query</i>)</h3>
<p>Sets the query string of the URL to an encoded version of <i>query</i>. The contents of <i>query</i> are converted to a string internally, each pair delimited by the character returned by <a href="qurlquery.html#queryPairDelimiter">queryPairDelimiter()</a>, and the key and value are delimited by <a href="qurlquery.html#queryValueDelimiter">queryValueDelimiter()</a></p>
<p><b>Note: </b>This method does not encode spaces (ASCII 0x20) as plus (+) signs, like HTML forms do. If you need that kind of encoding, you must encode the value yourself and use <a href="qurl-obsolete.html#setEncodedQueryItems">QUrl::setEncodedQueryItems</a>.</p><p><b>See also </b><a href="qurl-obsolete.html#queryItems">queryItems</a>() and <a href="qurl-obsolete.html#setEncodedQueryItems">setEncodedQueryItems</a>().</p>
<!-- @@@setQueryItems -->
<!-- $$$toPunycode[overload1]$$$toPunycodeconstQString& -->
<h3 class="fn" id="toPunycode"><a name="toPunycode"></a><code>[static] </code><span class="type"><a href="qbytearray.html">QByteArray</a></span> QUrl::<span class="name">toPunycode</span>(const <span class="type"><a href="qstring.html">QString</a></span> &<i>uc</i>)</h3>
<p>Returns a <i>uc</i> in Punycode encoding.</p>
<p>Punycode is a Unicode encoding used for internationalized domain names, as defined in RFC3492. If you want to convert a domain name from Unicode to its ASCII-compatible representation, use <a href="qurl.html#toAce">toAce</a>().</p>
<!-- @@@toPunycode -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2017 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
distrib
>
Mageia
>
6
>
armv5tl
>
media
>
core-updates
>
by-pkgid
>
768f7d9f703884aa2562bf0a651086df
>
files
>
841
