← Back to branch summary

~ubuntu-branches/ubuntu/precise/python-qt4/precise-proposed

« back to all changes in this revision

Viewing changes to doc/html/qnetworkrequest.html

  • Committer: Bazaar Package Importer
  • Author(s): Jonathan Riddell, Jonathan Riddell
  • Date: 2010-11-08 16:13:33 UTC
  • mfrom: (1.5.5 upstream)
  • Revision ID: james.westby@ubuntu.com-20101108161333-0nec4wu0nz3wpf9r
Tags: 4.8.1-0ubuntu1
[ Jonathan Riddell ]
* New upstream release
* Build against python-sip-dev 4.11.2
* Remove kubuntu_02_fix-scpk-and-flag-issue.diff merged upstream
* Install __init__.py into /usr/lib/python3.2/dist-packages/PyQt4,
  fixes Python 3 support
* Add QtDeclarative to python-qt4
* Add kubuntu_03_uiparser.diff from upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/html/qnetworkrequest.html
6
6
td.postheader { font-family: sans-serif }
7
7
tr.address { font-family: sans-serif }
8
8
body { background: #ffffff; color: black; }
9
 
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">&#160;&#160;</td><td class="postheader" valign="center"><a href="../pyqt4ref.html"><font color="#004faf">Home</font></a>&#160;&#183; <a href="classes.html"><font color="#004faf">All Classes</font></a>&#160;&#183; <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QNetworkRequest Class Reference<br /><sup><sup>[<a href="qtnetwork.html">QtNetwork</a> module]</sup></sup></h1><p>The QNetworkRequest class holds a request to be sent with <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>. <a href="#details">More...</a></p>
10
 
<h3>Types</h3><ul><li><div class="fn" />enum <b><a href="qnetworkrequest.html#Attribute-enum">Attribute</a></b> { HttpStatusCodeAttribute, HttpReasonPhraseAttribute, RedirectionTargetAttribute, ConnectionEncryptedAttribute, ..., UserMax }</li><li><div class="fn" />enum <b><a href="qnetworkrequest.html#CacheLoadControl-enum">CacheLoadControl</a></b> { AlwaysNetwork, PreferNetwork, PreferCache, AlwaysCache }</li><li><div class="fn" />enum <b><a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a></b> { ContentTypeHeader, ContentLengthHeader, LocationHeader, LastModifiedHeader, CookieHeader, SetCookieHeader }</li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qnetworkrequest.html#QNetworkRequest">__init__</a></b> (<i>self</i>, QUrl&#160;<i>url</i>&#160;=&#160;QUrl())</li><li><div class="fn" /><b><a href="qnetworkrequest.html#QNetworkRequest-2">__init__</a></b> (<i>self</i>, QNetworkRequest)</li><li><div class="fn" />QVariant <b><a href="qnetworkrequest.html#attribute">attribute</a></b> (<i>self</i>, Attribute, QVariant&#160;<i>defaultValue</i>&#160;=&#160;QVariant())</li><li><div class="fn" />bool <b><a href="qnetworkrequest.html#hasRawHeader">hasRawHeader</a></b> (<i>self</i>, QByteArray)</li><li><div class="fn" />QVariant <b><a href="qnetworkrequest.html#header">header</a></b> (<i>self</i>, KnownHeaders)</li><li><div class="fn" />QObject <b><a href="qnetworkrequest.html#originatingObject">originatingObject</a></b> (<i>self</i>)</li><li><div class="fn" />QByteArray <b><a href="qnetworkrequest.html#rawHeader">rawHeader</a></b> (<i>self</i>, QByteArray)</li><li><div class="fn" />list-of-QByteArray <b><a href="qnetworkrequest.html#rawHeaderList">rawHeaderList</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setAttribute">setAttribute</a></b> (<i>self</i>, Attribute, QVariant)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setHeader">setHeader</a></b> (<i>self</i>, KnownHeaders, QVariant)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setOriginatingObject">setOriginatingObject</a></b> (<i>self</i>, QObject)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setRawHeader">setRawHeader</a></b> (<i>self</i>, QByteArray, QByteArray)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setSslConfiguration">setSslConfiguration</a></b> (<i>self</i>, QSslConfiguration)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setUrl">setUrl</a></b> (<i>self</i>, QUrl)</li><li><div class="fn" />QSslConfiguration <b><a href="qnetworkrequest.html#sslConfiguration">sslConfiguration</a></b> (<i>self</i>)</li><li><div class="fn" />QUrl <b><a href="qnetworkrequest.html#url">url</a></b> (<i>self</i>)</li></ul><h3>Special Methods</h3><ul><li><div class="fn" />bool <b><a href="qnetworkrequest.html#__eq__">__eq__</a></b> (<i>self</i>, QNetworkRequest)</li><li><div class="fn" />bool <b><a href="qnetworkrequest.html#__ne__">__ne__</a></b> (<i>self</i>, QNetworkRequest)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QNetworkRequest class holds a request to be sent with <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>.</p>
11
 
<p>QNetworkRequest is part of the Network Access API and is the class holding the information necessary to send a request over the network. It contains a URL and some ancillary information that can be used to modify the request.</p>
12
 
<p>See also <a href="qnetworkreply.html">QNetworkReply</a> and <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>.</p>
 
9
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">&#160;&#160;</td><td class="postheader" valign="center"><a href="../pyqt4ref.html"><font color="#004faf">Home</font></a>&#160;&#183; <a href="classes.html"><font color="#004faf">All Classes</font></a>&#160;&#183; <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QNetworkRequest Class Reference<br /><sup><sup>[<a href="qtnetwork.html">QtNetwork</a> module]</sup></sup></h1><p>The QNetworkRequest class holds a request to be sent with
 
10
<a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>.
 
11
<a href="#details">More...</a></p>
 
12
 
 
13
<h3>Types</h3><ul><li><div class="fn" />enum <b><a href="qnetworkrequest.html#Attribute-enum">Attribute</a></b> { HttpStatusCodeAttribute, HttpReasonPhraseAttribute, RedirectionTargetAttribute, ConnectionEncryptedAttribute, ..., UserMax }</li><li><div class="fn" />enum <b><a href="qnetworkrequest.html#CacheLoadControl-enum">CacheLoadControl</a></b> { AlwaysNetwork, PreferNetwork, PreferCache, AlwaysCache }</li><li><div class="fn" />enum <b><a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a></b> { ContentTypeHeader, ContentLengthHeader, LocationHeader, LastModifiedHeader, CookieHeader, SetCookieHeader }</li><li><div class="fn" />enum <b><a href="qnetworkrequest.html#LoadControl-enum">LoadControl</a></b> { Automatic, Manual }</li><li><div class="fn" />enum <b><a href="qnetworkrequest.html#Priority-enum">Priority</a></b> { HighPriority, NormalPriority, LowPriority }</li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qnetworkrequest.html#QNetworkRequest">__init__</a></b> (<i>self</i>, QUrl&#160;<i>url</i>&#160;=&#160;QUrl())</li><li><div class="fn" /><b><a href="qnetworkrequest.html#QNetworkRequest-2">__init__</a></b> (<i>self</i>, QNetworkRequest)</li><li><div class="fn" />QVariant <b><a href="qnetworkrequest.html#attribute">attribute</a></b> (<i>self</i>, Attribute, QVariant&#160;<i>defaultValue</i>&#160;=&#160;QVariant())</li><li><div class="fn" />bool <b><a href="qnetworkrequest.html#hasRawHeader">hasRawHeader</a></b> (<i>self</i>, QByteArray)</li><li><div class="fn" />QVariant <b><a href="qnetworkrequest.html#header">header</a></b> (<i>self</i>, KnownHeaders)</li><li><div class="fn" />QObject <b><a href="qnetworkrequest.html#originatingObject">originatingObject</a></b> (<i>self</i>)</li><li><div class="fn" />Priority <b><a href="qnetworkrequest.html#priority">priority</a></b> (<i>self</i>)</li><li><div class="fn" />QByteArray <b><a href="qnetworkrequest.html#rawHeader">rawHeader</a></b> (<i>self</i>, QByteArray)</li><li><div class="fn" />list-of-QByteArray <b><a href="qnetworkrequest.html#rawHeaderList">rawHeaderList</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setAttribute">setAttribute</a></b> (<i>self</i>, Attribute, QVariant)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setHeader">setHeader</a></b> (<i>self</i>, KnownHeaders, QVariant)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setOriginatingObject">setOriginatingObject</a></b> (<i>self</i>, QObject)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setPriority">setPriority</a></b> (<i>self</i>, Priority&#160;<i>priority</i>)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setRawHeader">setRawHeader</a></b> (<i>self</i>, QByteArray, QByteArray)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setSslConfiguration">setSslConfiguration</a></b> (<i>self</i>, QSslConfiguration)</li><li><div class="fn" /><b><a href="qnetworkrequest.html#setUrl">setUrl</a></b> (<i>self</i>, QUrl)</li><li><div class="fn" />QSslConfiguration <b><a href="qnetworkrequest.html#sslConfiguration">sslConfiguration</a></b> (<i>self</i>)</li><li><div class="fn" />QUrl <b><a href="qnetworkrequest.html#url">url</a></b> (<i>self</i>)</li></ul><h3>Special Methods</h3><ul><li><div class="fn" />bool <b><a href="qnetworkrequest.html#__eq__">__eq__</a></b> (<i>self</i>, QNetworkRequest)</li><li><div class="fn" />bool <b><a href="qnetworkrequest.html#__ne__">__ne__</a></b> (<i>self</i>, QNetworkRequest)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QNetworkRequest class holds a request to be sent with
 
14
<a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>.</p>
 
15
<p>QNetworkRequest is part of the Network Access API and is the
 
16
class holding the information necessary to send a request over the
 
17
network. It contains a URL and some ancillary information that can
 
18
be used to modify the request.</p>
13
19
<hr /><h2>Type Documentation</h2><h3 class="fn"><a name="Attribute-enum" />QNetworkRequest.Attribute</h3><p>Attribute codes for the <a href="qnetworkrequest.html">QNetworkRequest</a> and <a href="qnetworkreply.html">QNetworkReply</a>.</p>
14
 
<p>Attributes are extra meta-data that are used to control the behavior of the request and to pass further information from the reply back to the application. Attributes are also extensible, allowing custom implementations to pass custom values.</p>
15
 
<p>The following table explains what the default attribute codes are, the <a href="qvariant.html">QVariant</a> types associated, the default value if said attribute is missing and whether it's used in requests or replies.</p>
16
 
<p><table border="1" cellpadding="2" cellspacing="1" class="valuelist" width="100%">
17
 
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
18
 
<tr><td valign="top"><tt>QNetworkRequest.HttpStatusCodeAttribute</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.Int</a> (no default) Indicates the HTTP status code received from the HTTP server (like 200, 304, 404, 401, etc.). If the connection was not HTTP-based, this attribute will not be present.</td></tr>
19
 
<tr><td valign="top"><tt>QNetworkRequest.HttpReasonPhraseAttribute</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.ByteArray</a> (no default) Indicates the HTTP reason phrase as received from the HTTP server (like "Ok", "Found", "Not Found", "Access Denied", etc.) This is the human-readable representation of the status code (see above). If the connection was not HTTP-based, this attribute will not be present.</td></tr>
20
 
<tr><td valign="top"><tt>QNetworkRequest.RedirectionTargetAttribute</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.Url</a> (no default) If present, it indicates that the server is redirecting the request to a different URL. The Network Access API does not by default follow redirections: it's up to the application to determine if the requested redirection should be allowed, according to its security policies. The returned URL might be relative. Use <a href="qurl.html#resolved">QUrl.resolved</a>() to create an absolute URL out of it.</td></tr>
21
 
<tr><td valign="top"><tt>QNetworkRequest.ConnectionEncryptedAttribute</tt></td><td align="center" valign="top"><tt>3</tt></td><td valign="top">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> (default: false) Indicates whether the data was obtained through an encrypted (secure) connection.</td></tr>
22
 
<tr><td valign="top"><tt>QNetworkRequest.CacheLoadControlAttribute</tt></td><td align="center" valign="top"><tt>4</tt></td><td valign="top">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Int</a> (default: <a href="qnetworkrequest.html#CacheLoadControl-enum">QNetworkRequest.PreferNetwork</a>) Controls how the cache should be accessed. The possible values are those of <a href="qnetworkrequest.html#CacheLoadControl-enum">QNetworkRequest.CacheLoadControl</a>. Note that the default <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> implementation does not support caching. However, this attribute may be used by certain backends to modify their requests (for example, for caching proxies).</td></tr>
23
 
<tr><td valign="top"><tt>QNetworkRequest.CacheSaveControlAttribute</tt></td><td align="center" valign="top"><tt>5</tt></td><td valign="top">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> (default: true) Controls if the data obtained should be saved to cache for future uses. If the value is false, the data obtained will not be automatically cached. If true, data may be cached, provided it is cacheable (what is cacheable depends on the protocol being used).</td></tr>
24
 
<tr><td valign="top"><tt>QNetworkRequest.SourceIsFromCacheAttribute</tt></td><td align="center" valign="top"><tt>6</tt></td><td valign="top">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> (default: false) Indicates whether the data was obtained from cache or not.</td></tr>
25
 
<tr><td valign="top"><tt>QNetworkRequest.DoNotBufferUploadDataAttribute</tt></td><td align="center" valign="top"><tt>7</tt></td><td valign="top">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> (default: false) Indicates whether the <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> code is allowed to buffer the upload data, e.g. when doing a HTTP POST. When using this flag with sequential upload data, the <a href="qnetworkrequest.html#KnownHeaders-enum">ContentLengthHeader</a> header must be set.</td></tr>
26
 
<tr><td valign="top"><tt>QNetworkRequest.HttpPipeliningAllowedAttribute</tt></td><td align="center" valign="top"><tt>8</tt></td><td valign="top">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> (default: false) Indicates whether the <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> code is allowed to use HTTP pipelining with this request.</td></tr>
27
 
<tr><td valign="top"><tt>QNetworkRequest.HttpPipeliningWasUsedAttribute</tt></td><td align="center" valign="top"><tt>9</tt></td><td valign="top">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> Indicates whether the HTTP pipelining was used for receiving this reply.</td></tr>
28
 
<tr><td valign="top"><tt>QNetworkRequest.User</tt></td><td align="center" valign="top"><tt>1000</tt></td><td valign="top">Special type. Additional information can be passed in QVariants with types ranging from User to UserMax. The default implementation of Network Access will ignore any request attributes in this range and it will not produce any attributes in this range in replies. The range is reserved for extensions of <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>.</td></tr>
29
 
<tr><td valign="top"><tt>QNetworkRequest.UserMax</tt></td><td align="center" valign="top"><tt>32767</tt></td><td valign="top">Special type. See User.</td></tr>
30
 
</table></p>
31
 
<a name="//apple_ref/cpp/tag/QNetworkRequest/CacheLoadControl" />
32
 
<a name="//apple_ref/cpp/econst/QNetworkRequest/AlwaysNetwork" />
33
 
<a name="//apple_ref/cpp/econst/QNetworkRequest/PreferNetwork" />
34
 
<a name="//apple_ref/cpp/econst/QNetworkRequest/PreferCache" />
35
 
<a name="//apple_ref/cpp/econst/QNetworkRequest/AlwaysCache" />
 
20
<p>Attributes are extra meta-data that are used to control the
 
21
behavior of the request and to pass further information from the
 
22
reply back to the application. Attributes are also extensible,
 
23
allowing custom implementations to pass custom values.</p>
 
24
<p>The following table explains what the default attribute codes
 
25
are, the <a href="qvariant.html">QVariant</a> types associated, the
 
26
default value if said attribute is missing and whether it's used in
 
27
requests or replies.</p>
 
28
<table class="valuelist">
 
29
<tr class="odd">
 
30
<td />
 
31
</tr>
 
32
<tr>
 
33
<th class="tblConst">Constant</th>
 
34
<th class="tblval">Value</th>
 
35
<th class="tbldscr">Description</th>
 
36
</tr>
 
37
<tr>
 
38
<td class="topAlign">
 
39
<tt>QNetworkRequest.HttpStatusCodeAttribute</tt></td>
 
40
<td class=" topAlign"><tt>0</tt></td>
 
41
<td class="topAlign">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.Int</a> (no default) Indicates
 
42
the HTTP status code received from the HTTP server (like 200, 304,
 
43
404, 401, etc.). If the connection was not HTTP-based, this
 
44
attribute will not be present.</td>
 
45
</tr>
 
46
<tr>
 
47
<td class="topAlign">
 
48
<tt>QNetworkRequest.HttpReasonPhraseAttribute</tt></td>
 
49
<td class=" topAlign"><tt>1</tt></td>
 
50
<td class="topAlign">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.ByteArray</a> (no default)
 
51
Indicates the HTTP reason phrase as received from the HTTP server
 
52
(like "Ok", "Found", "Not Found", "Access Denied", etc.) This is
 
53
the human-readable representation of the status code (see above).
 
54
If the connection was not HTTP-based, this attribute will not be
 
55
present.</td>
 
56
</tr>
 
57
<tr>
 
58
<td class="topAlign">
 
59
<tt>QNetworkRequest.RedirectionTargetAttribute</tt></td>
 
60
<td class=" topAlign"><tt>2</tt></td>
 
61
<td class="topAlign">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.Url</a> (no default) If
 
62
present, it indicates that the server is redirecting the request to
 
63
a different URL. The Network Access API does not by default follow
 
64
redirections: it's up to the application to determine if the
 
65
requested redirection should be allowed, according to its security
 
66
policies. The returned URL might be relative. Use <a href="qurl.html#resolved">QUrl.resolved</a>() to create an absolute URL
 
67
out of it.</td>
 
68
</tr>
 
69
<tr>
 
70
<td class="topAlign">
 
71
<tt>QNetworkRequest.ConnectionEncryptedAttribute</tt></td>
 
72
<td class=" topAlign"><tt>3</tt></td>
 
73
<td class="topAlign">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> (default: false)
 
74
Indicates whether the data was obtained through an encrypted
 
75
(secure) connection.</td>
 
76
</tr>
 
77
<tr>
 
78
<td class="topAlign">
 
79
<tt>QNetworkRequest.CacheLoadControlAttribute</tt></td>
 
80
<td class=" topAlign"><tt>4</tt></td>
 
81
<td class="topAlign">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Int</a> (default: <a href="qnetworkrequest.html#CacheLoadControl-enum">QNetworkRequest.PreferNetwork</a>)
 
82
Controls how the cache should be accessed. The possible values are
 
83
those of <a href="qnetworkrequest.html#CacheLoadControl-enum">QNetworkRequest.CacheLoadControl</a>.
 
84
Note that the default <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>
 
85
implementation does not support caching. However, this attribute
 
86
may be used by certain backends to modify their requests (for
 
87
example, for caching proxies).</td>
 
88
</tr>
 
89
<tr>
 
90
<td class="topAlign">
 
91
<tt>QNetworkRequest.CacheSaveControlAttribute</tt></td>
 
92
<td class=" topAlign"><tt>5</tt></td>
 
93
<td class="topAlign">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> (default: true)
 
94
Controls if the data obtained should be saved to cache for future
 
95
uses. If the value is false, the data obtained will not be
 
96
automatically cached. If true, data may be cached, provided it is
 
97
cacheable (what is cacheable depends on the protocol being
 
98
used).</td>
 
99
</tr>
 
100
<tr>
 
101
<td class="topAlign">
 
102
<tt>QNetworkRequest.SourceIsFromCacheAttribute</tt></td>
 
103
<td class=" topAlign"><tt>6</tt></td>
 
104
<td class="topAlign">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> (default: false)
 
105
Indicates whether the data was obtained from cache or not.</td>
 
106
</tr>
 
107
<tr>
 
108
<td class="topAlign">
 
109
<tt>QNetworkRequest.DoNotBufferUploadDataAttribute</tt></td>
 
110
<td class=" topAlign"><tt>7</tt></td>
 
111
<td class="topAlign">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> (default: false)
 
112
Indicates whether the <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> code is
 
113
allowed to buffer the upload data, e.g. when doing a HTTP POST.
 
114
When using this flag with sequential upload data, the <a href="qnetworkrequest.html#KnownHeaders-enum">ContentLengthHeader</a>
 
115
header must be set.</td>
 
116
</tr>
 
117
<tr>
 
118
<td class="topAlign">
 
119
<tt>QNetworkRequest.HttpPipeliningAllowedAttribute</tt></td>
 
120
<td class=" topAlign"><tt>8</tt></td>
 
121
<td class="topAlign">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> (default: false)
 
122
Indicates whether the <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> code is
 
123
allowed to use HTTP pipelining with this request.</td>
 
124
</tr>
 
125
<tr>
 
126
<td class="topAlign">
 
127
<tt>QNetworkRequest.HttpPipeliningWasUsedAttribute</tt></td>
 
128
<td class=" topAlign"><tt>9</tt></td>
 
129
<td class="topAlign">Replies only, type: <a href="qvariant.html#Type-enum">QVariant.Bool</a> Indicates whether the
 
130
HTTP pipelining was used for receiving this reply.</td>
 
131
</tr>
 
132
<tr>
 
133
<td class="topAlign">
 
134
<tt>QNetworkRequest.CustomVerbAttribute</tt></td>
 
135
<td class=" topAlign"><tt>10</tt></td>
 
136
<td class="topAlign">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.ByteArray</a> Holds the value
 
137
for the custom HTTP verb to send (destined for usage of other verbs
 
138
than GET, POST, PUT and DELETE). This verb is set when calling
 
139
<a href="qnetworkaccessmanager.html#sendCustomRequest">QNetworkAccessManager.sendCustomRequest</a>().</td>
 
140
</tr>
 
141
<tr>
 
142
<td class="topAlign">
 
143
<tt>QNetworkRequest.CookieLoadControlAttribute</tt></td>
 
144
<td class=" topAlign"><tt>11</tt></td>
 
145
<td class="topAlign">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Int</a> (default: <a href="qnetworkrequest.html#LoadControl-enum">QNetworkRequest.Automatic</a>)
 
146
Indicates whether to send 'Cookie' headers in the request.</td>
 
147
</tr>
 
148
</table>
 
149
<p>This attribute is set to false by <a href="qtwebkit.html">QtWebKit</a> when creating a cross-origin <a href="qdeclarativeglobalobject.html#xmlhttprequest">XMLHttpRequest</a>
 
150
where withCredentials has not been set explicitly to true by the
 
151
Javascript that created the request.</p>
 
152
<p>See http://www.w3.org/TR/XMLHttpRequest2/#credentials-flag for
 
153
more information.</p>
 
154
<p>(This value was introduced in 4.7.)</p>
 
155
<table class="valuelist">
 
156
<tr class="even">
 
157
<td />
 
158
</tr>
 
159
<tr>
 
160
<th class="tblConst">Constant</th>
 
161
<th class="tblval">Value</th>
 
162
<th class="tbldscr">Description</th>
 
163
</tr>
 
164
<tr>
 
165
<td class="topAlign">
 
166
<tt>QNetworkRequest.CookieSaveControlAttribute</tt></td>
 
167
<td class=" topAlign"><tt>13</tt></td>
 
168
<td class="topAlign">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Int</a> (default: <a href="qnetworkrequest.html#LoadControl-enum">QNetworkRequest.Automatic</a>)
 
169
Indicates whether to save 'Cookie' headers received from the server
 
170
in reply to the request.</td>
 
171
</tr>
 
172
</table>
 
173
<p>This attribute is set to false by <a href="qtwebkit.html">QtWebKit</a> when creating a cross-origin <a href="qdeclarativeglobalobject.html#xmlhttprequest">XMLHttpRequest</a>
 
174
where withCredentials has not been set explicitly to true by the
 
175
Javascript that created the request.</p>
 
176
<p>See http://www.w3.org/TR/XMLHttpRequest2/#credentials-flag for
 
177
more information.</p>
 
178
<p>(This value was introduced in 4.7.)</p>
 
179
<table class="valuelist">
 
180
<tr class="odd">
 
181
<td />
 
182
</tr>
 
183
<tr>
 
184
<th class="tblConst">Constant</th>
 
185
<th class="tblval">Value</th>
 
186
<th class="tbldscr">Description</th>
 
187
</tr>
 
188
<tr>
 
189
<td class="topAlign">
 
190
<tt>QNetworkRequest.AuthenticationReuseAttribute</tt></td>
 
191
<td class=" topAlign"><tt>12</tt></td>
 
192
<td class="topAlign">Requests only, type: <a href="qvariant.html#Type-enum">QVariant.Int</a> (default: <a href="qnetworkrequest.html#LoadControl-enum">QNetworkRequest.Automatic</a>)
 
193
Indicates whether to use cached authorization credentials in the
 
194
request, if available. If this is set to <a href="qnetworkrequest.html#LoadControl-enum">QNetworkRequest.Manual</a>
 
195
and the authentication mechanism is 'Basic' or 'Digest', Qt will
 
196
not send an an 'Authorization' HTTP header with any cached
 
197
credentials it may have for the request's URL.</td>
 
198
</tr>
 
199
</table>
 
200
<p>This attribute is set to <a href="qnetworkrequest.html#LoadControl-enum">QNetworkRequest.Manual</a>
 
201
by <a href="qtwebkit.html">QtWebKit</a> when creating a
 
202
cross-origin <a href="qdeclarativeglobalobject.html#xmlhttprequest">XMLHttpRequest</a>
 
203
where withCredentials has not been set explicitly to true by the
 
204
Javascript that created the request.</p>
 
205
<p>See http://www.w3.org/TR/XMLHttpRequest2/#credentials-flag for
 
206
more information.</p>
 
207
<p>(This value was introduced in 4.7.)</p>
 
208
<p>(This value was introduced in 4.7.)</p>
 
209
<p>(This value was introduced in 4.7.)</p>
 
210
<table class="valuelist">
 
211
<tr class="even">
 
212
<td />
 
213
</tr>
 
214
<tr>
 
215
<th class="tblConst">Constant</th>
 
216
<th class="tblval">Value</th>
 
217
<th class="tbldscr">Description</th>
 
218
</tr>
 
219
<tr>
 
220
<td class="topAlign"><tt>QNetworkRequest.User</tt></td>
 
221
<td class=" topAlign"><tt>1000</tt></td>
 
222
<td class="topAlign">Special type. Additional information can be
 
223
passed in <a href="qtwebkit-bridge.html#qvariants">QVariants</a>
 
224
with types ranging from User to UserMax. The default implementation
 
225
of Network Access will ignore any request attributes in this range
 
226
and it will not produce any attributes in this range in replies.
 
227
The range is reserved for extensions of <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>.</td>
 
228
</tr>
 
229
<tr>
 
230
<td class="topAlign"><tt>QNetworkRequest.UserMax</tt></td>
 
231
<td class=" topAlign"><tt>32767</tt></td>
 
232
<td class="topAlign">Special type. See User.</td>
 
233
</tr>
 
234
</table>
 
235
 
 
236
 
36
237
<h3 class="fn"><a name="CacheLoadControl-enum" />QNetworkRequest.CacheLoadControl</h3><p>Controls the caching mechanism of <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>.</p>
37
 
<p><table border="1" cellpadding="2" cellspacing="1" class="valuelist" width="100%">
38
 
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
39
 
<tr><td valign="top"><tt>QNetworkRequest.AlwaysNetwork</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">always load from network and do not check if the cache has a valid entry (similar to the "Reload" feature in browsers)</td></tr>
40
 
<tr><td valign="top"><tt>QNetworkRequest.PreferNetwork</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">default value; load from the network if the cached entry is older than the network entry</td></tr>
41
 
<tr><td valign="top"><tt>QNetworkRequest.PreferCache</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">load from cache if available, otherwise load from network. Note that this can return possibly stale (but not expired) items from cache.</td></tr>
42
 
<tr><td valign="top"><tt>QNetworkRequest.AlwaysCache</tt></td><td align="center" valign="top"><tt>3</tt></td><td valign="top">only load from cache, indicating error if the item was not cached (i.e., off-line mode)</td></tr>
43
 
</table></p>
44
 
<a name="//apple_ref/cpp/tag/QNetworkRequest/KnownHeaders" />
45
 
<a name="//apple_ref/cpp/econst/QNetworkRequest/ContentTypeHeader" />
46
 
<a name="//apple_ref/cpp/econst/QNetworkRequest/ContentLengthHeader" />
47
 
<a name="//apple_ref/cpp/econst/QNetworkRequest/LocationHeader" />
48
 
<a name="//apple_ref/cpp/econst/QNetworkRequest/LastModifiedHeader" />
49
 
<a name="//apple_ref/cpp/econst/QNetworkRequest/CookieHeader" />
50
 
<a name="//apple_ref/cpp/econst/QNetworkRequest/SetCookieHeader" />
51
 
<h3 class="fn"><a name="KnownHeaders-enum" />QNetworkRequest.KnownHeaders</h3><p>List of known header types that <a href="qnetworkrequest.html">QNetworkRequest</a> parses. Each known header is also represented in raw form with its full HTTP name.</p>
52
 
<p><table border="1" cellpadding="2" cellspacing="1" class="valuelist" width="100%">
53
 
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
54
 
<tr><td valign="top"><tt>QNetworkRequest.ContentTypeHeader</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">corresponds to the HTTP Content-Type header and contains a string containing the media (MIME) type and any auxiliary data (for instance, charset)</td></tr>
55
 
<tr><td valign="top"><tt>QNetworkRequest.ContentLengthHeader</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">corresponds to the HTTP Content-Length header and contains the length in bytes of the data transmitted.</td></tr>
56
 
<tr><td valign="top"><tt>QNetworkRequest.LocationHeader</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">corresponds to the HTTP Location header and contains a URL representing the actual location of the data, including the destination URL in case of redirections.</td></tr>
57
 
<tr><td valign="top"><tt>QNetworkRequest.LastModifiedHeader</tt></td><td align="center" valign="top"><tt>3</tt></td><td valign="top">corresponds to the HTTP Last-Modified header and contains a <a href="qdatetime.html">QDateTime</a> representing the last modification date of the contents</td></tr>
58
 
<tr><td valign="top"><tt>QNetworkRequest.CookieHeader</tt></td><td align="center" valign="top"><tt>4</tt></td><td valign="top">corresponds to the HTTP Cookie header and contains a <a href="qlist.html">QList</a>&lt;<a href="qnetworkcookie.html">QNetworkCookie</a>&gt; representing the cookies to be sent back to the server</td></tr>
59
 
<tr><td valign="top"><tt>QNetworkRequest.SetCookieHeader</tt></td><td align="center" valign="top"><tt>5</tt></td><td valign="top">corresponds to the HTTP Set-Cookie header and contains a <a href="qlist.html">QList</a>&lt;<a href="qnetworkcookie.html">QNetworkCookie</a>&gt; representing the cookies sent by the server to be stored locally</td></tr>
60
 
</table></p>
61
 
<p>See also <a href="qnetworkrequest.html#header">header</a>(), <a href="qnetworkrequest.html#setHeader">setHeader</a>(), <a href="qnetworkrequest.html#rawHeader">rawHeader</a>(), and <a href="qnetworkrequest.html#setRawHeader">setRawHeader</a>().</p>
62
 
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QNetworkRequest" />QNetworkRequest.__init__ (<i>self</i>, <a href="qurl.html">QUrl</a>&#160;<i>url</i>&#160;=&#160;QUrl())</h3><p>Constructs a <a href="qnetworkrequest.html">QNetworkRequest</a> object with <i>url</i> as the URL to be requested.</p>
63
 
<p>See also <a href="qnetworkrequest.html#url">url</a>() and <a href="qnetworkrequest.html#setUrl">setUrl</a>().</p>
 
238
<table class="valuelist">
 
239
<tr class="odd">
 
240
<td />
 
241
</tr>
 
242
<tr>
 
243
<th class="tblConst">Constant</th>
 
244
<th class="tblval">Value</th>
 
245
<th class="tbldscr">Description</th>
 
246
</tr>
 
247
<tr>
 
248
<td class="topAlign"><tt>QNetworkRequest.AlwaysNetwork</tt></td>
 
249
<td class=" topAlign"><tt>0</tt></td>
 
250
<td class="topAlign">always load from network and do not check if
 
251
the cache has a valid entry (similar to the "Reload" feature in
 
252
browsers)</td>
 
253
</tr>
 
254
<tr>
 
255
<td class="topAlign"><tt>QNetworkRequest.PreferNetwork</tt></td>
 
256
<td class=" topAlign"><tt>1</tt></td>
 
257
<td class="topAlign">default value; load from the network if the
 
258
cached entry is older than the network entry</td>
 
259
</tr>
 
260
<tr>
 
261
<td class="topAlign"><tt>QNetworkRequest.PreferCache</tt></td>
 
262
<td class=" topAlign"><tt>2</tt></td>
 
263
<td class="topAlign">load from cache if available, otherwise load
 
264
from network. Note that this can return possibly stale (but not
 
265
expired) items from cache.</td>
 
266
</tr>
 
267
<tr>
 
268
<td class="topAlign"><tt>QNetworkRequest.AlwaysCache</tt></td>
 
269
<td class=" topAlign"><tt>3</tt></td>
 
270
<td class="topAlign">only load from cache, indicating error if the
 
271
item was not cached (i.e., off-line mode)</td>
 
272
</tr>
 
273
</table>
 
274
 
 
275
 
 
276
<h3 class="fn"><a name="KnownHeaders-enum" />QNetworkRequest.KnownHeaders</h3><p>List of known header types that <a href="qnetworkrequest.html">QNetworkRequest</a> parses. Each known
 
277
header is also represented in raw form with its full HTTP name.</p>
 
278
<table class="valuelist">
 
279
<tr class="odd">
 
280
<td />
 
281
</tr>
 
282
<tr>
 
283
<th class="tblConst">Constant</th>
 
284
<th class="tblval">Value</th>
 
285
<th class="tbldscr">Description</th>
 
286
</tr>
 
287
<tr>
 
288
<td class="topAlign">
 
289
<tt>QNetworkRequest.ContentTypeHeader</tt></td>
 
290
<td class=" topAlign"><tt>0</tt></td>
 
291
<td class="topAlign">corresponds to the HTTP Content-Type header
 
292
and contains a string containing the media (MIME) type and any
 
293
auxiliary data (for instance, charset)</td>
 
294
</tr>
 
295
<tr>
 
296
<td class="topAlign">
 
297
<tt>QNetworkRequest.ContentLengthHeader</tt></td>
 
298
<td class=" topAlign"><tt>1</tt></td>
 
299
<td class="topAlign">corresponds to the HTTP Content-Length header
 
300
and contains the length in bytes of the data transmitted.</td>
 
301
</tr>
 
302
<tr>
 
303
<td class="topAlign"><tt>QNetworkRequest.LocationHeader</tt></td>
 
304
<td class=" topAlign"><tt>2</tt></td>
 
305
<td class="topAlign">corresponds to the HTTP Location header and
 
306
contains a URL representing the actual location of the data,
 
307
including the destination URL in case of redirections.</td>
 
308
</tr>
 
309
<tr>
 
310
<td class="topAlign">
 
311
<tt>QNetworkRequest.LastModifiedHeader</tt></td>
 
312
<td class=" topAlign"><tt>3</tt></td>
 
313
<td class="topAlign">corresponds to the HTTP Last-Modified header
 
314
and contains a <a href="qdatetime.html">QDateTime</a> representing
 
315
the last modification date of the contents</td>
 
316
</tr>
 
317
<tr>
 
318
<td class="topAlign"><tt>QNetworkRequest.CookieHeader</tt></td>
 
319
<td class=" topAlign"><tt>4</tt></td>
 
320
<td class="topAlign">corresponds to the HTTP Cookie header and
 
321
contains a <a href="qlist.html">QList</a>&lt;<a href="qnetworkcookie.html">QNetworkCookie</a>&gt; representing the
 
322
cookies to be sent back to the server</td>
 
323
</tr>
 
324
<tr>
 
325
<td class="topAlign"><tt>QNetworkRequest.SetCookieHeader</tt></td>
 
326
<td class=" topAlign"><tt>5</tt></td>
 
327
<td class="topAlign">corresponds to the HTTP Set-Cookie header and
 
328
contains a <a href="qlist.html">QList</a>&lt;<a href="qnetworkcookie.html">QNetworkCookie</a>&gt; representing the
 
329
cookies sent by the server to be stored locally</td>
 
330
</tr>
 
331
</table>
 
332
<p>See also <a href="qnetworkrequest.html#header">header</a>(),
 
333
<a href="qnetworkrequest.html#setHeader">setHeader</a>(), <a href="qnetworkrequest.html#rawHeader">rawHeader</a>(), and <a href="qnetworkrequest.html#setRawHeader">setRawHeader</a>().</p>
 
334
 
 
335
 
 
336
<h3 class="fn"><a name="LoadControl-enum" />QNetworkRequest.LoadControl</h3><p>Indicates if an aspect of the request's loading mechanism has
 
337
been manually overridden, e.g. by <a href="qtwebkit.html">QtWebKit</a>.</p>
 
338
<table class="valuelist">
 
339
<tr class="odd">
 
340
<td />
 
341
</tr>
 
342
<tr>
 
343
<th class="tblConst">Constant</th>
 
344
<th class="tblval">Value</th>
 
345
<th class="tbldscr">Description</th>
 
346
</tr>
 
347
<tr>
 
348
<td class="topAlign"><tt>QNetworkRequest.Automatic</tt></td>
 
349
<td class=" topAlign"><tt>0</tt></td>
 
350
<td class="topAlign">default value: indicates default
 
351
behaviour.</td>
 
352
</tr>
 
353
<tr>
 
354
<td class="topAlign"><tt>QNetworkRequest.Manual</tt></td>
 
355
<td class=" topAlign"><tt>1</tt></td>
 
356
<td class="topAlign">indicates behaviour has been manually
 
357
overridden.</td>
 
358
</tr>
 
359
</table>
 
360
<p>This enum was introduced in Qt 4.7.</p>
 
361
 
 
362
 
 
363
<h3 class="fn"><a name="Priority-enum" />QNetworkRequest.Priority</h3><p>This enum lists the possible network request priorities.</p>
 
364
<table class="valuelist">
 
365
<tr class="odd">
 
366
<td />
 
367
</tr>
 
368
<tr>
 
369
<th class="tblConst">Constant</th>
 
370
<th class="tblval">Value</th>
 
371
<th class="tbldscr">Description</th>
 
372
</tr>
 
373
<tr>
 
374
<td class="topAlign"><tt>QNetworkRequest.HighPriority</tt></td>
 
375
<td class=" topAlign"><tt>1</tt></td>
 
376
<td class="topAlign">High priority</td>
 
377
</tr>
 
378
<tr>
 
379
<td class="topAlign"><tt>QNetworkRequest.NormalPriority</tt></td>
 
380
<td class=" topAlign"><tt>3</tt></td>
 
381
<td class="topAlign">Normal priority</td>
 
382
</tr>
 
383
<tr>
 
384
<td class="topAlign"><tt>QNetworkRequest.LowPriority</tt></td>
 
385
<td class=" topAlign"><tt>5</tt></td>
 
386
<td class="topAlign">Low priority</td>
 
387
</tr>
 
388
</table>
 
389
<p>This enum was introduced in Qt 4.7.</p>
 
390
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QNetworkRequest" />QNetworkRequest.__init__ (<i>self</i>, <a href="qurl.html">QUrl</a>&#160;<i>url</i>&#160;=&#160;QUrl())</h3><p>Constructs a <a href="qnetworkrequest.html">QNetworkRequest</a>
 
391
object with <i>url</i> as the URL to be requested.</p>
 
392
<p>See also <a href="qnetworkrequest.html#url">url</a>() and
 
393
<a href="qnetworkrequest.html#setUrl">setUrl</a>().</p>
 
394
 
 
395
 
64
396
<h3 class="fn"><a name="QNetworkRequest-2" />QNetworkRequest.__init__ (<i>self</i>, <a href="qnetworkrequest.html">QNetworkRequest</a>)</h3><p>Creates a copy of <i>other</i>.</p>
65
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/~QNetworkRequest" />
66
 
<h3 class="fn"><a name="attribute" />QVariant QNetworkRequest.attribute (<i>self</i>, <a href="qnetworkrequest.html#Attribute-enum">Attribute</a>, QVariant&#160;<i>defaultValue</i>&#160;=&#160;QVariant())</h3><p>Returns the attribute associated with the code <i>code</i>. If the attribute has not been set, it returns <i>defaultValue</i>.</p>
67
 
<p>Note: this function does not apply the defaults listed in <a href="qnetworkrequest.html#Attribute-enum">QNetworkRequest.Attribute</a>.</p>
 
397
 
 
398
 
 
399
<h3 class="fn"><a name="attribute" />QVariant QNetworkRequest.attribute (<i>self</i>, <a href="qnetworkrequest.html#Attribute-enum">Attribute</a>, QVariant&#160;<i>defaultValue</i>&#160;=&#160;QVariant())</h3><p>Returns the attribute associated with the code <i>code</i>. If
 
400
the attribute has not been set, it returns <i>defaultValue</i>.</p>
 
401
<p>Note: this function does not apply the defaults listed in
 
402
<a href="qnetworkrequest.html#Attribute-enum">QNetworkRequest.Attribute</a>.</p>
68
403
<p>See also <a href="qnetworkrequest.html#setAttribute">setAttribute</a>() and <a href="qnetworkrequest.html#Attribute-enum">QNetworkRequest.Attribute</a>.</p>
69
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/hasRawHeader" />
70
 
<h3 class="fn"><a name="hasRawHeader" />bool QNetworkRequest.hasRawHeader (<i>self</i>, <a href="qbytearray.html">QByteArray</a>)</h3><p>Returns true if the raw header <i>headerName</i> is present in this network request.</p>
 
404
 
 
405
 
 
406
<h3 class="fn"><a name="hasRawHeader" />bool QNetworkRequest.hasRawHeader (<i>self</i>, <a href="qbytearray.html">QByteArray</a>)</h3><p>Returns true if the raw header <i>headerName</i> is present in
 
407
this network request.</p>
71
408
<p>See also <a href="qnetworkrequest.html#rawHeader">rawHeader</a>() and <a href="qnetworkrequest.html#setRawHeader">setRawHeader</a>().</p>
72
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/header" />
73
 
<h3 class="fn"><a name="header" />QVariant QNetworkRequest.header (<i>self</i>, <a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a>)</h3><p>Returns the value of the known network header <i>header</i> if it is present in this request. If it is not present, returns QVariant() (i.e., an invalid variant).</p>
 
409
 
 
410
 
 
411
<h3 class="fn"><a name="header" />QVariant QNetworkRequest.header (<i>self</i>, <a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a>)</h3><p>Returns the value of the known network header <i>header</i> if
 
412
it is present in this request. If it is not present, returns
 
413
QVariant() (i.e., an invalid variant).</p>
74
414
<p>See also <a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a>, <a href="qnetworkrequest.html#rawHeader">rawHeader</a>(), and <a href="qnetworkrequest.html#setHeader">setHeader</a>().</p>
75
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/originatingObject" />
76
 
<h3 class="fn"><a name="originatingObject" /><a href="qobject.html">QObject</a> QNetworkRequest.originatingObject (<i>self</i>)</h3><p>Returns a reference to the object that initiated this network request; returns 0 if not set or the object has been destroyed.</p>
 
415
 
 
416
 
 
417
<h3 class="fn"><a name="originatingObject" /><a href="qobject.html">QObject</a> QNetworkRequest.originatingObject (<i>self</i>)</h3><p>Returns a reference to the object that initiated this network
 
418
request; returns 0 if not set or the object has been destroyed.</p>
77
419
<p>This function was introduced in Qt 4.6.</p>
78
420
<p>See also <a href="qnetworkrequest.html#setOriginatingObject">setOriginatingObject</a>().</p>
79
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/rawHeader" />
80
 
<h3 class="fn"><a name="rawHeader" /><a href="qbytearray.html">QByteArray</a> QNetworkRequest.rawHeader (<i>self</i>, <a href="qbytearray.html">QByteArray</a>)</h3><p>Returns the raw form of header <i>headerName</i>. If no such header is present, an empty <a href="qbytearray.html">QByteArray</a> is returned, which may be indistinguishable from a header that is present but has no content (use <a href="qnetworkrequest.html#hasRawHeader">hasRawHeader</a>() to find out if the header exists or not).</p>
81
 
<p>Raw headers can be set with <a href="qnetworkrequest.html#setRawHeader">setRawHeader</a>() or with <a href="qnetworkrequest.html#setHeader">setHeader</a>().</p>
82
 
<p>See also <a href="qnetworkrequest.html#header">header</a>() and <a href="qnetworkrequest.html#setRawHeader">setRawHeader</a>().</p>
83
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/rawHeaderList" />
84
 
<h3 class="fn"><a name="rawHeaderList" />list-of-QByteArray QNetworkRequest.rawHeaderList (<i>self</i>)</h3><p>Returns a list of all raw headers that are set in this network request. The list is in the order that the headers were set.</p>
 
421
 
 
422
 
 
423
<h3 class="fn"><a name="priority" /><a href="qnetworkrequest.html#Priority-enum">Priority</a> QNetworkRequest.priority (<i>self</i>)</h3><p>Return the priority of this request.</p>
 
424
<p>This function was introduced in Qt 4.7.</p>
 
425
<p>See also <a href="qnetworkrequest.html#setPriority">setPriority</a>().</p>
 
426
 
 
427
 
 
428
<h3 class="fn"><a name="rawHeader" /><a href="qbytearray.html">QByteArray</a> QNetworkRequest.rawHeader (<i>self</i>, <a href="qbytearray.html">QByteArray</a>)</h3><p>Returns the raw form of header <i>headerName</i>. If no such
 
429
header is present, an empty <a href="qbytearray.html">QByteArray</a> is returned, which may be
 
430
indistinguishable from a header that is present but has no content
 
431
(use <a href="qnetworkrequest.html#hasRawHeader">hasRawHeader</a>()
 
432
to find out if the header exists or not).</p>
 
433
<p>Raw headers can be set with <a href="qnetworkrequest.html#setRawHeader">setRawHeader</a>() or with
 
434
<a href="qnetworkrequest.html#setHeader">setHeader</a>().</p>
 
435
<p>See also <a href="qnetworkrequest.html#header">header</a>() and
 
436
<a href="qnetworkrequest.html#setRawHeader">setRawHeader</a>().</p>
 
437
 
 
438
 
 
439
<h3 class="fn"><a name="rawHeaderList" />list-of-QByteArray QNetworkRequest.rawHeaderList (<i>self</i>)</h3><p>Returns a list of all raw headers that are set in this network
 
440
request. The list is in the order that the headers were set.</p>
85
441
<p>See also <a href="qnetworkrequest.html#hasRawHeader">hasRawHeader</a>() and <a href="qnetworkrequest.html#rawHeader">rawHeader</a>().</p>
86
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/setAttribute" />
87
 
<h3 class="fn"><a name="setAttribute" />QNetworkRequest.setAttribute (<i>self</i>, <a href="qnetworkrequest.html#Attribute-enum">Attribute</a>, QVariant)</h3><p>Sets the attribute associated with code <i>code</i> to be value <i>value</i>. If the attribute is already set, the previous value is discarded. In special, if <i>value</i> is an invalid <a href="qvariant.html">QVariant</a>, the attribute is unset.</p>
 
442
 
 
443
 
 
444
<h3 class="fn"><a name="setAttribute" />QNetworkRequest.setAttribute (<i>self</i>, <a href="qnetworkrequest.html#Attribute-enum">Attribute</a>, QVariant)</h3><p>Sets the attribute associated with code <i>code</i> to be value
 
445
<i>value</i>. If the attribute is already set, the previous value
 
446
is discarded. In special, if <i>value</i> is an invalid <a href="qvariant.html">QVariant</a>, the attribute is unset.</p>
88
447
<p>See also <a href="qnetworkrequest.html#attribute">attribute</a>() and <a href="qnetworkrequest.html#Attribute-enum">QNetworkRequest.Attribute</a>.</p>
89
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/setHeader" />
90
 
<h3 class="fn"><a name="setHeader" />QNetworkRequest.setHeader (<i>self</i>, <a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a>, QVariant)</h3><p>Sets the value of the known header <i>header</i> to be <i>value</i>, overriding any previously set headers. This operation also sets the equivalent raw HTTP header.</p>
91
 
<p>See also <a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a>, <a href="qnetworkrequest.html#setRawHeader">setRawHeader</a>(), and <a href="qnetworkrequest.html#header">header</a>().</p>
92
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/setOriginatingObject" />
93
 
<h3 class="fn"><a name="setOriginatingObject" />QNetworkRequest.setOriginatingObject (<i>self</i>, <a href="qobject.html">QObject</a>)</h3><p>Allows setting a reference to the <i>object</i> initiating the request.</p>
94
 
<p>For example <a href="qtwebkit.html">QtWebKit</a> sets the originating object to the <a href="qwebframe.html">QWebFrame</a> that initiated the request.</p>
 
448
 
 
449
 
 
450
<h3 class="fn"><a name="setHeader" />QNetworkRequest.setHeader (<i>self</i>, <a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a>, QVariant)</h3><p>Sets the value of the known header <i>header</i> to be
 
451
<i>value</i>, overriding any previously set headers. This operation
 
452
also sets the equivalent raw HTTP header.</p>
 
453
<p>See also <a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a>, <a href="qnetworkrequest.html#setRawHeader">setRawHeader</a>(), and
 
454
<a href="qnetworkrequest.html#header">header</a>().</p>
 
455
 
 
456
 
 
457
<h3 class="fn"><a name="setOriginatingObject" />QNetworkRequest.setOriginatingObject (<i>self</i>, <a href="qobject.html">QObject</a>)</h3><p>Allows setting a reference to the <i>object</i> initiating the
 
458
request.</p>
 
459
<p>For example <a href="qtwebkit.html">QtWebKit</a> sets the
 
460
originating object to the <a href="qwebframe.html">QWebFrame</a>
 
461
that initiated the request.</p>
95
462
<p>This function was introduced in Qt 4.6.</p>
96
463
<p>See also <a href="qnetworkrequest.html#originatingObject">originatingObject</a>().</p>
97
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/setRawHeader" />
98
 
<h3 class="fn"><a name="setRawHeader" />QNetworkRequest.setRawHeader (<i>self</i>, <a href="qbytearray.html">QByteArray</a>, <a href="qbytearray.html">QByteArray</a>)</h3><p>Sets the header <i>headerName</i> to be of value <i>headerValue</i>. If <i>headerName</i> corresponds to a known header (see <a href="qnetworkrequest.html#KnownHeaders-enum">QNetworkRequest.KnownHeaders</a>), the raw format will be parsed and the corresponding "cooked" header will be set as well.</p>
 
464
 
 
465
 
 
466
<h3 class="fn"><a name="setPriority" />QNetworkRequest.setPriority (<i>self</i>, <a href="qnetworkrequest.html#Priority-enum">Priority</a>&#160;<i>priority</i>)</h3><p>Set the priority of this request to <i>priority</i>.</p>
 
467
<p><b>Note:</b> The <i>priority</i> is only a hint to the network
 
468
access manager. It can use it or not. Currently it is used for HTTP
 
469
to decide which request should be sent first to a server.</p>
 
470
<p>This function was introduced in Qt 4.7.</p>
 
471
<p>See also <a href="qnetworkrequest.html#priority">priority</a>().</p>
 
472
 
 
473
 
 
474
<h3 class="fn"><a name="setRawHeader" />QNetworkRequest.setRawHeader (<i>self</i>, <a href="qbytearray.html">QByteArray</a>, <a href="qbytearray.html">QByteArray</a>)</h3><p>Sets the header <i>headerName</i> to be of value
 
475
<i>headerValue</i>. If <i>headerName</i> corresponds to a known
 
476
header (see <a href="qnetworkrequest.html#KnownHeaders-enum">QNetworkRequest.KnownHeaders</a>),
 
477
the raw format will be parsed and the corresponding "cooked" header
 
478
will be set as well.</p>
99
479
<p>For example:</p>
100
 
<pre> request.setRawHeader("Last-Modified", "Sun, 06 Nov 1994 08:49:37 GMT");</pre>
101
 
<p>will also set the known header <a href="qnetworkrequest.html#KnownHeaders-enum">LastModifiedHeader</a> to be the <a href="qdatetime.html">QDateTime</a> object of the parsed date.</p>
102
 
<p>Note: setting the same header twice overrides the previous setting. To accomplish the behaviour of multiple HTTP headers of the same name, you should concatenate the two values, separating them with a comma (",") and set one single raw header.</p>
103
 
<p>See also <a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a>, <a href="qnetworkrequest.html#setHeader">setHeader</a>(), <a href="qnetworkrequest.html#hasRawHeader">hasRawHeader</a>(), and <a href="qnetworkrequest.html#rawHeader">rawHeader</a>().</p>
104
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/setSslConfiguration" />
105
 
<h3 class="fn"><a name="setSslConfiguration" />QNetworkRequest.setSslConfiguration (<i>self</i>, <a href="qsslconfiguration.html">QSslConfiguration</a>)</h3><p>Sets this network request's SSL configuration to be <i>config</i>. The settings that apply are the private key, the local certificate, the SSL protocol (SSLv2, SSLv3, TLSv1 where applicable) and the ciphers that the SSL backend is allowed to use.</p>
106
 
<p>By default, no SSL configuration is set, which allows the backends to choose freely what configuration is best for them.</p>
107
 
<p>See also <a href="qnetworkrequest.html#sslConfiguration">sslConfiguration</a>() and <a href="qsslconfiguration.html#defaultConfiguration">QSslConfiguration.defaultConfiguration</a>().</p>
108
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/setUrl" />
109
 
<h3 class="fn"><a name="setUrl" />QNetworkRequest.setUrl (<i>self</i>, <a href="qurl.html">QUrl</a>)</h3><p>Sets the URL this network request is referring to to be <i>url</i>.</p>
 
480
<pre class="highlightedCode brush: cpp">
 
481
 request.setRawHeader("Last-Modified", "Sun, 06 Nov 1994 08:49:37 GMT");
 
482
</pre>
 
483
<p>will also set the known header <a href="qnetworkrequest.html#KnownHeaders-enum">LastModifiedHeader</a> to
 
484
be the <a href="qdatetime.html">QDateTime</a> object of the parsed
 
485
date.</p>
 
486
<p>Note: setting the same header twice overrides the previous
 
487
setting. To accomplish the behaviour of multiple HTTP headers of
 
488
the same name, you should concatenate the two values, separating
 
489
them with a comma (",") and set one single raw header.</p>
 
490
<p>See also <a href="qnetworkrequest.html#KnownHeaders-enum">KnownHeaders</a>, <a href="qnetworkrequest.html#setHeader">setHeader</a>(), <a href="qnetworkrequest.html#hasRawHeader">hasRawHeader</a>(), and
 
491
<a href="qnetworkrequest.html#rawHeader">rawHeader</a>().</p>
 
492
 
 
493
 
 
494
<h3 class="fn"><a name="setSslConfiguration" />QNetworkRequest.setSslConfiguration (<i>self</i>, <a href="qsslconfiguration.html">QSslConfiguration</a>)</h3><p>Sets this network request's SSL configuration to be
 
495
<i>config</i>. The settings that apply are the private key, the
 
496
local certificate, the SSL protocol (SSLv2, SSLv3, TLSv1 where
 
497
applicable) and the ciphers that the SSL backend is allowed to
 
498
use.</p>
 
499
<p>By default, no SSL configuration is set, which allows the
 
500
backends to choose freely what configuration is best for them.</p>
 
501
<p>See also <a href="qnetworkrequest.html#sslConfiguration">sslConfiguration</a>() and
 
502
<a href="qsslconfiguration.html#defaultConfiguration">QSslConfiguration.defaultConfiguration</a>().</p>
 
503
 
 
504
 
 
505
<h3 class="fn"><a name="setUrl" />QNetworkRequest.setUrl (<i>self</i>, <a href="qurl.html">QUrl</a>)</h3><p>Sets the URL this network request is referring to to be
 
506
<i>url</i>.</p>
110
507
<p>See also <a href="qnetworkrequest.html#url">url</a>().</p>
111
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/sslConfiguration" />
112
 
<h3 class="fn"><a name="sslConfiguration" /><a href="qsslconfiguration.html">QSslConfiguration</a> QNetworkRequest.sslConfiguration (<i>self</i>)</h3><p>Returns this network request's SSL configuration. By default, no SSL settings are specified.</p>
 
508
 
 
509
 
 
510
<h3 class="fn"><a name="sslConfiguration" /><a href="qsslconfiguration.html">QSslConfiguration</a> QNetworkRequest.sslConfiguration (<i>self</i>)</h3><p>Returns this network request's SSL configuration. By default, no
 
511
SSL settings are specified.</p>
113
512
<p>See also <a href="qnetworkrequest.html#setSslConfiguration">setSslConfiguration</a>().</p>
114
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/url" />
 
513
 
 
514
 
115
515
<h3 class="fn"><a name="url" /><a href="qurl.html">QUrl</a> QNetworkRequest.url (<i>self</i>)</h3><p>Returns the URL this network request is referring to.</p>
116
516
<p>See also <a href="qnetworkrequest.html#setUrl">setUrl</a>().</p>
117
 
<a name="//apple_ref/cpp/instm/QNetworkRequest/operator!=" />
118
 
<h3 class="fn"><a name="__eq__" />bool QNetworkRequest.__eq__ (<i>self</i>, <a href="qnetworkrequest.html">QNetworkRequest</a>)</h3><h3 class="fn"><a name="__ne__" />bool QNetworkRequest.__ne__ (<i>self</i>, <a href="qnetworkrequest.html">QNetworkRequest</a>)</h3><address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt&#160;4.7.7 for X11</td><td align="center" width="50%">Copyright &#169; <a href="http://www.riverbankcomputing.com">Riverbank&#160;Computing&#160;Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2010</td><td align="right" width="25%">Qt&#160;4.6.3</td></tr></table></div></address></body></html>
 
 
b'\\ No newline at end of file'
 
517
 
 
518
 
 
519
<h3 class="fn"><a name="__eq__" />bool QNetworkRequest.__eq__ (<i>self</i>, <a href="qnetworkrequest.html">QNetworkRequest</a>)</h3><h3 class="fn"><a name="__ne__" />bool QNetworkRequest.__ne__ (<i>self</i>, <a href="qnetworkrequest.html">QNetworkRequest</a>)</h3><address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt&#160;4.8.1 for X11</td><td align="center" width="50%">Copyright &#169; <a href="http://www.riverbankcomputing.com">Riverbank&#160;Computing&#160;Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2010</td><td align="right" width="25%">Qt&#160;4.7.0</td></tr></table></div></address></body></html>
 
 
b'\\ No newline at end of file'