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).