Table of Contents

Name

cgiGetCookie - Return a cookie

Synopsys

#include <cgi.h>

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

cgiGetValue(3) , cgiGetVariables(3) , cgiGetCookies(3) , cgiDebug(3) , cgiHeader(3) , cgiInit(3) .


Table of Contents