SoupRequester

SoupRequester

Synopsis

#include <libsoup/soup.h>

struct              SoupRequester;
SoupRequester *     soup_requester_new                  (void);
SoupRequest *       soup_requester_request              (SoupRequester *requester,
                                                         const char *uri_string,
                                                         GError **error);
SoupRequest *       soup_requester_request_uri          (SoupRequester *requester,
                                                         SoupURI *uri,
                                                         GError **error);

enum                SoupRequesterError;
#define             SOUP_REQUESTER_ERROR

Object Hierarchy

  GObject
   +----SoupRequester

Implemented Interfaces

SoupRequester implements SoupSessionFeature.

Description

Details

struct SoupRequester

struct SoupRequester;


soup_requester_new ()

SoupRequester *     soup_requester_new                  (void);

Creates a new SoupRequester object, which can be added to a SoupSession with soup_session_add_feature().

Returns :

the new SoupRequester

Since 2.34


soup_requester_request ()

SoupRequest *       soup_requester_request              (SoupRequester *requester,
                                                         const char *uri_string,
                                                         GError **error);

Creates a SoupRequest for retrieving uri_string.

requester :

a SoupRequester

uri_string :

a URI, in string form

error :

return location for a GError, or NULL

Returns :

a new SoupRequest, or NULL on error. [transfer full]

Since 2.34


soup_requester_request_uri ()

SoupRequest *       soup_requester_request_uri          (SoupRequester *requester,
                                                         SoupURI *uri,
                                                         GError **error);

Creates a SoupRequest for retrieving uri.

requester :

a SoupRequester

uri :

a SoupURI representing the URI to retrieve

error :

return location for a GError, or NULL

Returns :

a new SoupRequest, or NULL on error. [transfer full]

Since 2.34


enum SoupRequesterError

typedef enum {
	SOUP_REQUESTER_ERROR_BAD_URI,
	SOUP_REQUESTER_ERROR_UNSUPPORTED_URI_SCHEME
} SoupRequesterError;

A SoupRequester error.

SOUP_REQUESTER_ERROR_BAD_URI

the URI could not be parsed

SOUP_REQUESTER_ERROR_UNSUPPORTED_URI_SCHEME

the URI scheme is not supported by this SoupRequester

Since 2.34


SOUP_REQUESTER_ERROR

#define SOUP_REQUESTER_ERROR soup_requester_error_quark ()

A GError domain for SoupRequester errors. Used with SoupRequesterError.

Since 2.34