NE_STRPARAM(3) neon API reference NE_STRPARAM(3)
ne_strparam - HTTP extended parameter value encoding
#include <ne_string.h>
char *ne_strparam(const char *charset, const char *lang,
const char *value);
The ne_strparam function can be used to encode an extended parameter
value for an HTTP header, as defined in RFC 5987. The function takes
as arguments the value to encode, using a given MIME charset
character set, and lang language tag. The extended parameter encoding
is used in HTTP protocol specifications to allow easily embedding
special characters (such as quote marks, separators or non-ASCII) in
header values.
In accordance with RFC 5987, the charset argument must be either
"UTF-8" or "IS0-8859-1", but the lang argument may be NULL.
The return value is either:
NULL
if the value parameter is a "regular parameter" and does not need
extended encoding
non-NULL
the encoding of the input value as an extended parameter as a
NUL-terminated, malloc-allocated string
https://tools.ietf.org/html/rfc5987
Joe Orton
Author.
neon 0.32.5 21 January 2023 NE_STRPARAM(3)
NAME
ne_strparam - HTTP extended parameter value encoding
SYNOPSIS
#include <ne_string.h>
char *ne_strparam(const char *charset, const char *lang,
const char *value);
DESCRIPTION
The ne_strparam function can be used to encode an extended parameter
value for an HTTP header, as defined in RFC 5987. The function takes
as arguments the value to encode, using a given MIME charset
character set, and lang language tag. The extended parameter encoding
is used in HTTP protocol specifications to allow easily embedding
special characters (such as quote marks, separators or non-ASCII) in
header values.
In accordance with RFC 5987, the charset argument must be either
"UTF-8" or "IS0-8859-1", but the lang argument may be NULL.
RETURN VALUE
The return value is either:
NULL
if the value parameter is a "regular parameter" and does not need
extended encoding
non-NULL
the encoding of the input value as an extended parameter as a
NUL-terminated, malloc-allocated string
SEE ALSO
https://tools.ietf.org/html/rfc5987
AUTHOR
Joe Orton
Author.
COPYRIGHT
neon 0.32.5 21 January 2023 NE_STRPARAM(3)