Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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

HISTORY
       ne_strparam is available	in neon	0.32.0 and later.

SEE ALSO
       https://tools.ietf.org/html/rfc5987

COPYRIGHT
       Copyright (C) 2001-2024 Joe Orton

neon 0.34.0		       23 November 2024			NE_STRPARAM(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ne_strparam&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help