![]() |
![]() |
![]() |
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 ,
or NULL if 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.