clearsilver-C-API文档（HDF部分)

原文地址：http://www.clearsilver.net/docs/c_api.hdf

hdf_set_symlink – 创建HDF数据中两个部分的关联

        NEOERR *hdf_set_symlink (HDF *hdf, const char *src, const char*dest);

*hdf_get_valuef – 获得指定节点数据

        char* hdf_get_valuef (HDF *hdf, const char *namefmt, ...)

hdf_dump_str – 将HDF数据转存到字符串中

        NEOERR* hdf_dump_str(HDF *hdf, const char *prefix, int compact,STRING *str);

hdf_get_int_value – 返回数据结点的数字值的变量值

        int hdf_get_int_value (HDF *hdf, const char *name, int defval);

hdf_read_string_ignore –将HDF格式的字符串设置到HDF中，但忽略错误

        NEOERR* hdf_read_string_ignore (HDF *hdf, const char *s, intignore);

hdf_copy – 将HDF数据中的部分复制到另一个HDF数据结构体中

      NEOERR* hdf_copy (HDF *dest_hdf, const char *name, HDF *src);

hdf_get_node – 和hdf_get_obj类似，如果节点不存在将会创建

      NEOERR * hdf_get_node (HDF *hdf, const char *name, HDF **ret);

hdf_set_value – 将对应的key设为value值

        NEOERR* hdf_set_value (HDF *hdf, const char *name, const char*value);
hdf_obj_child – 返回数据结构中的第一个节点数据

        HDF* hdf_obj_child (HDF *hdf);

hdf_read_string – 将一个HDF格式的string设置到对就的hdf中

        NEOERR* hdf_read_string (HDF *hdf, const char *s);

hdf_set_buf  --类似hdf_set_value,但是对于value字符串并不复制

        NEOERR* hdf_set_buf (HDF *hdf, const char *name, char *value);

*hdf_register_fileload – 注册一个外部加载函数

        void hdf_register_fileload(HDF *hdf, void *ctx, HDFFILELOADfileload);

hdf_get_obj – 返回指定的节点数据

        HDF* hdf_get_obj (HDF *hdf, const char *name);

*hdf_get_attr— 获得指定名的描述

        HDF_ATTR* hdf_get_attr (HDF *hdf, const char *name);

hdf_obj_top – 返回最顶的节点

        HDF* hdf_obj_top (HDF *hdf);

hdf_dump_format – 将hdf数据转存到文件FILE *fp

        NEOERR* hdf_dump_format (HDF *hdf, int lvl, FILE *fp);

hdf_destroy – 销毁HDF结构体

        void hdf_destroy (HDF **hdf);

hdf_init – 初始化一个HDF数据库

        NEOERR* hdf_init (HDF **hdf);

hdf_obj_value  -- 返回指定节点数据

        char* hdf_obj_value (HDF *hdf);

hdf_write_string – 序列化HDF数据，将它保存到字符串中

        NEOERR* hdf_write_string (HDF *hdf, char **s);

*hdf_sort_obj – 对HDF的子节点进行排序

hdf_write_file_atomic  --与hdf_write_file类似，但是如果给的文件名有重名，就会重新生成一个新的文件名作为保存hdf数据的文件

        NEOERR* hdf_write_file_atomic (HDF *hdf, const char *path);

hdf_obj_attr – 返回指定节点的属性

        HDF_ATTR* hdf_obj_attr (HDF *hdf);

hdf_set_valuef – 给指定的节点设置值（以fmt=”a.2=jsf”的形式）

NEOERR* hdf_set_valuef (HDF *hdf, const char *fmt, ...)
ATTRIBUTE_PRINTF(2,3);

hdf_get_copy – 返回HDF数据中的一个字符串，如果节点不存在则返回字符串defval

        NEOERR* hdf_get_copy (HDF *hdf, const char *name, char**value,const char *defval);
hdf_write_file – 将HDF数据转存到文件中

        NEOERR* hdf_write_file (HDF *hdf, const char *path);

hdf-get-valuevf – 返回HDF数据中指定的一个节点的值，没有默认返回值

        char* hdf_get_valuevf (HDF *hdf, const char *namefmt, va_listap);

hdf_set_int_value – 将指定节点的值转为数字类型

        NEOERR* hdf_set_int_value (HDF *hdf, const char *name, intvalue);

*hdf_dump – 将HDF数据转存为一个标准输出

        NEOERR* hdf_dump (HDF *hdf, const char *prefix);

hdf_get_value --返回HDF数据中指定的一个节点的值，有默认返回值

        char *hdf_get_value (HDF *hdf, const char *name, const char*defval);

hdf_set_copy – 将HDF中指定的一个节点的值赋给指定的另一个节点

        NEOERR* hdf_set_copy (HDF *hdf, const char *dest, const char*src);

hdf_obj_next – 返回下一个节点的数据

        HDF* hdf_obj_next (HDF *hdf);

*hdf_search_path –

        NEOERR* hdf_search_path (HDF *hdf, const char *path, char *full,int full_len);

hdf_obj_name –返回指定HDF对应的名字，例如用hdf_obj_top的返回HDF就可以用它

        char* hdf_obj_name (HDF *hdf);

*hdf_set_attr – 设置属性

        NEOERR* hdf_set_attr (HDF *hdf, const char *name, const char*key,const char *value);

hdf_get_child –返回指定结点的第一个子结点

        HDF* hdf_get_child (HDF *hdf, const char *name);

hdf_remove_tree – 删除HDF数据结构中的一个子结点

        NEOERR* hdf_remove_tree (HDF *hdf, const char *name);

*ne_log –

ne_set_log –设置 log级别，默认为NE_LOG_WARN

        void ne_set_log (int level);

ne_set_log_options – 设置log显示选项

        void ne_set_log_options(int display_options);