focal (3) cgiGetFile.3.gz

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