HTTP_COOKIE_CREATE(3)

NAME
http_cookie_create - creates a HTTP/1.1 cookie

SYNOPSIS

#include <libweb/http.h>

char *http_cookie_create(const char *key, const char *value, const struct tm *exp);

DESCRIPTION
The http_cookie_create() function allocates a null-terminated string with a HTTP/1.1 cookie defined by key and value, which are null-terminated strings, with an optional expiration date defined by exp. If exp is a null pointer, no expiration date is set to the cookie, and therefore it effectively acts as a session cookie.

RETURN VALUE
On success, a null-terminated string with the newly HTTP/1.1 cookie is returned. Otherwise, a null pointer is returned.

ERRORS
No errors are defined.

EXAMPLE
A successful call to http_cookie_create(3) with ExampleValue as key, ExampleValue as value and exp pointing to a given calendar time might return a null-terminated string such as the one below:

    ExampleHeader=ExampleValue; HttpOnly; Expires Wed, 07 Sep 2023 00:00:00 GMT

SEE ALSO
libweb_http(7).

COPYRIGHT
Copyright (C) 2023-2026 libweb contributors

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.