C 语言数据结构的封装方法

本文是C语言封装设计的第三篇文章，前两篇请见《C 语言面向对象的封装方式》和《 C语言面向对象的封装方式(示例)》。

本文介绍C语言中如何封装数据结构，让调用者可以引用这个数据结构，但无法获知这个数据结构的内部构成，也无法读写这个数据结构的成员变量。

解决这个问题，常见的手法是提供一个new_xxx 函数，返回一个数据结构的指针。
比如，数据结构为 dlist_t, 那么在 dlist.h和dlist.c中定义如下：

// dlist.h
#ifndef DLIST_H
#define DLIST_H

typedef struct dlist_t dlist_t;

dlist_t* new_dlist();

int dlist_init(dlist_t* plist, uint64_t capacity);
int dlist_destroy(dlist_t* plist);

int dlist_append(dlist_t* plist, void* pdata);
// .....

#endif

dlist​.c 中的源码为：

// dlist.c
#include "dlist.h"

#include <stdlib.h>
#include <string.h>

typedef struct dlist_node_t {
    struct dlist_node_t* pprev;
    struct dlist_node_t*