Function
SoupCookieparse
Declaration [src]
SoupCookie*
soup_cookie_parse (
const char* header,
GUri* origin
)
Description [src]
Parses header
and returns a SoupCookie
.
If header
contains multiple cookies, only the first one will be parsed.
If header
does not have “path” or “domain” attributes, they will
be defaulted from origin
. If origin
is NULL
, path will default
to “/”, but domain will be left as NULL
. Note that this is not a
valid state for a SoupCookie
, and you will need to fill in some
appropriate string for the domain if you want to actually make use
of the cookie.
As of version 3.4.0 the default value of a cookie’s same-site-policy
is SOUP_SAME_SITE_POLICY_LAX
.
Parameters
header
-
Type:
const char*
A cookie string (eg, the value of a Set-Cookie header)
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. origin
-
Type:
GUri
Origin of the cookie.
The argument can be NULL
.The data is owned by the caller of the function.
Return value
Type: SoupCookie
A new SoupCookie
, or NULL
if it could
not be parsed, or contained an illegal “domain” attribute for a
cookie originating from origin
.
The caller of the function takes ownership of the data, and is responsible for freeing it. |
The return value can be NULL . |