cgiGetValue

Langue: en

Version: 6 April 2008 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

cgiGetValue - Return the value of a CGI variable

SYNOPSYS

 #include <cgi.h>
 
 char *cgiGetValue (s_cgi *parms, const char *name);

DESCRIPTION

This routine returns a pointer to the value of a cgi variable. Encoded characters (%nn) are already decoded. One must not free the pointer.

If multiple fields are used (i.e. a variable that may contain several values) the value returned contains all these values concatenated together with a newline character as separator.

Memory allocated by the returned value is automatically freed by the final call to cgiFree(3).

RETURN VALUE

On success a pointer to a string is returned. If the variable wasn't transmitted through CGI or was empty NULL is returned.

AUTHOR

This CGI library is written by Martin Schulze <joey@infodrom.org>. If you have additions or improvements please get in touch with him.

SEE ALSO

cgiGetVariables(3), cgiGetCookie(3), cgiGetCookies(3), cgiDebug(3), cgiHeader(3), cgiInit(3), cgiFree(3).