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