cgiGetCookie

NAME

cgiGetCookie - Return a cookie

SYNOPSYS

#include <cgi.h>
 I s_cookie *cgiGetCookie (s_cgi * parms , const char * name );

DESCRIPTION

This routine returns a pointer to a s_cookie struct that contains all values for the cookie as referenced by R name . The s_cookie structure is defined as follows:
    typedef struct cookie_s {
	    char	*version,
		    *name,
		    *value,
		    *path,
		    *domain;
    } s_cookie;
You must NOT free this structure since it is only a pointer to internal data. To set a cookie in your program you'll need to manually add additional header lines. Please take a look at R cgitest.c . Basically, you'll need to add the following code:
   cgiSetHeader ("Set-Cookie", "Version=1; name=value; Path=/");
   cgiHeader();
Please read the included file cookies.txt as well.

RETURN VALUE

On success a pointer to a s_cookie structure is returned. If no cookie was set or no cookie with a given name exists NULL is returned.

AUTHOR

This CGI library is written by Martin Schulze <joey@infodrom.north.de>. If you have additions or improvements please get in touch with him.

SEE ALSO