<?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.12.6</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.12</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"><a href="qtcore-index.html">Qt 5.12.6 Reference Documentation</a></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>, QUrl::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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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&QUrl::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">QUrl::ParsingMode</a></span> <i>parsingMode</i> = TolerantMode)</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <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> 2019 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>