ctemplate

Qter

https://www.xuebuyuan.com/2608449.html  Google开源C++模板库ctemplate完整使用示例

CTemplate是Google开源的一个使用简单但功能很强大的C++模板库，本文简单介绍其的使用。

入门示例

模板库一般用来隔离数据和展现，这样可以减少数据和展现之间的耦合，使其可以相互独立变化，减少耦合，增加代码的复用，下面我们先看一个简单的例子，模板如下：

1. Hello {{NAME}},
   
2. You have just won ${{VALUE}}!
   
3. {{#IN_CA}}Well, ${{TAXED_VALUE}}, after taxes.{{/IN_CA}}
   
4. 对应的C++代码是：
   
5. 
   
6. #include <cstdlib>
   
7. #include <iostream>  
   
8. #include <string>
   
9. #include <ctemplate/template.h>  
   
10. 
    
11. int main() {
    
12.     ctemplate::TemplateDictionary dict("example");
    
13.     int winnings = rand() % 100000;
    
14.     dict["NAME"] = "John Smith";
    
15.     dict["VALUE"] = winnings;
    
16.     dict.SetFormattedValue("TAXED_VALUE", "%.2f", winnings * 0.83);
    
17.     // For now, assume everyone lives in CA.
    
18.     // (Try running the program with a 0 here instead!)
    
19.     if (1) {
    
20.         dict.ShowSection("IN_CA");
    
21.     }
    
22.     std::string output;
    
23.     ctemplate::ExpandTemplate("example.tpl", ctemplate::DO_NOT_STRIP, &dict, &output);
    
24.     std::cout << output;
    
25.     return 0;
    
26. }

复制代码

模板中{{NAME}}和{{VALUE}}对应的是变量，在dict中通过dict["NAME"]或dict的setValue的相关方法进行赋值；{{#IN_CA}}和{{/IN_CA}}之间的是一个section，可以通过dict的ShowSection来控制是否要显示这个section。

循环

有的数据我们需要循环展示，比如一个table的多个tr，ctemplate本身不支持循环，需要C++来控制循环，核心思想是多次Insert Section，示例模板如下：

1. {{#TEST_TABLE}}
   
2. <table>
   
3.   {{#TEST_TABLE_ITEM}}
   
4.   <tr>
   
5.     <td>{{INDEX}}</td>
   
6.     <td>{{NAME}}</td>
   
7.     <td>{{AGE}}</td>
   
8.   </tr>
   
9.   {{/TEST_TABLE_ITEM}}
   
10. </table>
    
11. {{/TEST_TABLE}}
    
12. 对于这个模板，我们先显示外面的这个Section，然后再循环多次Insert里面的子Section就可以了，代码如下：
    
13. 
    
14. #include <cstdlib>
    
15. #include <iostream>  
    
16. #include <string>
    
17. #include <ctemplate/template.h>  
    
18. 
    
19. int main() {
    
20.     ctemplate::TemplateDictionary dict("loop");
    
21.     dict.ShowSection("TEST_TABLE");
    
22. 
    
23.     for (int i = 0; i != 3; ++i) {
    
24.         ctemplate::TemplateDictionary *item = dict.AddSectionDictionary("TEST_TABLE_ITEM");
    
25.         item->SetFormattedValue("INDEX", "%d", i);
    
26.         item->SetValue("NAME", "阿牛牛牛牛");
    
27.         item->SetValue("AGE", "保密");
    
28.     }
    
29. 
    
30.     std::string output;
    
31.     ctemplate::ExpandTemplate("loop.tpl", ctemplate::DO_NOT_STRIP, &dict, &output);
    
32.     std::cout << output;
    
33.     return 0;
    
34. }

复制代码

文件包含

对于一个通常的系统来说，一般都有多个模板文件，这多个模板文件之间，有很多相同的部分，比如有同样的header、footer，为了减少重复的代码，并且以后修改的话，只需修改一个地方，我们可以把公共的部分提取出来，然后其它的模板文件包含这个文件。ctemplate很好的支持了文件包含，对于ctemplate来说，包含的文件也是一个Section，模板代码如下：

1. {{>HEADER}}
   
2. 
   
3. {{#TEST_TABLE}}
   
4. <table>
   
5.   {{#TEST_TABLE_ITEM}}
   
6.   <tr>
   
7.     <td>{{INDEX}}</td>
   
8.     <td>{{NAME}}</td>
   
9.     <td>{{AGE}}</td>
   
10.   </tr>
    
11.   {{/TEST_TABLE_ITEM}}
    
12. </table>
    
13. {{/TEST_TABLE}}
    
14. 注意第一行的{{>HEADER}}，这是一个特殊格式的Section，用来表示文件包含。对应的C++代码如下：
    
15. 
    
16. #include <cstdlib>
    
17. #include <iostream>  
    
18. #include <string>
    
19. #include <ctemplate/template.h>  
    
20. 
    
21. int main() {
    
22.     ctemplate::TemplateDictionary dict("loop");
    
23. 
    
24.     ctemplate::TemplateDictionary *example = dict.AddIncludeDictionary("HEADER");
    
25.     example->SetFilename("./header.tpl");
    
26.     example->SetValue("TITLE", "测试");
    
27.    
    
28.     dict.ShowSection("TEST_TABLE");
    
29. 
    
30.     for (int i = 0; i != 3; ++i) {
    
31.         ctemplate::TemplateDictionary *item = dict.AddSectionDictionary("TEST_TABLE_ITEM");
    
32.         item->SetFormattedValue("INDEX", "%d", i);
    
33.         item->SetValue("NAME", "阿牛牛牛牛");
    
34.         item->SetValue("AGE", "保密");
    
35.     }
    
36. 
    
37.     std::string output;
    
38.     ctemplate::ExpandTemplate("loop.tpl", ctemplate::DO_NOT_STRIP, &dict, &output);
    
39.     std::cout << output;
    
40.     return 0;
    
41. }

复制代码

通过上面的三个示例，掌握了ctemplate的基本使用、循环、文件包含，应该可以满足90%的需求了，如果有其它的需求的话，可以参考ctemplate的官方文档http://code.google.com/p/ctemplate。