结构定义应该放在.h还是.c文件中？

我已经struct在标头中看到了s的完整定义，也看到了声明—一种方法比另一种方法有什么优势吗？

如果有什么不同，我通常会在 .h

typedef struct s s_t;

编辑

为了清楚起见，选项是头文件中的声明和类中的定义，或者头文件中的声明和定义。两者都应该导致相同的可用性，即使是通过链接实现的，不是吗？

我看到很多几乎重复的内容，例如，这里没有完全匹配的内容。如果我在这方面错了，请纠正我。

该文件的私有结构应放在.c文件中，如果.h中的任何函数使用它们，则在.h文件中声明。

公共结构应放在.h文件中。

两者都应该导致相同的可用性，即使是通过链接实现的，不是吗？

不，当您考虑其他具有相同头文件的.c文件时，不可以。如果该结构的定义对于编译器不可见，则无法使用该定义的详细信息。如果没有任何定义（例如，只是一个）的声明，struct s;则会导致编译器在尝试查找内部struct s时失败，同时仍然允许其进行编译struct s *foo;（只要foo以后不取消引用）。

比较这些版本的api.h和api.c：

Definition in header:                 Definition in implementation:
+---------------------------------+   +---------------------------------+
| struct s {                      |   | struct s;                       |
|     int internal;               |   |                                 |
|     int other_stuff;            |   | extern void                     |
| };                              |   | api_func(struct s *foo, int x); |
|                                 |   +---------------------------------+
| extern void                     |   +---------------------------------+
| api_func(struct s *foo, int x); |   | #include "api.h"                |
+---------------------------------+   |                                 |
+---------------------------------+   | struct s {                      |
| #include "api.h"                |   |     int internal;               |
|                                 |   |     int other_stuff;            |
| void                            |   | };                              |
| api_func(struct s *foo, int x)  |   |                                 |
| {                               |   | void                            |
|     foo->internal = x;          |   | api_func(struct s *foo, int x)  |
| }                               |   | {                               |
+---------------------------------+   |     foo->internal = x;          |
                                      | }                               |
                                      +---------------------------------+

该API的客户端可使用以下任一版本：

#include "api.h"

void good(struct s *foo)
{
    api_func(foo, 123);
}

这一章详细介绍了实现细节：

#include "api.h"

void bad(struct s *foo)
{
    foo->internal = 123;
}

它将与“标头中定义”版本一起使用，但不适用于“实现中的定义”版本，因为在后一种情况下，编译器无法看到结构的布局：

$ gcc -Wall -c bad.c
bad.c: In function 'bad':
bad.c:5: error: dereferencing pointer to incomplete type
$

因此，“实施​​中的定义”版本可防止意外或故意滥用私有实施细节。

如果该结构将由其他编译单元（.c文件）使用，请将其放在头文件中，以便可以在需要的地方包括该头文件。

如果该结构仅在一个编译单元（.c文件）中使用，则将其放在该.c文件中。

关键是，将其放在头文件中使您可以通过包含多个头文件来使用多个源文件中的结构（或任何其他定义）。

但是，如果您确定只能从一个源文件中使用它，那么它实际上没有任何区别。

我将它们放到C文件中以使其更加面向对象，请参阅本文。

通常，无论您将它们放在头文件还是源文件中，我都认为并没有太大的区别。但是，如果您需要从多个源文件访问结构的成员，则将结构放置在头文件中并从需要该结构的任何其他文件中包含它会更容易。