c - 当在另一个文件中声明结构时，如何使用结构作为函数的参数？

Question

我正在编写一个 C 项目，并且尝试将所有结构声明保留在相关的 .h 文件中。这允许我通过包含相关 header 在任何 .c 文件中使用它们。我还避免将我的项目的头文件包含在其他头文件中。我想这将使代码更易于阅读和维护。

我的问题是如何避免在使用该结构的头文件中包含包含结构声明的 header 。有什么办法可以做到这一点吗？ (我没有找到这个问题的答案，如果有重复，抱歉)。这是一个片段:

cmd.c

#include "cmd.h"
#include "params.h"     //This allows usage of struct testPars

void move_parameters(struct testPars *testP) {
...
}

cmd.h

#ifndef CMD_H
#define CMD_H
#include "params.h"     //I want to avoid this include in this file

void move_parameters(struct testPars *testP) ;
#endif

params.h

#ifndef PARAMS_H
#define PARAMS_H

struct testPars {
    char    name[16];
    double  value;
};
#endif

Answer 1

总的来说，这里对于正确的程序设计存在很多困惑。

I'm trying to keep all the struct declarations in the relevant .h files. This allows me to use them in any of the .c files by including the relevant header.

对于没有私有(private)封装或者结构性质简单的快速而肮脏的编程来说，这是可以接受的做法。

但是对于结构体代表更复杂的 ADT 等的专业程序，您应该只在头文件中保留前向声明，并在相应的 c 文件中定义结构体。这导致私有(private)封装和模块化，即良好的程序设计。 (搜索“不透明类型”或“不透明指针”的示例。此类前向声明​​的正式术语是不完整类型。)

您尝试做的事情听起来与上面类似，但完全相反:向调用者公开定义，但您自己不要使用它。显然，您不能使用尚未包含且对程序可见的结构，因为这没有任何意义。

I'm also avoiding the inclusion of header files of my project in other header files. I guess this will make the code easier to read and maintain.

这是一个坏主意。每个头文件都应被视为相应 c 文件的用途以及如何使用它的公共(public)文档。虽然c文件可以被视为私有(private)数据，但其内容与调用者无关。

头文件文档的一个重要部分是列出该模块具有的所有依赖项，以便其他程序员可以快速浏览头文件的顶部并立即知道编译此模块所需的文件特定模块。

良好的程序设计力求尽可能减少依赖:“松耦合”。因此，所有#includes都被视为重要信息，应该放在头文件的顶部。不应该包含未使用的头文件。

c 文件不应包含除其自己的头文件之外的任何包含内容。