libctemplate——C语言模块引擎简介及使用

时间:2023-03-10 00:50:11
libctemplate——C语言模块引擎简介及使用

前言

  首先声明此libctemplate不是Google那个ctemplate。这个库是用C语言实现的,只有一个实现文件和一个头文件。Gooogl的ctemplate是C++实现的,和线程还扯上了关系。这两个库的具体代码还没看,从介绍及例子上看,libctemplate应该比Google的那个更轻量级,在嵌入式的web开发中可能更适合。

  因为前段时间在做嵌入式设备中的web开发,使用c语言CGI方式开发web服务器端。上网查找资料时发现“C语言也能干大事之C语言开发网站教程”,因此知道libctemplate,有了这个模板引擎,再配合cgic这个库,开发起web来会方便很多。关于这个库的介绍看官方文档可能会更准确详尽。

官网:http://libctemplate.sourceforge.net/

手册:http://libctemplate.sourceforge.net/doc.html

C语言也能干大事之C语言开发网站教程:http://www.rupeng.com/Courses/Index/34

例子

  一个简单的例子,说明这个库的简单应用。例子总共分为两部分,一部分是模板文件,也就是html文件;一部分是c语言写的CGI程序。例子比较简单,代码需要分析解析的地方请看代码注释。

html代码

 <html>
<head>
<title>user</title>
</head>
<body>
姓名:<TMPL_VAR name="Name"/><br />
年龄:<TMPL_VAR name="Age"/><br/>
家族成员:
<table border=1>
<tr><td>姓名</td><td>生日</td></tr>
<TMPL_LOOP name="Persons">
<tr><td><TMPL_VAR name="Name"/></td><td><TMPL_VAR name="Age"/></td></tr>
</TMPL_LOOP>
</table>
</body>
</html>

CGI程序

 #include <stdio.h>
#include "cgic.h" // cgic库的头文件
#include "ctemplate.h" // libctemplate库的头文件 // main已经定义在cgic.c中,在main函数中会调用cgiMain
int cgiMain(int argc, char **argv)
{
TMPL_varlist *mainList = ;
TMPL_varlist *personList = ;
TMPL_loop *loop = ; // 使用cgic接口,输出文档类型
cgiHeaderContentType("text/html;charset=gbk"); // 把两个家族成员的值加到一个TMPL_loop中,用来显示在表格中
// 所有的值都必须是字符串形式
personList = TMPL_add_var(, "Name", "lucy", "Age", "", );
loop = TMPL_add_varlist(loop, personList); personList = TMPL_add_var(, "Name", "lily", "Age", "", );
loop = TMPL_add_varlist(loop, personList); // 再把这个TMPL_loop嵌到值列表中,名字是“Persons”,要与模板中的名字一样
mainList = TMPL_add_loop(mainList, "Persons", loop); // 再往值列表中加一些值
mainList = TMPL_add_var(mainList,"Name","uncle wang","Age","",); // 把值列表在模块中显示,模块文件的路径根据需要更改
TMPL_write("web/cgi-bin/user.html",,,mainList,cgiOut,cgiOut); return ;
}

布署运行

  把CGI程序加上cgic、ctemplate一起编译,把编译出来的程序和html按指定目录放置后,可以直接执行,运行结果如下。即把值列表中的值替换模板中的指定变量,生成一串html字符流。

 [/mnt/goahead]./user2
Content-type: text/html;charset=gbk <html>
<head>
<title>user</title>
</head>
<body>
姓名:xiaomin<br />
年龄:<br/>
家族成员:
<table border=>
<tr><td>姓名</td><td>生日</td></tr> <tr><td>lucy</td><td></td></tr> <tr><td>lily</td><td></td></tr> </table>
</body>
</html>
[/mnt/goahead]

  把程序和模板布署到web server对应目录中,即可在浏览器中测试。上面例子的执行结果如下图所示。

libctemplate——C语言模块引擎简介及使用