FreeBSD manual

download PDF document: ne_strparam.3.pdf

NE_STRPARAM(3) neon API reference 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 <neon@lists.manyfish.co.uk> Author. COPYRIGHT neon 0.32.4 11 September 2022 NE_STRPARAM(3)