1 .\" cgiGetValue - Return the value of a CGI variable
2 .\" Copyright (c) 1998,9,2007,8 by Martin Schulze <joey@infodrom.org>
4 .\" This program is free software; you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 2 of the License, or
7 .\" (at your option) any later version.
9 .\" This program is distributed in the hope that it will be useful,
10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 .\" GNU General Public License for more details.
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with this program; if not, write to the Free Software
16 .\" Foundation, Inc.,59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
18 .TH cgiGetValue 3 "6 April 2008" "CGI Library" "Programmer's Manual"
20 cgiGetValue \- Return the value of a CGI variable
25 .BI "char *cgiGetValue (s_cgi *" parms ", const char *" name );
28 This routine returns a pointer to the value of a cgi variable.
29 Encoded characters (%nn) are already decoded. One must not free the
34 fields are used (i.e. a variable that may contain several values) the
35 value returned contains all these values concatenated together with a
36 newline character as separator.
38 Memory allocated by the returned value is automatically freed by the
42 On success a pointer to a string is returned. If the variable wasn't
43 transmitted through CGI or was empty NULL is returned.
45 This CGI library is written by Martin Schulze
46 <joey@infodrom.org>. If you have additions or improvements
47 please get in touch with him.
49 .BR cgiGetVariables (3),
51 .BR cgiGetCookies (3),