结构体中的宏定义

下面代码是ACL库中的一个示例

 
 struct ACL_XML {
    /* public */
    int   depth;                    /**< 最大深度 */
    int   node_cnt;                 /**< 节点总数, 包括 root 节点 */
    int   root_cnt;                 /**< 根节点个数 */
    int   attr_cnt;                 /**< 属性总数 */
    ACL_XML_NODE *root;             /**< XML 根节点 */

    /* private */
    ACL_HTABLE *id_table;           /**< id 标识符哈希表 */
    ACL_XML_NODE *curr_node;        /**< 当前正在处理的 XML 节点 */
    ACL_DBUF_POOL *dbuf;            /**< 内存池对象 */
    ACL_DBUF_POOL *dbuf_inner;      /**< 内部分布的内存池对象 */
    size_t dbuf_keep;               /**< 内存池中保留的长度 */
    size_t space;                   /**< 在创建 xml 对象时已分配的内存大小 */

    unsigned flag;                  /**< 标志位: ACL_XML_FLAG_xxx */ 

    /**< 是否允许一个 xml 文档中有多个根节点,内部缺省为允许 */
#define ACL_XML_FLAG_MULTI_ROOT (1 << 0)

    /**< 是否兼容单节点中没有 '/' 情况 */
#define ACL_XML_FLAG_IGNORE_SLASH   (1 << 1)

    /**< 是否需要对文本数据进行 xml 解码  */
#define ACL_XML_FLAG_XML_DECODE     (1 << 2)

    /**< 创建 xml 对象时是否需要对数据进行 xml 编码 */
#define ACL_XML_FLAG_XML_ENCODE     (1 << 3)

    ACL_VSTRING *decode_buf;        /**< 当需要进行 xml 解码时非空 */

    /* public: for acl_iterator, 通过 acl_foreach 可以列出所有子节点 */

    /* 取迭代器头函数 */
    ACL_XML_NODE *(*iter_head)(ACL_ITER*, ACL_XML*);
    /* 取迭代器下一个函数 */
    ACL_XML_NODE *(*iter_next)(ACL_ITER*, ACL_XML*);
    /* 取迭代器尾函数 */
    ACL_XML_NODE *(*iter_tail)(ACL_ITER*, ACL_XML*);
    /* 取迭代器上一个函数 */
    ACL_XML_NODE *(*iter_prev)(ACL_ITER*, ACL_XML*);
};

作用

把宏定义放在结构体中,主要目的是方便阅读,提升代码的可读性。从语法层面上来看并没有什么特别含义。

你可能感兴趣的:(结构体中的宏定义)