CGI Response API.
Functions | |
bool | qcgires_setcookie (qentry_t *request, const char *name, const char *value, int expire, const char *path, const char *domain, bool secure) |
Set cookie. | |
bool | qcgires_removecookie (qentry_t *request, const char *name, const char *path, const char *domain, bool secure) |
Remove cookie. | |
bool | qcgires_setcontenttype (qentry_t *request, const char *mimetype) |
Set responding content-type. | |
const char * | qcgires_getcontenttype (qentry_t *request) |
Get content-type. | |
bool | qcgires_redirect (qentry_t *request, const char *uri) |
Send redirection header. | |
int | qcgires_download (qentry_t *request, const char *filepath, const char *mimetype) |
Force to send(download) file to client in accordance with given mime type. | |
void | qcgires_error (qentry_t *request, char *format,...) |
Print out HTML error page and exit program. |
bool qcgires_setcookie | ( | qentry_t * | request, | |
const char * | name, | |||
const char * | value, | |||
int | expire, | |||
const char * | path, | |||
const char * | domain, | |||
bool | secure | |||
) |
Set cookie.
request | a pointer of request structure | |
name | cookie name | |
value | cookie value | |
expire | expire related time in seconds (0 means end of session) | |
path | cookie path (NULL can current path) | |
domain | cookie domain (NULL means current domain) | |
secure | secure flag |
// Apply cookie in the current domain and directory for 1 day. qcgires_setcookie(req, "NAME", "qDecoder", 86400, NULL, NULL, false); // Apply cookie to the "/" directory of "*.qdecoder.org" until the // browser is closed. qcgires_setcookie(req, name, value, 0, "/", ".qdecoder.org", false); // As for the followings, cookies will be set up only when security // requirements are satisfied. qcgires_setcookie(req, name, value, 0, NULL, NULL, true);
bool qcgires_removecookie | ( | qentry_t * | request, | |
const char * | name, | |||
const char * | path, | |||
const char * | domain, | |||
bool | secure | |||
) |
Remove cookie.
request | a pointer of request structure | |
name | cookie name | |
path | cookie path | |
domain | cookie domain | |
secure | secure flag |
qcgires_setcookie(req, "NAME", "VALUE", 0, NULL, NULL, NULL); qcgires_removecookie(req, "NAME", NULL, NULL, NULL); qcgires_setcookie(req, "NAME", "VALUE", 0, "/", "www.qdecoder.org", NULL); qcgires_removecookie(req, "NAME", "/", "www.qdecoder.org", NULL);
bool qcgires_setcontenttype | ( | qentry_t * | request, | |
const char * | mimetype | |||
) |
Set responding content-type.
request | a pointer of request structure | |
mimetype | mimetype |
qcgires_setcontenttype(req, "text/html");
const char* qcgires_getcontenttype | ( | qentry_t * | request | ) |
Get content-type.
request | a pointer of request structure |
qcgires_setcontenttype(req, "text/html");
bool qcgires_redirect | ( | qentry_t * | request, | |
const char * | uri | |||
) |
Send redirection header.
request | a pointer of request structure | |
uri | new URI |
qcgires_redirect(req, "http://www.qdecoder.org/");
int qcgires_download | ( | qentry_t * | request, | |
const char * | filepath, | |||
const char * | mimetype | |||
) |
Force to send(download) file to client in accordance with given mime type.
request | a pointer of request structure | |
filepath | file to send | |
mimetype | mimetype. NULL can be used for "application/octet-stream". |
void qcgires_error | ( | qentry_t * | request, | |
char * | format, | |||
... | ||||
) |
Print out HTML error page and exit program.
request | a pointer of request structure | |
format | error message |
qcgires_error(req, "Error: can't find userid.");