The qDecoder Project

The qDecoder Project

qDecoder 12.0.2 released — May 17, 2012

IMPORT CHANGES : From the version of 11, qDecoder only has CGI-related features and all containers(data-structures) and other APIs has moved to qLibc project.

What's qDecoder?

qDecoder is a CGI library for C/C++ programming language which has been developed since 1996.

All of the deliverable code in qDecoder has been dedicated to the public domain by the authors. Anyone is free to copy, modify, publish, use, compile, sell, or distribute the original qDecoder code, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.

All of the deliverable code in qDecoder has been written from scratch. No code has been taken from other projects or from the open internet. Every line of code can be traced back to its original author. So the qDecoder code base is clean and is not contaminated with licensed code from any other projects.

Features

Supports parsing a request encoded by GET/POST method
Supports parsing multipart/form-data encoding. (in-memory and direct disk)
Supports COOKIE handling.
Supports Session management.
Supports FastCGI

Compatible Platforms

Operating System : Linux, FreeBSD and oost of Unix-like systems.

qDecoder has been developed and tested under below platforms..

Language Standard: C99
Compiler: GCC 4.1.2
Operating System: FreeBSD 6.x, Linux CentOS 5.x

How easy making CGI applications in C/C++

Parsed elements are stored in Q_ENTRY linked-list structure.

  [HTML sample]
  <form action="your_program.cgi">
    <input type="text" name="color">
    <input type="submit">
  </form>
 
  [Your Code]
  qentry_t *req = qcgireq_parse(NULL, 0);
 
  qcgires_setcontenttype(req, "text/plain");
  const char *color = req->getstr(req, "color", false);
  if (color != NULL) {
    printf("color = %s\n", color);
  }
 
  req->free(req);

The order of parsing sequence is (1)COOKIE (2)POST (3)GET. Thus if there is a same query name existing in different methods, COOKIE values will be stored first than POST, GET values will be added at the very last into a qentry linked-list.

Below is an example to parse only two given methods. Please note that when multiple methods are specified, it'll be parsed in the order of COOKIE, POST and GET.

  qentry_t *req = qcgireq_parse(req, Q_CGI_COOKIE | Q_CGI_POST);

To change the order of parsing sequence, you can call qcgireq_parse() multiple times in the order that you want as below.

  qentry_t *req;
  req = qcgireq_parse(req, Q_CGI_POST);
  req = qcgireq_parse(req, Q_CGI_GET);
  req = qcgireq_parse(req, Q_CGI_COOKIE);

In terms of multipart/form-data encoding(used for file uploading), qDecoder can handle that in two different ways internally.

default mode : Uploading file will be processed only in memory. (see examples/upload.c)
file mode : Uploading file will be stored directly into disk. (see examples/uploadfile.c)

You can switch to file mode by calling qCgiRequestSetOption().

  Q_ENTRY *req = qcgireq_setoption(NULL, true, "/tmp", 86400);
  req = qcgireq_parse(req, 0);
  // ...your codes here...
  req->free(req);

Basically, when file is uploaded qDecoder store it's meta information like below.

(VARIABLE_NAME) - In the default mode, this is binary data. In the file mode this value is same as ”(VARIABLE_NAME).savepath”.
(VARIABLE_NAME).filename - File name itself, path information will be removed.
(VARIABLE_NAME).length - File size, the number of bytes.
(VARIABLE_NAME).contenttype - Mime type like 'text/plain'.
(VARIABLE_NAME).savepath - Only appended only in file mode. The file path where the uploaded file is saved.

  [default mode example]
  binary = (...binary data...)
  binary.filename = hello.xls
  binary.length = 3292
  binary.contenttype = application/vnd.ms-excel

  [file mode example]
  binary = tmp/q_wcktIq
  binary.length = 60014
  binary.filename = hello.xls
  binary.contenttype = application/vnd.ms-excel
  binary.savepath = tmp/q_wcktIq

Please refer the examples included in the source package for more detailed samples.