## 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