CGIC是C语言CGI库函数,用于编写CGI程序
CGIC 主要完成以下功能：
*对数据进行语法分析
*接收以GET和PSOT两种方式发送的数据
*把FORM中的不同域连接成连续的串
*为检索FORM数据而提供字符串,整数,浮点以及单项和多项选择功能
*为数字字段提供边界检测
*把CGI环境变量加载到非空的C串中
*为调试而捕捉CGI状态
如何写CGIC应用程序
任何cgic 应用程序必须连接到cgic.c，如果在Linux 下可以用Makefile 做这个工作。
因为CGI 程序需要做一些初始化操作，如获取环境变量，分析数据等，所以cgic 库提供了自己的main()函数，那自己写的cgic程序不能再包含main()函数，而必须以cgiMain()函数开始，cgic.c会调用这个函数。当然这个函数名是可以更改的.还要注意的是，自己编写的cgic 程序必须包含#include<cigi.h>
也就是说cgic,已经做了一些相关的解析工作，在自己的main函数中只要调用cigic 中相应的函数便可。
以下是cigic 库里自带的cgic test程序的cgiMain()
int cgiMain() {#ifdef DEBUGLoadEnvironment();#endif /* DEBUG *//* Load a previously saved CGI scenario if that buttonhas been pressed. */if (cgiFormSubmitClicked("loadenvironment") == cgiFormSuccess) {LoadEnvironment();}/* Set any new cookie requested. Must be done *before*outputting the content type. */CookieSet();/* Send the content type, letting the browser know this is HTML */cgiHeaderContentType("text/html");/* Top of the page */fprintf(cgiOut, "<HTML><HEAD>\n");fprintf(cgiOut, "<TITLE>cgic test</TITLE></HEAD>\n");fprintf(cgiOut, "<BODY><H1>cgic test</H1>\n");/* If a submit button has already been clicked, act on the submission of the form. */if ((cgiFormSubmitClicked("testcgic") == cgiFormSuccess) ||cgiFormSubmitClicked("saveenvironment") == cgiFormSuccess){HandleSubmit();fprintf(cgiOut, "<hr>\n");}/* Now show the form */ShowForm();/* Finish up the page */fprintf(cgiOut, "</BODY></HTML>\n");return 0;}
#ifdef DEBUGLoadEnvironment();#endif /* DEBUG */
一般采用以上方式，调用环境变量用作调试。 可以插入语句："#define DEBUG 1 将DEBUG模式打开。
cgiHeaderContentType("text/html") 这个函数主要是输出Content Type Header，告诉浏览器返回的是一个html页面，当然也可以是"image/gif", "image/jpeg" and "audio/wav
外一点就是，cgi程序输出HTML页面的方式都是使用printf把页面一行一行地打印出来，比如cgictest.c中的这一段代码：
fprintf(cgiOut, "<textarea NAME=\"address\" ROWS=4 COLS=40>\n");
fprintf(cgiOut, "Default contents go here. \n");
fprintf(cgiOut, "</textarea>\n");
上面这段代码的运行结果就是在页面上输出一个textarea。 第一个参数cgiOut实际上就是stdin，所以我们可以直接使用printf，而不必使用fprintf。不过在调试的时候会用到fprintf来重定向输出
CGI 调试起来比较麻烦，CGIC提供了一个函数可以将环境变量输入到文件，方便调试。
cgiWriteEnvironment("/etc/conf.d/c0/capcgi.dat");
