SoupCookieJar

typedef struct {
	GObject parent;
} SoupCookieJar;

soup_cookie_jar_new ()

SoupCookieJar*      soup_cookie_jar_new                 (void);

Creates a new SoupCookieJar. The base SoupCookieJar class does not support persistent storage of cookies; use a subclass for that.

Since 2.24

soup_cookie_jar_save ()

void                soup_cookie_jar_save                (SoupCookieJar *jar);

soup_cookie_jar_get_cookies ()

char*               soup_cookie_jar_get_cookies         (SoupCookieJar *jar,
                                                         SoupURI *uri,
                                                         gboolean for_http);

Retrieves (in Cookie-header form) the list of cookies that would be sent with a request to uri.

If for_http is TRUE, the return value will include cookies marked "HttpOnly" (that is, cookies that the server wishes to keep hidden from client-side scripting operations such as the JavaScript document.cookies property). Since SoupCookieJar sets the Cookie header itself when making the actual HTTP request, you should almost certainly be setting for_http to FALSE if you are calling this.

Since 2.24

soup_cookie_jar_set_cookie ()

void                soup_cookie_jar_set_cookie          (SoupCookieJar *jar,
                                                         SoupURI *uri,
                                                         const char *cookie);

Adds cookie to jar, exactly as though it had appeared in a Set-Cookie header returned from a request to uri.

Since 2.24

soup_cookie_jar_add_cookie ()

void                soup_cookie_jar_add_cookie          (SoupCookieJar *jar,
                                                         SoupCookie *cookie);

Adds cookie to jar, emitting the 'changed' signal if we are modifying an existing cookie or adding a valid new cookie ('valid' means that the cookie's expire date is not in the past).

cookie will be 'stolen' by the jar, so don't free it afterwards.

Since 2.24

soup_cookie_jar_delete_cookie ()

void                soup_cookie_jar_delete_cookie       (SoupCookieJar *jar,
                                                         SoupCookie *cookie);

Deletes cookie from jar, emitting the 'changed' signal.

Since 2.24

soup_cookie_jar_all_cookies ()

GSList*             soup_cookie_jar_all_cookies         (SoupCookieJar *jar);

Constructs a GSList with every cookie inside the jar. The cookies in the list are a copy of the original, so you have to free them when you are done with them.

Since 2.24

SOUP_COOKIE_JAR_READ_ONLY

#define SOUP_COOKIE_JAR_READ_ONLY "read-only"

Alias for the "read-only" property. (Whether or not the cookie jar is read-only.)