Cookie Creation

Create and manipulate individual cookies. More...

Functions
cookie_t *	cookie_new (const char *name, const char *value, const char *domain, const char *path)
	Create a new cookie.
cookie_parse_result_t	cookie_parse_set_cookie (const char *header_value, const char *request_url, cookie_t **cookie)
	Parse a Set-Cookie header.
cookie_parse_result_t	cookie_parse_set_cookie_headers (const char **header_values, size_t count, const char *request_url, cookie_t ***cookies, size_t *cookie_count)
	Parse multiple Set-Cookie headers.
cookie_t *	cookie_clone (const cookie_t *cookie)
	Clone a cookie.
void	cookie_free (cookie_t *cookie)
	Free a cookie.

Detailed Description

Create and manipulate individual cookies.

Function Documentation

cookie_clone()

cookie_t * cookie_clone

(

const cookie_t *

cookie

)

Clone a cookie.

Parameters

cookie

Cookie to clone

Returns

New cookie copy, or NULL on failure

cookie_free()

void cookie_free

(

cookie_t *

cookie

)

Free a cookie.

Parameters

cookie

Cookie to free (can be NULL)

cookie_new()

cookie_t * cookie_new	(	const char *	name,
		const char *	value,
		const char *	domain,
		const char *	path )

Create a new cookie.

Parameters

name	Cookie name (required)
value	Cookie value (required)
domain	Domain attribute (optional, can be NULL)
path	Path attribute (optional, defaults to "/")

Returns

New cookie, or NULL on failure

cookie_t *cookie = cookie_new("session_id", "abc123", "example.com", "/");
if (cookie) {
    cookie_set_secure(cookie, true);
    cookie_set_http_only(cookie, true);
    // Use cookie...
    cookie_free(cookie);
}

cookie_parse_set_cookie()

cookie_parse_result_t cookie_parse_set_cookie	(	const char *	header_value,
		const char *	request_url,
		cookie_t **	cookie )

Parse a Set-Cookie header.

Parameters

header_value	Set-Cookie header value
request_url	URL of the request (for domain/path defaults)
cookie	Output pointer for parsed cookie

Returns

Parse result code

cookie_t *cookie = NULL;
cookie_parse_result_t result = cookie_parse_set_cookie(
    "sessionid=abc123; Domain=example.com; Path=/; Secure; HttpOnly",
    "https://example.com/login",
    &cookie
);
 
if (result == COOKIE_PARSE_SUCCESS) {
    // Use parsed cookie...
    cookie_free(cookie);
} else {
    printf("Parse error: %s\n", cookie_parse_error_string(result));
}

cookie_parse_set_cookie_headers()

cookie_parse_result_t cookie_parse_set_cookie_headers	(	const char **	header_values,
		size_t	count,
		const char *	request_url,
		cookie_t ***	cookies,
		size_t *	cookie_count )

Parse multiple Set-Cookie headers.

Parameters

header_values	Array of Set-Cookie header values
count	Number of headers
request_url	URL of the request
cookies	Output array of parsed cookies
cookie_count	Output number of successfully parsed cookies

Returns

Parse result code