---
name: "ne_strparam"
section: "3"
platform: "linux"
package: "neon"
version: "0.37.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/ne_strparam"
---

# ne\_strparam(3)

HTTP extended parameter value encoding

## 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

## HISTORY

**ne\_strparam** is available in neon 0.32.0 and later.

## SEE ALSO

**https://www.rfc-editor.org/rfc/rfc5987.html**

## COPYRIGHT

Copyright © 2001-2026 Joe Orton\