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

  
 
  

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  ex-
	 tended encoding

     non-NULL
	 the  encoding of the input value as an extended parameter as a NUL-ter-
	 minated, 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.1.quarterly>

home | help