|  |  |  | libsoup Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | ||||
#include <libsoup/soup.h> struct SoupRequest; GInputStream * soup_request_send (SoupRequest *request,GCancellable *cancellable,GError **error); void soup_request_send_async (SoupRequest *request,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); GInputStream * soup_request_send_finish (SoupRequest *request,GAsyncResult *result,GError **error); goffset soup_request_get_content_length (SoupRequest *request); const char * soup_request_get_content_type (SoupRequest *request); SoupSession * soup_request_get_session (SoupRequest *request); SoupURI * soup_request_get_uri (SoupRequest *request); #define SOUP_REQUEST_SESSION #define SOUP_REQUEST_URI
GObject +----SoupRequest +----SoupRequestData +----SoupRequestFile +----SoupRequestHTTP
"session" SoupSession* : Read / Write / Construct Only "uri" SoupURI* : Read / Write / Construct Only
A SoupRequest is created by SoupRequester, and represents a request to retrieve a particular URI.
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.
| 
 | a SoupRequest | 
| 
 | a GCancellable or NULL | 
| 
 | return location for a GError, or NULL | 
| Returns : | a GInputStream that can be used to
read from the URI pointed to by request. [transfer full] | 
Since 2.34
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.
| 
 | a SoupRequest | 
| 
 | a GCancellable or NULL | 
| 
 | a GAsyncReadyCallback | 
| 
 | user data passed to callback | 
Since 2.34
GInputStream * soup_request_send_finish (SoupRequest *request,GAsyncResult *result,GError **error);
Gets the result of a soup_request_send_async().
| 
 | a SoupRequest | 
| 
 | the GAsyncResult | 
| 
 | return location for a GError, or NULL | 
| Returns : | a GInputStream that can be used to
read from the URI pointed to by request. [transfer full] | 
Since 2.34
goffset             soup_request_get_content_length     (SoupRequest *request);
Gets the length of the data represented by request.
| 
 | a SoupRequest | 
| Returns : | the length of the data represented by request,
or -1 if not known. | 
Since 2.34
const char *        soup_request_get_content_type       (SoupRequest *request);
Gets the type of the data represented by request.
| 
 | a SoupRequest | 
| Returns : | the type of the data represented by request,
orNULLif not known. | 
Since 2.34
SoupSession *       soup_request_get_session            (SoupRequest *request);
Gets request's SoupSession
| 
 | a SoupRequest | 
| Returns : | request's SoupSession. [transfer none] | 
Since 2.34
SoupURI *           soup_request_get_uri                (SoupRequest *request);
Gets request's URI
| 
 | a SoupRequest | 
| Returns : | request's URI. [transfer none] | 
Since 2.34
"session" property"session" SoupSession* : Read / Write / Construct Only
The request's session.