<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qnetworkreply.cpp -->
<title>Qt 4.8: QNetworkReply Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtnetwork.html">QtNetwork</a></li>
<li>QNetworkReply</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#public-slots">Public Slots</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#protected-functions">Protected Functions</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QNetworkReply Class Reference</h1>
<!-- $$$QNetworkReply-brief -->
<p>The QNetworkReply class contains the data and headers for a request sent with <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> <a href="#details">More...</a></p>
<!-- @@@QNetworkReply -->
<pre class="cpp"> <span class="preprocessor">#include <QNetworkReply></span></pre><p><b>Inherits: </b><a href="qiodevice.html">QIODevice</a>.</p>
<p><b>Note:</b> All functions in this class are <a href="threads-reentrancy.html#reentrant">reentrant</a>.</p>
<p>This class was introduced in Qt 4.4.</p>
<ul>
<li><a href="qnetworkreply-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#NetworkError-enum">NetworkError</a></b> { NoError, ConnectionRefusedError, RemoteHostClosedError, HostNotFoundError, ..., ProtocolFailure }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> typedef </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#RawHeaderPair-typedef">RawHeaderPair</a></b></td></tr>
</table>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#dtor.QNetworkReply">~QNetworkReply</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#abort">abort</a></b> () = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QVariant </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#attribute">attribute</a></b> ( QNetworkRequest::Attribute <i>code</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> NetworkError </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#error">error</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#hasRawHeader">hasRawHeader</a></b> ( const QByteArray & <i>headerName</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QVariant </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#header">header</a></b> ( QNetworkRequest::KnownHeaders <i>header</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#ignoreSslErrors-2">ignoreSslErrors</a></b> ( const QList<QSslError> & <i>errors</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#isFinished">isFinished</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#isRunning">isRunning</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QNetworkAccessManager * </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#manager">manager</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QNetworkAccessManager::Operation </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#operation">operation</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#rawHeader">rawHeader</a></b> ( const QByteArray & <i>headerName</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QByteArray> </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#rawHeaderList">rawHeaderList</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QList<RawHeaderPair> & </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#rawHeaderPairs">rawHeaderPairs</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qint64 </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#readBufferSize">readBufferSize</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QNetworkRequest </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#request">request</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#setReadBufferSize">setReadBufferSize</a></b> ( qint64 <i>size</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#setSslConfiguration">setSslConfiguration</a></b> ( const QSslConfiguration & <i>config</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QSslConfiguration </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#sslConfiguration">sslConfiguration</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QUrl </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#url">url</a></b> () const</td></tr>
</table>
<a name="reimplemented-public-functions"></a>
<h2>Reimplemented Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#close">close</a></b> ()</td></tr>
</table>
<ul>
<li class="fn">33 public functions inherited from <a href="qiodevice.html#public-functions">QIODevice</a></li>
<li class="fn">29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
</ul>
<a name="public-slots"></a>
<h2>Public Slots</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#ignoreSslErrors">ignoreSslErrors</a></b> ()</td></tr>
</table>
<ul>
<li class="fn">1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
</ul>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#downloadProgress">downloadProgress</a></b> ( qint64 <i>bytesReceived</i>, qint64 <i>bytesTotal</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#error-2">error</a></b> ( QNetworkReply::NetworkError <i>code</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#finished">finished</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#metaDataChanged">metaDataChanged</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#sslErrors">sslErrors</a></b> ( const QList<QSslError> & <i>errors</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#uploadProgress">uploadProgress</a></b> ( qint64 <i>bytesSent</i>, qint64 <i>bytesTotal</i> )</td></tr>
</table>
<ul>
<li class="fn">4 signals inherited from <a href="qiodevice.html#signals">QIODevice</a></li>
<li class="fn">1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
</ul>
<a name="protected-functions"></a>
<h2>Protected Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#QNetworkReply">QNetworkReply</a></b> ( QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#setAttribute">setAttribute</a></b> ( QNetworkRequest::Attribute <i>code</i>, const QVariant & <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#setError">setError</a></b> ( NetworkError <i>errorCode</i>, const QString & <i>errorString</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#setFinished">setFinished</a></b> ( bool <i>finished</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#setHeader">setHeader</a></b> ( QNetworkRequest::KnownHeaders <i>header</i>, const QVariant & <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#setOperation">setOperation</a></b> ( QNetworkAccessManager::Operation <i>operation</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#setRawHeader">setRawHeader</a></b> ( const QByteArray & <i>headerName</i>, const QByteArray & <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#setRequest">setRequest</a></b> ( const QNetworkRequest & <i>request</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnetworkreply.html#setUrl">setUrl</a></b> ( const QUrl & <i>url</i> )</td></tr>
</table>
<ul>
<li class="fn">5 protected functions inherited from <a href="qiodevice.html#protected-functions">QIODevice</a></li>
<li class="fn">8 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 property inherited from <a href="qobject.html#properties">QObject</a></li>
<li class="fn">7 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QNetworkReply-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QNetworkReply class contains the data and headers for a request sent with <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a></p>
<p>The QNetworkReply class contains the data and meta data related to a request posted with <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>. Like <a href="qnetworkrequest.html">QNetworkRequest</a>, it contains a URL and headers (both in parsed and raw form), some information about the reply's state and the contents of the reply itself.</p>
<p>QNetworkReply is a sequential-access <a href="qiodevice.html">QIODevice</a>, which means that once data is read from the object, it no longer kept by the device. It is therefore the application's responsibility to keep this data if it needs to. Whenever more data is received from the network and processed, the <a href="qiodevice.html#readyRead">readyRead</a>() signal is emitted.</p>
<p>The <a href="qnetworkreply.html#downloadProgress">downloadProgress</a>() signal is also emitted when data is received, but the number of bytes contained in it may not represent the actual bytes received, if any transformation is done to the contents (for example, decompressing and removing the protocol overhead).</p>
<p>Even though QNetworkReply is a <a href="qiodevice.html">QIODevice</a> connected to the contents of the reply, it also emits the <a href="qnetworkreply.html#uploadProgress">uploadProgress</a>() signal, which indicates the progress of the upload for operations that have such content.</p>
<p><b>Note:</b> Do not delete the object in the slot connected to the <a href="qnetworkreply.html#error">error</a>() or <a href="qnetworkreply.html#finished">finished</a>() signal. Use <a href="qobject.html#deleteLater">deleteLater</a>().</p>
</div>
<p><b>See also </b><a href="qnetworkrequest.html">QNetworkRequest</a> and <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>.</p>
<!-- @@@QNetworkReply -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$NetworkError$$$NoError$$$ConnectionRefusedError$$$RemoteHostClosedError$$$HostNotFoundError$$$TimeoutError$$$OperationCanceledError$$$SslHandshakeFailedError$$$TemporaryNetworkFailureError$$$UnknownNetworkError$$$ProxyConnectionRefusedError$$$ProxyConnectionClosedError$$$ProxyNotFoundError$$$ProxyTimeoutError$$$ProxyAuthenticationRequiredError$$$UnknownProxyError$$$ContentAccessDenied$$$ContentOperationNotPermittedError$$$ContentNotFoundError$$$AuthenticationRequiredError$$$ContentReSendError$$$UnknownContentError$$$ProtocolUnknownError$$$ProtocolInvalidOperationError$$$ProtocolFailure -->
<h3 class="fn"><a name="NetworkError-enum"></a>enum QNetworkReply::<span class="name">NetworkError</span></h3>
<p>Indicates all possible error conditions found during the processing of the request.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QNetworkReply::NoError</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">no error condition. <b>Note:</b> When the HTTP protocol returns a redirect no error will be reported. You can check if there is a redirect with the <a href="qnetworkrequest.html#Attribute-enum">QNetworkRequest::RedirectionTargetAttribute</a> attribute.</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ConnectionRefusedError</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">the remote server refused the connection (the server is not accepting requests)</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::RemoteHostClosedError</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">the remote server closed the connection prematurely, before the entire reply was received and processed</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::HostNotFoundError</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">the remote host name was not found (invalid hostname)</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::TimeoutError</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">the connection to the remote server timed out</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::OperationCanceledError</tt></td><td class="topAlign"><tt>5</tt></td><td class="topAlign">the operation was canceled via calls to <a href="qnetworkreply.html#abort">abort</a>() or <a href="qnetworkreply.html#close">close</a>() before it was finished.</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::SslHandshakeFailedError</tt></td><td class="topAlign"><tt>6</tt></td><td class="topAlign">the SSL/TLS handshake failed and the encrypted channel could not be established. The <a href="qnetworkreply.html#sslErrors">sslErrors</a>() signal should have been emitted.</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::TemporaryNetworkFailureError</tt></td><td class="topAlign"><tt>7</tt></td><td class="topAlign">the connection was broken due to disconnection from the network, however the system has initiated roaming to another access point. The request should be resubmitted and will be processed as soon as the connection is re-established.</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ProxyConnectionRefusedError</tt></td><td class="topAlign"><tt>101</tt></td><td class="topAlign">the connection to the proxy server was refused (the proxy server is not accepting requests)</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ProxyConnectionClosedError</tt></td><td class="topAlign"><tt>102</tt></td><td class="topAlign">the proxy server closed the connection prematurely, before the entire reply was received and processed</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ProxyNotFoundError</tt></td><td class="topAlign"><tt>103</tt></td><td class="topAlign">the proxy host name was not found (invalid proxy hostname)</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ProxyTimeoutError</tt></td><td class="topAlign"><tt>104</tt></td><td class="topAlign">the connection to the proxy timed out or the proxy did not reply in time to the request sent</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ProxyAuthenticationRequiredError</tt></td><td class="topAlign"><tt>105</tt></td><td class="topAlign">the proxy requires authentication in order to honour the request but did not accept any credentials offered (if any)</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ContentAccessDenied</tt></td><td class="topAlign"><tt>201</tt></td><td class="topAlign">the access to the remote content was denied (similar to HTTP error 401)</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ContentOperationNotPermittedError</tt></td><td class="topAlign"><tt>202</tt></td><td class="topAlign">the operation requested on the remote content is not permitted</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ContentNotFoundError</tt></td><td class="topAlign"><tt>203</tt></td><td class="topAlign">the remote content was not found at the server (similar to HTTP error 404)</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::AuthenticationRequiredError</tt></td><td class="topAlign"><tt>204</tt></td><td class="topAlign">the remote server requires authentication to serve the content but the credentials provided were not accepted (if any)</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ContentReSendError</tt></td><td class="topAlign"><tt>205</tt></td><td class="topAlign">the request needed to be sent again, but this failed for example because the upload data could not be read a second time.</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ProtocolUnknownError</tt></td><td class="topAlign"><tt>301</tt></td><td class="topAlign">the Network Access API cannot honor the request because the protocol is not known</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ProtocolInvalidOperationError</tt></td><td class="topAlign"><tt>302</tt></td><td class="topAlign">the requested operation is invalid for this protocol</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::UnknownNetworkError</tt></td><td class="topAlign"><tt>99</tt></td><td class="topAlign">an unknown network-related error was detected</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::UnknownProxyError</tt></td><td class="topAlign"><tt>199</tt></td><td class="topAlign">an unknown proxy-related error was detected</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::UnknownContentError</tt></td><td class="topAlign"><tt>299</tt></td><td class="topAlign">an unknown error related to the remote content was detected</td></tr>
<tr><td class="topAlign"><tt>QNetworkReply::ProtocolFailure</tt></td><td class="topAlign"><tt>399</tt></td><td class="topAlign">a breakdown in protocol was detected (parsing error, invalid or unexpected responses, etc.)</td></tr>
</table>
<p><b>See also </b><a href="qnetworkreply.html#error">error</a>().</p>
<!-- @@@NetworkError -->
<!-- $$$RawHeaderPair -->
<h3 class="fn"><a name="RawHeaderPair-typedef"></a>typedef QNetworkReply::<span class="name">RawHeaderPair</span></h3>
<p>RawHeaderPair is a <a href="qpair.html">QPair</a><<a href="qbytearray.html">QByteArray</a>, <a href="qbytearray.html">QByteArray</a>> where the first <a href="qbytearray.html">QByteArray</a> is the header name and the second is the header.</p>
<!-- @@@RawHeaderPair -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QNetworkReply[overload1]$$$QNetworkReplyQObject* -->
<h3 class="fn"><a name="QNetworkReply"></a>QNetworkReply::<span class="name">QNetworkReply</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>parent</i> = 0 )<tt> [protected]</tt></h3>
<p>Creates a <a href="qnetworkreply.html">QNetworkReply</a> object with parent <i>parent</i>.</p>
<p>You cannot directly instantiate <a href="qnetworkreply.html">QNetworkReply</a> objects. Use <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> functions to do that.</p>
<!-- @@@QNetworkReply -->
<!-- $$$~QNetworkReply[overload1]$$$~QNetworkReply -->
<h3 class="fn"><a name="dtor.QNetworkReply"></a>QNetworkReply::<span class="name">~QNetworkReply</span> ()</h3>
<p>Disposes of this reply and frees any resources associated with it. If any network connections are still open, they will be closed.</p>
<p><b>See also </b><a href="qnetworkreply.html#abort">abort</a>() and <a href="qnetworkreply.html#close">close</a>().</p>
<!-- @@@~QNetworkReply -->
<!-- $$$abort[overload1]$$$abort -->
<h3 class="fn"><a name="abort"></a><span class="type">void</span> QNetworkReply::<span class="name">abort</span> ()<tt> [pure virtual]</tt></h3>
<p>Aborts the operation immediately and close down any network connections still open. Uploads still in progress are also aborted.</p>
<p><b>See also </b><a href="qnetworkreply.html#close">close</a>().</p>
<!-- @@@abort -->
<!-- $$$attribute[overload1]$$$attributeQNetworkRequest::Attribute -->
<h3 class="fn"><a name="attribute"></a><span class="type"><a href="qvariant.html">QVariant</a></span> QNetworkReply::<span class="name">attribute</span> ( <span class="type"><a href="qnetworkrequest.html#Attribute-enum">QNetworkRequest::Attribute</a></span> <i>code</i> ) const</h3>
<p>Returns the attribute associated with the code <i>code</i>. If the attribute has not been set, it returns an invalid <a href="qvariant.html">QVariant</a> (type QVariant::Null).</p>
<p>You can expect the default values listed in <a href="qnetworkrequest.html#Attribute-enum">QNetworkRequest::Attribute</a> to be applied to the values returned by this function.</p>
<p><b>See also </b><a href="qnetworkreply.html#setAttribute">setAttribute</a>() and <a href="qnetworkrequest.html#Attribute-enum">QNetworkRequest::Attribute</a>.</p>
<!-- @@@attribute -->
<!-- $$$close[overload1]$$$close -->
<h3 class="fn"><a name="close"></a><span class="type">void</span> QNetworkReply::<span class="name">close</span> ()<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qiodevice.html#close">QIODevice::close</a>().</p>
<p>Closes this device for reading. Unread data is discarded, but the network resources are not discarded until they are finished. In particular, if any upload is in progress, it will continue until it is done.</p>
<p>The <a href="qnetworkreply.html#finished">finished</a>() signal is emitted when all operations are over and the network resources are freed.</p>
<p><b>See also </b><a href="qnetworkreply.html#abort">abort</a>() and <a href="qnetworkreply.html#finished">finished</a>().</p>
<!-- @@@close -->
<!-- $$$downloadProgress[overload1]$$$downloadProgressqint64qint64 -->
<h3 class="fn"><a name="downloadProgress"></a><span class="type">void</span> QNetworkReply::<span class="name">downloadProgress</span> ( <span class="type"><a href="qtglobal.html#qint64-typedef">qint64</a></span> <i>bytesReceived</i>, <span class="type"><a href="qtglobal.html#qint64-typedef">qint64</a></span> <i>bytesTotal</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted to indicate the progress of the download part of this network request, if there's any. If there's no download associated with this request, this signal will be emitted once with 0 as the value of both <i>bytesReceived</i> and <i>bytesTotal</i>.</p>
<p>The <i>bytesReceived</i> parameter indicates the number of bytes received, while <i>bytesTotal</i> indicates the total number of bytes expected to be downloaded. If the number of bytes to be downloaded is not known, <i>bytesTotal</i> will be -1.</p>
<p>The download is finished when <i>bytesReceived</i> is equal to <i>bytesTotal</i>. At that time, <i>bytesTotal</i> will not be -1.</p>
<p>Note that the values of both <i>bytesReceived</i> and <i>bytesTotal</i> may be different from <a href="qiodevice.html#size">size</a>(), the total number of bytes obtained through <a href="qiodevice.html#read">read</a>() or <a href="qiodevice.html#readAll">readAll</a>(), or the value of the header(ContentLengthHeader). The reason for that is that there may be protocol overhead or the data may be compressed during the download.</p>
<p><b>See also </b><a href="qnetworkreply.html#uploadProgress">uploadProgress</a>() and <a href="qiodevice.html#bytesAvailable">bytesAvailable</a>().</p>
<!-- @@@downloadProgress -->
<!-- $$$error[overload1]$$$error -->
<h3 class="fn"><a name="error"></a><span class="type"><a href="qnetworkreply.html#NetworkError-enum">NetworkError</a></span> QNetworkReply::<span class="name">error</span> () const</h3>
<p>Returns the error that was found during the processing of this request. If no error was found, returns <a href="qnetworkreply.html#NetworkError-enum">NoError</a>.</p>
<p><b>See also </b><a href="qnetworkreply.html#setError">setError</a>().</p>
<!-- @@@error -->
<!-- $$$error$$$errorQNetworkReply::NetworkError -->
<h3 class="fn"><a name="error-2"></a><span class="type">void</span> QNetworkReply::<span class="name">error</span> ( <span class="type"><a href="qnetworkreply.html#NetworkError-enum">QNetworkReply::NetworkError</a></span> <i>code</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted when the reply detects an error in processing. The <a href="qnetworkreply.html#finished">finished</a>() signal will probably follow, indicating that the connection is over.</p>
<p>The <i>code</i> parameter contains the code of the error that was detected. Call <a href="qiodevice.html#errorString">errorString</a>() to obtain a textual representation of the error condition.</p>
<p><b>Note:</b> Do not delete the object in the slot connected to this signal. Use <a href="qobject.html#deleteLater">deleteLater</a>().</p>
<p><b>See also </b><a href="qnetworkreply.html#error">error</a>() and <a href="qiodevice.html#errorString">errorString</a>().</p>
<!-- @@@error -->
<!-- $$$finished[overload1]$$$finished -->
<h3 class="fn"><a name="finished"></a><span class="type">void</span> QNetworkReply::<span class="name">finished</span> ()<tt> [signal]</tt></h3>
<p>This signal is emitted when the reply has finished processing. After this signal is emitted, there will be no more updates to the reply's data or metadata.</p>
<p>Unless <a href="qnetworkreply.html#close">close</a>() has been called, the reply will be still be opened for reading, so the data can be retrieved by calls to <a href="qiodevice.html#read">read</a>() or <a href="qiodevice.html#readAll">readAll</a>(). In particular, if no calls to <a href="qiodevice.html#read">read</a>() were made as a result of <a href="qiodevice.html#readyRead">readyRead</a>(), a call to <a href="qiodevice.html#readAll">readAll</a>() will retrieve the full contents in a <a href="qbytearray.html">QByteArray</a>.</p>
<p>This signal is emitted in tandem with <a href="qnetworkaccessmanager.html#finished">QNetworkAccessManager::finished</a>() where that signal's reply parameter is this object.</p>
<p><b>Note:</b> Do not delete the object in the slot connected to this signal. Use <a href="qobject.html#deleteLater">deleteLater</a>().</p>
<p>You can also use <a href="qnetworkreply.html#isFinished">isFinished</a>() to check if a <a href="qnetworkreply.html">QNetworkReply</a> has finished even before you receive the finished() signal.</p>
<p><b>See also </b><a href="qnetworkreply.html#setFinished">setFinished</a>(), <a href="qnetworkaccessmanager.html#finished">QNetworkAccessManager::finished</a>(), and <a href="qnetworkreply.html#isFinished">isFinished</a>().</p>
<!-- @@@finished -->
<!-- $$$hasRawHeader[overload1]$$$hasRawHeaderconstQByteArray& -->
<h3 class="fn"><a name="hasRawHeader"></a><span class="type">bool</span> QNetworkReply::<span class="name">hasRawHeader</span> ( const <span class="type"><a href="qbytearray.html">QByteArray</a></span> & <i>headerName</i> ) const</h3>
<p>Returns true if the raw header of name <i>headerName</i> was sent by the remote server</p>
<p><b>See also </b><a href="qnetworkreply.html#rawHeader">rawHeader</a>().</p>
<!-- @@@hasRawHeader -->
<!-- $$$header[overload1]$$$headerQNetworkRequest::KnownHeaders -->
<h3 class="fn"><a name="header"></a><span class="type"><a href="qvariant.html">QVariant</a></span> QNetworkReply::<span class="name">header</span> ( <span class="type"><a href="qnetworkrequest.html#KnownHeaders-enum">QNetworkRequest::KnownHeaders</a></span> <i>header</i> ) const</h3>
<p>Returns the value of the known header <i>header</i>, if that header was sent by the remote server. If the header was not sent, returns an invalid <a href="qvariant.html">QVariant</a>.</p>
<p><b>See also </b><a href="qnetworkreply.html#rawHeader">rawHeader</a>(), <a href="qnetworkreply.html#setHeader">setHeader</a>(), and <a href="qnetworkrequest.html#header">QNetworkRequest::header</a>().</p>
<!-- @@@header -->
<!-- $$$ignoreSslErrors[overload1]$$$ignoreSslErrors -->
<h3 class="fn"><a name="ignoreSslErrors"></a><span class="type">void</span> QNetworkReply::<span class="name">ignoreSslErrors</span> ()<tt> [virtual slot]</tt></h3>
<p>If this function is called, SSL errors related to network connection will be ignored, including certificate validation errors.</p>
<p><b>Warning:</b> Be sure to always let the user inspect the errors reported by the <a href="qnetworkreply.html#sslErrors">sslErrors</a>() signal, and only call this method upon confirmation from the user that proceeding is ok. If there are unexpected errors, the reply should be aborted. Calling this method without inspecting the actual errors will most likely pose a security risk for your application. Use it with great care!</p>
<p>This function can be called from the slot connected to the <a href="qnetworkreply.html#sslErrors">sslErrors</a>() signal, which indicates which errors were found.</p>
<p><b>See also </b><a href="qnetworkreply.html#sslConfiguration">sslConfiguration</a>(), <a href="qnetworkreply.html#sslErrors">sslErrors</a>(), and <a href="qsslsocket.html#ignoreSslErrors">QSslSocket::ignoreSslErrors</a>().</p>
<!-- @@@ignoreSslErrors -->
<!-- $$$ignoreSslErrors$$$ignoreSslErrorsconstQList<QSslError>& -->
<h3 class="fn"><a name="ignoreSslErrors-2"></a><span class="type">void</span> QNetworkReply::<span class="name">ignoreSslErrors</span> ( const <span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qsslerror.html">QSslError</a></span>> & <i>errors</i> )</h3>
<p>This is an overloaded function.</p>
<p>If this function is called, the SSL errors given in <i>errors</i> will be ignored.</p>
<p>Note that you can set the expected certificate in the SSL error: If, for instance, you want to issue a request to a server that uses a self-signed certificate, consider the following snippet:</p>
<pre class="cpp"> <span class="type"><a href="qlist.html">QList</a></span><span class="operator"><</span><span class="type"><a href="qsslcertificate.html">QSslCertificate</a></span><span class="operator">></span> cert <span class="operator">=</span> <span class="type"><a href="qsslcertificate.html">QSslCertificate</a></span><span class="operator">::</span>fromPath(QLatin1String(<span class="string">"server-certificate.pem"</span>));
<span class="type"><a href="qsslerror.html">QSslError</a></span> <a href="qnetworkreply.html#error">error</a>(<span class="type"><a href="qsslerror.html">QSslError</a></span><span class="operator">::</span>SelfSignedCertificate<span class="operator">,</span> cert<span class="operator">.</span>at(<span class="number">0</span>));
<span class="type"><a href="qlist.html">QList</a></span><span class="operator"><</span><span class="type"><a href="qsslerror.html">QSslError</a></span><span class="operator">></span> expectedSslErrors;
expectedSslErrors<span class="operator">.</span>append(error);
<span class="type"><a href="qnetworkreply.html">QNetworkReply</a></span> <span class="operator">*</span>reply <span class="operator">=</span> manager<span class="operator">.</span>get(<span class="type"><a href="qnetworkrequest.html">QNetworkRequest</a></span>(<span class="type"><a href="qurl.html">QUrl</a></span>(<span class="string">"https://server.tld/index.html"</span>)));
reply<span class="operator">-</span><span class="operator">></span><a href="qnetworkreply.html#ignoreSslErrors">ignoreSslErrors</a>(expectedSslErrors);
<span class="comment">// here connect signals etc.</span></pre>
<p>Multiple calls to this function will replace the list of errors that were passed in previous calls. You can clear the list of errors you want to ignore by calling this function with an empty list.</p>
<p>This function was introduced in Qt 4.6.</p>
<p><b>See also </b><a href="qnetworkreply.html#sslConfiguration">sslConfiguration</a>(), <a href="qnetworkreply.html#sslErrors">sslErrors</a>(), and <a href="qsslsocket.html#ignoreSslErrors">QSslSocket::ignoreSslErrors</a>().</p>
<!-- @@@ignoreSslErrors -->
<!-- $$$isFinished[overload1]$$$isFinished -->
<h3 class="fn"><a name="isFinished"></a><span class="type">bool</span> QNetworkReply::<span class="name">isFinished</span> () const</h3>
<p>Returns true when the reply has finished or was aborted.</p>
<p>This function was introduced in Qt 4.6.</p>
<p><b>See also </b><a href="qnetworkreply.html#isRunning">isRunning</a>().</p>
<!-- @@@isFinished -->
<!-- $$$isRunning[overload1]$$$isRunning -->
<h3 class="fn"><a name="isRunning"></a><span class="type">bool</span> QNetworkReply::<span class="name">isRunning</span> () const</h3>
<p>Returns true when the request is still processing and the reply has not finished or was aborted yet.</p>
<p>This function was introduced in Qt 4.6.</p>
<p><b>See also </b><a href="qnetworkreply.html#isFinished">isFinished</a>().</p>
<!-- @@@isRunning -->
<!-- $$$manager[overload1]$$$manager -->
<h3 class="fn"><a name="manager"></a><span class="type"><a href="qnetworkaccessmanager.html">QNetworkAccessManager</a></span> * QNetworkReply::<span class="name">manager</span> () const</h3>
<p>Returns the <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> that was used to create this <a href="qnetworkreply.html">QNetworkReply</a> object. Initially, it is also the parent object.</p>
<!-- @@@manager -->
<!-- $$$metaDataChanged[overload1]$$$metaDataChanged -->
<h3 class="fn"><a name="metaDataChanged"></a><span class="type">void</span> QNetworkReply::<span class="name">metaDataChanged</span> ()<tt> [signal]</tt></h3>
<p>This signal is emitted whenever the metadata in this reply changes. metadata is any information that is not the content (data) itself, including the network headers. In the majority of cases, the metadata will be known fully by the time the first byte of data is received. However, it is possible to receive updates of headers or other metadata during the processing of the data.</p>
<p><b>See also </b><a href="qnetworkreply.html#header">header</a>(), <a href="qnetworkreply.html#rawHeaderList">rawHeaderList</a>(), <a href="qnetworkreply.html#rawHeader">rawHeader</a>(), and <a href="qnetworkreply.html#hasRawHeader">hasRawHeader</a>().</p>
<!-- @@@metaDataChanged -->
<!-- $$$operation[overload1]$$$operation -->
<h3 class="fn"><a name="operation"></a><span class="type"><a href="qnetworkaccessmanager.html#Operation-enum">QNetworkAccessManager::Operation</a></span> QNetworkReply::<span class="name">operation</span> () const</h3>
<p>Returns the operation that was posted for this reply.</p>
<p><b>See also </b><a href="qnetworkreply.html#setOperation">setOperation</a>().</p>
<!-- @@@operation -->
<!-- $$$rawHeader[overload1]$$$rawHeaderconstQByteArray& -->
<h3 class="fn"><a name="rawHeader"></a><span class="type"><a href="qbytearray.html">QByteArray</a></span> QNetworkReply::<span class="name">rawHeader</span> ( const <span class="type"><a href="qbytearray.html">QByteArray</a></span> & <i>headerName</i> ) const</h3>
<p>Returns the raw contents of the header <i>headerName</i> as sent by the remote server. If there is no such header, returns an empty byte array, which may be indistinguishable from an empty header. Use <a href="qnetworkreply.html#hasRawHeader">hasRawHeader</a>() to verify if the server sent such header field.</p>
<p><b>See also </b><a href="qnetworkreply.html#setRawHeader">setRawHeader</a>(), <a href="qnetworkreply.html#hasRawHeader">hasRawHeader</a>(), and <a href="qnetworkreply.html#header">header</a>().</p>
<!-- @@@rawHeader -->
<!-- $$$rawHeaderList[overload1]$$$rawHeaderList -->
<h3 class="fn"><a name="rawHeaderList"></a><span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qbytearray.html">QByteArray</a></span>> QNetworkReply::<span class="name">rawHeaderList</span> () const</h3>
<p>Returns a list of headers fields that were sent by the remote server, in the order that they were sent. Duplicate headers are merged together and take place of the latter duplicate.</p>
<!-- @@@rawHeaderList -->
<!-- $$$rawHeaderPairs[overload1]$$$rawHeaderPairs -->
<h3 class="fn"><a name="rawHeaderPairs"></a>const <span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qnetworkreply.html#RawHeaderPair-typedef">RawHeaderPair</a></span>> & QNetworkReply::<span class="name">rawHeaderPairs</span> () const</h3>
<p>Returns a list of raw header pairs.</p>
<!-- @@@rawHeaderPairs -->
<!-- $$$readBufferSize[overload1]$$$readBufferSize -->
<h3 class="fn"><a name="readBufferSize"></a><span class="type"><a href="qtglobal.html#qint64-typedef">qint64</a></span> QNetworkReply::<span class="name">readBufferSize</span> () const</h3>
<p>Returns the size of the read buffer, in bytes.</p>
<p><b>See also </b><a href="qnetworkreply.html#setReadBufferSize">setReadBufferSize</a>().</p>
<!-- @@@readBufferSize -->
<!-- $$$request[overload1]$$$request -->
<h3 class="fn"><a name="request"></a><span class="type"><a href="qnetworkrequest.html">QNetworkRequest</a></span> QNetworkReply::<span class="name">request</span> () const</h3>
<p>Returns the request that was posted for this reply. In special, note that the URL for the request may be different than that of the reply.</p>
<p><b>See also </b><a href="qnetworkrequest.html#url">QNetworkRequest::url</a>(), <a href="qnetworkreply.html#url">url</a>(), and <a href="qnetworkreply.html#setRequest">setRequest</a>().</p>
<!-- @@@request -->
<!-- $$$setAttribute[overload1]$$$setAttributeQNetworkRequest::AttributeconstQVariant& -->
<h3 class="fn"><a name="setAttribute"></a><span class="type">void</span> QNetworkReply::<span class="name">setAttribute</span> ( <span class="type"><a href="qnetworkrequest.html#Attribute-enum">QNetworkRequest::Attribute</a></span> <i>code</i>, const <span class="type"><a href="qvariant.html">QVariant</a></span> & <i>value</i> )<tt> [protected]</tt></h3>
<p>Sets the attribute <i>code</i> to have value <i>value</i>. If <i>code</i> was previously set, it will be overridden. If <i>value</i> is an invalid <a href="qvariant.html">QVariant</a>, the attribute will be unset.</p>
<p><b>See also </b><a href="qnetworkreply.html#attribute">attribute</a>() and <a href="qnetworkrequest.html#setAttribute">QNetworkRequest::setAttribute</a>().</p>
<!-- @@@setAttribute -->
<!-- $$$setError[overload1]$$$setErrorNetworkErrorconstQString& -->
<h3 class="fn"><a name="setError"></a><span class="type">void</span> QNetworkReply::<span class="name">setError</span> ( <span class="type"><a href="qnetworkreply.html#NetworkError-enum">NetworkError</a></span> <i>errorCode</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>errorString</i> )<tt> [protected]</tt></h3>
<p>Sets the error condition to be <i>errorCode</i>. The human-readable message is set with <i>errorString</i>.</p>
<p>Calling setError() does not emit the error(<a href="qnetworkreply.html#NetworkError-enum">QNetworkReply::NetworkError</a>) signal.</p>
<p><b>See also </b><a href="qnetworkreply.html#error">error</a>() and <a href="qiodevice.html#errorString">errorString</a>().</p>
<!-- @@@setError -->
<!-- $$$setFinished[overload1]$$$setFinishedbool -->
<h3 class="fn"><a name="setFinished"></a><span class="type">void</span> QNetworkReply::<span class="name">setFinished</span> ( <span class="type">bool</span> <i>finished</i> )<tt> [protected]</tt></h3>
<p>Sets the reply as <i>finished</i>.</p>
<p>After having this set the replies data must not change.</p>
<p>This function was introduced in Qt 4.8.</p>
<p><b>See also </b><a href="qnetworkreply.html#finished">finished</a>() and <a href="qnetworkreply.html#isFinished">isFinished</a>().</p>
<!-- @@@setFinished -->
<!-- $$$setHeader[overload1]$$$setHeaderQNetworkRequest::KnownHeadersconstQVariant& -->
<h3 class="fn"><a name="setHeader"></a><span class="type">void</span> QNetworkReply::<span class="name">setHeader</span> ( <span class="type"><a href="qnetworkrequest.html#KnownHeaders-enum">QNetworkRequest::KnownHeaders</a></span> <i>header</i>, const <span class="type"><a href="qvariant.html">QVariant</a></span> & <i>value</i> )<tt> [protected]</tt></h3>
<p>Sets the known header <i>header</i> to be of value <i>value</i>. The corresponding raw form of the header will be set as well.</p>
<p><b>See also </b><a href="qnetworkreply.html#header">header</a>(), <a href="qnetworkreply.html#setRawHeader">setRawHeader</a>(), and <a href="qnetworkrequest.html#setHeader">QNetworkRequest::setHeader</a>().</p>
<!-- @@@setHeader -->
<!-- $$$setOperation[overload1]$$$setOperationQNetworkAccessManager::Operation -->
<h3 class="fn"><a name="setOperation"></a><span class="type">void</span> QNetworkReply::<span class="name">setOperation</span> ( <span class="type"><a href="qnetworkaccessmanager.html#Operation-enum">QNetworkAccessManager::Operation</a></span> <i>operation</i> )<tt> [protected]</tt></h3>
<p>Sets the associated operation for this object to be <i>operation</i>. This value will be returned by <a href="qnetworkreply.html#operation">operation</a>().</p>
<p>Note: the operation should be set when this object is created and not changed again.</p>
<p><b>See also </b><a href="qnetworkreply.html#operation">operation</a>() and <a href="qnetworkreply.html#setRequest">setRequest</a>().</p>
<!-- @@@setOperation -->
<!-- $$$setRawHeader[overload1]$$$setRawHeaderconstQByteArray&constQByteArray& -->
<h3 class="fn"><a name="setRawHeader"></a><span class="type">void</span> QNetworkReply::<span class="name">setRawHeader</span> ( const <span class="type"><a href="qbytearray.html">QByteArray</a></span> & <i>headerName</i>, const <span class="type"><a href="qbytearray.html">QByteArray</a></span> & <i>value</i> )<tt> [protected]</tt></h3>
<p>Sets the raw header <i>headerName</i> to be of value <i>value</i>. If <i>headerName</i> was previously set, it is overridden. Multiple HTTP headers of the same name are functionally equivalent to one single header with the values concatenated, separated by commas.</p>
<p>If <i>headerName</i> matches a known header, the value <i>value</i> will be parsed and the corresponding parsed form will also be set.</p>
<p><b>See also </b><a href="qnetworkreply.html#rawHeader">rawHeader</a>(), <a href="qnetworkreply.html#header">header</a>(), <a href="qnetworkreply.html#setHeader">setHeader</a>(), and <a href="qnetworkrequest.html#setRawHeader">QNetworkRequest::setRawHeader</a>().</p>
<!-- @@@setRawHeader -->
<!-- $$$setReadBufferSize[overload1]$$$setReadBufferSizeqint64 -->
<h3 class="fn"><a name="setReadBufferSize"></a><span class="type">void</span> QNetworkReply::<span class="name">setReadBufferSize</span> ( <span class="type"><a href="qtglobal.html#qint64-typedef">qint64</a></span> <i>size</i> )<tt> [virtual]</tt></h3>
<p>Sets the size of the read buffer to be <i>size</i> bytes. The read buffer is the buffer that holds data that is being downloaded off the network, before it is read with <a href="qiodevice.html#read">QIODevice::read</a>(). Setting the buffer size to 0 will make the buffer unlimited in size.</p>
<p><a href="qnetworkreply.html">QNetworkReply</a> will try to stop reading from the network once this buffer is full (i.e., <a href="qiodevice.html#bytesAvailable">bytesAvailable</a>() returns <i>size</i> or more), thus causing the download to throttle down as well. If the buffer is not limited in size, <a href="qnetworkreply.html">QNetworkReply</a> will try to download as fast as possible from the network.</p>
<p>Unlike <a href="qabstractsocket.html#setReadBufferSize">QAbstractSocket::setReadBufferSize</a>(), <a href="qnetworkreply.html">QNetworkReply</a> cannot guarantee precision in the read buffer size. That is, <a href="qiodevice.html#bytesAvailable">bytesAvailable</a>() can return more than <i>size</i>.</p>
<p><b>See also </b><a href="qnetworkreply.html#readBufferSize">readBufferSize</a>().</p>
<!-- @@@setReadBufferSize -->
<!-- $$$setRequest[overload1]$$$setRequestconstQNetworkRequest& -->
<h3 class="fn"><a name="setRequest"></a><span class="type">void</span> QNetworkReply::<span class="name">setRequest</span> ( const <span class="type"><a href="qnetworkrequest.html">QNetworkRequest</a></span> & <i>request</i> )<tt> [protected]</tt></h3>
<p>Sets the associated request for this object to be <i>request</i>. This value will be returned by <a href="qnetworkreply.html#request">request</a>().</p>
<p>Note: the request should be set when this object is created and not changed again.</p>
<p><b>See also </b><a href="qnetworkreply.html#request">request</a>() and <a href="qnetworkreply.html#setOperation">setOperation</a>().</p>
<!-- @@@setRequest -->
<!-- $$$setSslConfiguration[overload1]$$$setSslConfigurationconstQSslConfiguration& -->
<h3 class="fn"><a name="setSslConfiguration"></a><span class="type">void</span> QNetworkReply::<span class="name">setSslConfiguration</span> ( const <span class="type"><a href="qsslconfiguration.html">QSslConfiguration</a></span> & <i>config</i> )</h3>
<p>Sets the SSL configuration for the network connection associated with this request, if possible, to be that of <i>config</i>.</p>
<p><b>See also </b><a href="qnetworkreply.html#sslConfiguration">sslConfiguration</a>().</p>
<!-- @@@setSslConfiguration -->
<!-- $$$setUrl[overload1]$$$setUrlconstQUrl& -->
<h3 class="fn"><a name="setUrl"></a><span class="type">void</span> QNetworkReply::<span class="name">setUrl</span> ( const <span class="type"><a href="qurl.html">QUrl</a></span> & <i>url</i> )<tt> [protected]</tt></h3>
<p>Sets the URL being processed to be <i>url</i>. Normally, the URL matches that of the request that was posted, but for a variety of reasons it can be different (for example, a file path being made absolute or canonical).</p>
<p><b>See also </b><a href="qnetworkreply.html#url">url</a>(), <a href="qnetworkreply.html#request">request</a>(), and <a href="qnetworkrequest.html#url">QNetworkRequest::url</a>().</p>
<!-- @@@setUrl -->
<!-- $$$sslConfiguration[overload1]$$$sslConfiguration -->
<h3 class="fn"><a name="sslConfiguration"></a><span class="type"><a href="qsslconfiguration.html">QSslConfiguration</a></span> QNetworkReply::<span class="name">sslConfiguration</span> () const</h3>
<p>Returns the SSL configuration and state associated with this reply, if SSL was used. It will contain the remote server's certificate, its certificate chain leading to the Certificate Authority as well as the encryption ciphers in use.</p>
<p>The peer's certificate and its certificate chain will be known by the time <a href="qnetworkreply.html#sslErrors">sslErrors</a>() is emitted, if it's emitted.</p>
<p><b>See also </b><a href="qnetworkreply.html#setSslConfiguration">setSslConfiguration</a>().</p>
<!-- @@@sslConfiguration -->
<!-- $$$sslErrors[overload1]$$$sslErrorsconstQList<QSslError>& -->
<h3 class="fn"><a name="sslErrors"></a><span class="type">void</span> QNetworkReply::<span class="name">sslErrors</span> ( const <span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qsslerror.html">QSslError</a></span>> & <i>errors</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted if the SSL/TLS session encountered errors during the set up, including certificate verification errors. The <i>errors</i> parameter contains the list of errors.</p>
<p>To indicate that the errors are not fatal and that the connection should proceed, the <a href="qnetworkreply.html#ignoreSslErrors">ignoreSslErrors</a>() function should be called from the slot connected to this signal. If it is not called, the SSL session will be torn down before any data is exchanged (including the URL).</p>
<p>This signal can be used to display an error message to the user indicating that security may be compromised and display the SSL settings (see <a href="qnetworkreply.html#sslConfiguration">sslConfiguration</a>() to obtain it). If the user decides to proceed after analyzing the remote certificate, the slot should call <a href="qnetworkreply.html#ignoreSslErrors">ignoreSslErrors</a>().</p>
<p><b>See also </b><a href="qsslsocket.html#sslErrors">QSslSocket::sslErrors</a>(), <a href="qnetworkaccessmanager.html#sslErrors">QNetworkAccessManager::sslErrors</a>(), <a href="qnetworkreply.html#sslConfiguration">sslConfiguration</a>(), and <a href="qnetworkreply.html#ignoreSslErrors">ignoreSslErrors</a>().</p>
<!-- @@@sslErrors -->
<!-- $$$uploadProgress[overload1]$$$uploadProgressqint64qint64 -->
<h3 class="fn"><a name="uploadProgress"></a><span class="type">void</span> QNetworkReply::<span class="name">uploadProgress</span> ( <span class="type"><a href="qtglobal.html#qint64-typedef">qint64</a></span> <i>bytesSent</i>, <span class="type"><a href="qtglobal.html#qint64-typedef">qint64</a></span> <i>bytesTotal</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted to indicate the progress of the upload part of this network request, if there's any. If there's no upload associated with this request, this signal will not be emitted.</p>
<p>The <i>bytesSent</i> parameter indicates the number of bytes uploaded, while <i>bytesTotal</i> indicates the total number of bytes to be uploaded. If the number of bytes to be uploaded could not be determined, <i>bytesTotal</i> will be -1.</p>
<p>The upload is finished when <i>bytesSent</i> is equal to <i>bytesTotal</i>. At that time, <i>bytesTotal</i> will not be -1.</p>
<p><b>See also </b><a href="qnetworkreply.html#downloadProgress">downloadProgress</a>().</p>
<!-- @@@uploadProgress -->
<!-- $$$url[overload1]$$$url -->
<h3 class="fn"><a name="url"></a><span class="type"><a href="qurl.html">QUrl</a></span> QNetworkReply::<span class="name">url</span> () const</h3>
<p>Returns the URL of the content downloaded or uploaded. Note that the URL may be different from that of the original request.</p>
<p><b>See also </b><a href="qnetworkreply.html#request">request</a>(), <a href="qnetworkreply.html#setUrl">setUrl</a>(), and <a href="qnetworkrequest.html#url">QNetworkRequest::url</a>().</p>
<!-- @@@url -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
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.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Digia, Qt and their respective logos are trademarks of Digia Plc
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
