C语言的不完整类型和前置声明（转）

声明与定义（Declaration and Definition）

开始这篇文章之前，我们先弄懂变量的declaration和definition的区别，即变量的声明和定义的区别。

一般情况下，我们这样简单的分辨声明与定义的区别：建立存储空间的声明称之为“定义”，而把不需要建立存储空间的称之为“声明”。

其实更为准确地描述的话，变量的声明可以分为两种情况：

（1）一种是需要建立存储空间的。例如：int a;在声明的时候就已经建立了存储空间。这种声明是定义性声明（defining declaration）。即我们平时所说的“定义”；

（2）另一种是不需要建立存储空间的，只是告诉编译器某变量已经在别处定义过了。例如：extern int a;其中，变量a是在别处定义的。这种声明是引用性声明（referning declaration）。即我们平时所说的“声明”。

所以，从广义的角度来说，声明中包含着定义，但是并非所有的声明都是定义。即，定义性声明既是定义又是声明，而引用性声明只是声明。例如，int a;它既是定义又是声明，而extern int a;就只是声明而不是定义。再来看具体的例子：

1 int a;        // 定义性声明，分配存储空间，初值不确定  
2 int b = 0;    // 定义性声明，分配存储空间，赋初值  
3 extern int c; // 引用性声明，不分配存储空间，只是告诉编译器变量c在别处分配过了

C语言类型（C Types）

C语言将类型分为三类（C99 6.2.5）：

Types are partitioned intoobject types(types that fully describe objects),function types(types that describe functions), andincomplete types(types that describe objects but lack information needed to determine their sizes).

（1）对象类型（object types）：对象的大小（size）、内存布局（layout）和对齐方式（alignment requirement）都很清楚的对象。

（2）不完整类型（incomplete types）：与对象类型相反，包括那些类型信息不完整的对象类型（incompletely-defined object type）以及空类型（void）。

（3）函数类型（function types）：这个很好理解，描述函数的类型 -- 描述函数的返回值和参数情况。

这里我们详细了解下不完整类型。先看哪些情况下一个类型是不完整类型：

再看标准的说明：

The void type comprises an empty set of values; it is an incomplete type that cannot be completed. （C99 6.2.5/19）

An array type of unknown size is an incomplete type. It is completed, for an identiﬁer of that type, by specifying the size in a later declaration (with internal or external linkage). A structure or union type of unknown content (as described in 6.7.2.3) is an incomplete type. It is completed, for all declarations of that type, by declaring the same structure or union tag with its deﬁning content later in the same scope.（C99 6.2.5/22）

总结如下

（1）具体的成员还没定义的结构体（共用体）

（2）没有指定维度的数组（不能是局部数组）

（3）void类型（it is an incomplete type that cannot be completed）

sizeof操作符不可以用于不完整类型，也不可以定义不完整类型的数组

为什么要有不完整类型

或者说不完整类型有哪些作用，C里为什么要有不完整类型？

可以这么说，C的不完整类型是提供给C实现封装抽象的唯一工具（这样说，不知道是不是有些武断，欢迎批评指正哈）。

举个例子，我们可以在list.c中定义

1 struct __list {  
2     struct __list *prev;  
3     struct __list *next;  
4     viud      *data;  
5 };

在list.h中这样：

1 typedef struct __list *list_t;

这样的话，链表结构的具体定义对用户来说就是透明的了，不能直接的访问结构成员，只能提供相应的接口来供访问，这样做的好处显而易见，可以防止用户随意破坏模块内部的抽象数据类型。

示例：

libevent中：

1 //event2/event.h
2 
3 struct event_base
4 #ifdef EVENT_IN_DOXYGEN_
5 {/*Empty body so that doxygen will generate documentation here.*/}
6 #endif
7 ;

 1 //event-internel.h
 2 
 3 struct event_base {
 4     /** Function pointers and other data to describe this event_base's
 5      * backend. */
 6     const struct eventop *evsel;
 7     /** Pointer to backend-specific data. */
 8     void *evbase;
 9 ...
10 }

外部使用libevent库时，只需要inclued <event2/enent.h>，这样可以得到不透明的event_base实例并进行使用，并且完全不会对event_base的内部变量有任何改动。要对event_base进行操作的话只能使用libevent的函数，而内部函数使用event_base时则会include <event-internel.h>，从而能够获取到event_base的实际结构。

不完整类型的缺点

（1）使用不完整类型的话，我们也就只能使用指向该不完整类型的指针了，因为指针类型是平台相关的，即在特定的平台上指针变量的大小是已知的。

（2）在不完整类型还没有完整之前，sizeof操作符是获取不了该类型的大小的。

（3）头文件中我们也是不可以使用inline函数的，因为类型是不完整的，在inline函数中如果访问成员的话，编译器会报错。

前置声明（forward declaration）

*上的定义是：

In computer programming, a forward declaration is a declaration of an identifier (denoting an entity such as a type, a variable, or a function) for which the programmer has not yet given a complete definition. It is required for a compiler to know the type of an identifier (size for memory allocation, type for type checking, such as signature of functions), but not a particular value it holds (in case of variables) or definition (in the case of functions), and is useful for one-pass compilers. Forward declaration is used in languages that require declaration before use; it is necessary for mutual recursion in such languages, as it is impossible to define these functions without a forward reference in one definition. It is also useful to allow flexible code organization, for example if one wishes to place the main body at the top, and called functions below it.

我们可以从上面定义中提取出如下信息:
（1）前置声明是针对类型，变量或者函数而言的
（2）前置声明是个不完整的类型
（3）前置声明会加快程序的编译时间

其实上面的typedef struct __list *list_t;就是建立在前置声明基础上的。

前置声明有哪些作用

（1）前置声明可以有效的避免头文件循环包含的问题，看下面的例子

1 // circle.h  
2 #include "point.h"  
3   
4 struct circle {  
5     struct coordinate center;  
6 };

1 // point.h  
2 #include "circle.h"  
3   
4 struct coordinate {  
5     struct circle cir;  
6 };

1 #include "circle.h"  
2   
3 int main(int argc, const char *argv[])  
4 {  
5     struct circle cir;  
6     return 0;  
7 }

如果编译这个程序，你会发现因为头文件循环包含而发生编译错误，即使修改头文件如下也还是不行：

1 #ifndef __CIRCLE_H__  
2 #define __CIRCLE_H__  
3 // circle.h  
4 #include "point.h"  
5   
6 struct circle {  
7     struct coordinate center;  
8 };  
9 #endif

1 #ifndef __POINT_H__  
2 #define __POINT_H__  
3 // point.h  
4 #include "circle.h"  
5   
6 struct coordinate {  
7     struct circle cir;  
8 };  
9 #endif

这个时候就可以使用前置声明轻松的解决这个问题，但是必须要使用指向不完整类型的指针了。

 1 #ifndef __CIRCLE_H__  
 2 #define __CIRCLE_H__  
 3 // circle.h  
 4 //#include "point.h"  
 5   
 6 struct coordinate;  
 7 struct circle {  
 8     struct coordinate *center;  
 9 };  
10 #endif

 1 #ifndef __POINT_H__  
 2 #define __POINT_H__  
 3 // point.h  
 4 //#include "circle.h"  
 5   
 6 struct circle;  
 7 struct coordinate {  
 8     struct circle *cir;  
 9 };  
10 #endif