NAME
cgiGetFile - Return information of a CGI file variable
SYNOPSYS
#include <cgi.h>
s_file *cgiGetFile (s_cgi *parms, const char *name);
DESCRIPTION
This routine returns a pointer to a datastructure associated with the
value of a CGI file variable. The pointer must not be freed.
The s_file structure is declared as follows:
typedef struct file_s {
char *name,
*type,
*filename,
*tmpfile;
} s_file;
Memory allocated by this data structure is automatically freed by the
final call to cgiFree(3).
RETURN VALUE
On success a pointer to the s_file datastructure is returned. If the
variable wasn’t transmitted or the through CGI or if the filename 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
cgiGetFiles(3), cgiGetVariables(3), cgiGetCookies(3), cgiDebug(3),
cgiInit(3), cgiFree(3).