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