cow_cookie:parse_set_cookie(3)

Name

cow_cookie:parse_set_cookie - Parse a set-cookie header

Description

parse_set_cookie(SetCookie :: binary())
    -> {ok, Name, Value, Attrs} | ignore

Name  :: binary()
Value :: binary()
Attrs :: cow_cookie:cookie_attrs()

Parse a set-cookie header.

Arguments

SetCookie

The set-cookie header value.

Return value

An ok tuple with the cookie name, value and attributes is returned on success.

An atom ignore is returned when the cookie has both an empty name and an empty value, or when the combined length of the name and value is greater than 4096 octets.

An expires or max_age more than 400 days in the future is reduced to 400 days. Dates are parsed with cow_date:parse_date/1.

Changelog

• 2.9: Function introduced.

Examples

case cow_cookie:parse_set_cookie(SetCookieHd) of
    {ok, Name, Value, Attrs} ->
        cookie_engine_set_cookie(Name, Value, Attrs);
    ignore ->
        do_nothing()
end.

See also

cow_cookie(3), cow_cookie:parse_cookie(3), cow_cookie:cookie(3), cow_cookie:setcookie(3)