Top |
Functions
GInputStream * | soup_request_send () |
void | soup_request_send_async () |
GInputStream * | soup_request_send_finish () |
goffset | soup_request_get_content_length () |
const char * | soup_request_get_content_type () |
SoupSession * | soup_request_get_session () |
SoupURI * | soup_request_get_uri () |
Properties
SoupSession * | session | Read / Write / Construct Only |
SoupURI * | uri | Read / Write / Construct Only |
Object Hierarchy
GObject ╰── SoupRequest ├── SoupRequestData ├── SoupRequestFile ╰── SoupRequestHTTP
Description
A SoupRequest is created by SoupSession, and represents a request to retrieve a particular URI.
Functions
soup_request_send ()
GInputStream * soup_request_send (SoupRequest *request
,GCancellable *cancellable
,GError **error
);
Synchronously requests the URI pointed to by request
, and returns
a GInputStream that can be used to read its contents.
Note that you cannot use this method with SoupRequests attached to a SoupSessionAsync.
Returns
a GInputStream that can be used to
read from the URI pointed to by request
.
[transfer full]
Since: 2.42
soup_request_send_async ()
void soup_request_send_async (SoupRequest *request
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Begins an asynchronously request for the URI pointed to by
request
.
Note that you cannot use this method with SoupRequests attached to a SoupSessionSync.
Parameters
request |
||
cancellable |
a GCancellable or |
|
callback |
a GAsyncReadyCallback |
|
user_data |
user data passed to |
Since: 2.42
soup_request_send_finish ()
GInputStream * soup_request_send_finish (SoupRequest *request
,GAsyncResult *result
,GError **error
);
Gets the result of a soup_request_send_async()
.
Returns
a GInputStream that can be used to
read from the URI pointed to by request
.
[transfer full]
Since: 2.42
soup_request_get_content_length ()
goffset
soup_request_get_content_length (SoupRequest *request
);
Gets the length of the data represented by request
. For most
request types, this will not be known until after you call
soup_request_send()
or soup_request_send_finish()
.
Since: 2.42
soup_request_get_content_type ()
const char *
soup_request_get_content_type (SoupRequest *request
);
Gets the type of the data represented by request
. For most request
types, this will not be known until after you call
soup_request_send()
or soup_request_send_finish()
.
As in the HTTP Content-Type header, this may include parameters after the MIME type.
Since: 2.42
soup_request_get_session ()
SoupSession *
soup_request_get_session (SoupRequest *request
);
Gets request
's SoupSession
Since: 2.42
soup_request_get_uri ()
SoupURI *
soup_request_get_uri (SoupRequest *request
);
Gets request
's URI
Since: 2.42
Types and Values
SoupRequest
typedef struct _SoupRequest SoupRequest;
A request to retrieve a particular URI.
Since: 2.42
SOUP_REQUEST_SESSION
#define SOUP_REQUEST_SESSION "session"
Alias for the “session” property, qv.
Since: 2.42
Property Details
The “session”
property
“session” SoupSession *
The request's SoupSession.
Owner: SoupRequest
Flags: Read / Write / Construct Only
Since: 2.42
The “uri”
property
“uri” SoupURI *
The request URI.
Owner: SoupRequest
Flags: Read / Write / Construct Only
Since: 2.42