10、ctemplate文档，简记(3)

1、AddSectionDictionary(section_name) returns a sub-dictionary associated with the given section_name (for instance, dict.AddSectionDictionary("MYSECT") for a template like {{#MYSECT}}...{{/MYSECT}}).

    多次调用，每次将返回新字典。每一次调用该函数，这个section将被展示一次。如果从没有调用过该函数，则section区域数据将不显示。

2、ShowSection() 用来显示section中的文字exactly once. It is equivalent to calling AddSectionDictionary() once, and ignoring the returned sub-dictionary. All variables in the section will depend on dictionary inheritence to get their values.（继承值）

3、SetValueAndShowSection() used to show a section if and only if a related variable is set to a non-empty value. SetValueAndShowSection(name, value, section_name) is equivalent to this: if value is empty do nothing, otherwise add a single dictionary to section_name and call section_dict->AddValue(name, value).

文档中有例子，还没有发现他有什么作用。

4、AddIncludeDictionary(section_name) returns a sub-dictionary associated with the given include_name (for instance, dict.AddIncludeDictionary("MYTPL") for a template like {{>MYTPL}}).

这个函数类同AddSectionDictionary，多次调用，每次返回新字典。调用之后，要记得调用SetFilename。

5、Dump() and DumpToString() 用来调试。

6、The TemplateCache Class

holds a collection of templates.

7、老版本使用方法：

Template* tpl = Template::GetTemplate(filename, strip_mode);

TemplateDictionary dict(name);

tpl->Expand(&dict, &outstring);

新版本使用：

  std::string output;

  ctemplate::ExpandTemplate("example.tpl", ctemplate::DO_NOT_STRIP, &dict, &output);

  std::cout << output;

8、还可以通过指定AUTOESCAPE来指定模板的编码方法：

{{%AUTOESCAPE context="HTML"}}

9、还有类似lint的开发工具make_tpl_varnames_h。

10、An included template is just a section whose contents are located in a separate file. You may iterate over it just like you do sections.

11、Since sections are hidden by default, you can use represent if-else logic in your code via ShowSection. For example:

     if ( my_test ) {

        dict->ShowSection(kxyz_TRUE_BLOCK);

        [ more code to fill the values for that section]

     } else {

        dict->ShowSection(kxyz_FALSE_BLOCK);

        [ more code to fill the values for that section]

     }

参考

【1】 http://google-ctemplate.googlecode.com/svn/trunk/doc/reference.html