C头文件-划分主要代码

Question

我正在为一项学校作业做我的第一个 "big/medium" 项目，我需要将我的代码分成一些其他的 c 文件。我的疑问是，是拥有许多 files/header 文件且只有少量代码更好，还是拥有更少的 files/header 文件和更多 code/functions 文件更好？

谢谢！

p.s。我是一个新手程序员，所以耐心点，尽量解释得通俗易懂。

Answer 1

我的经验是，根据功能将代码分组到 source/headers 中可以提高理解、测试、维护和重用代码的能力。

每个文件中的代码量实际上取决于封装功能的复杂程度。例如，我有一个源文件，其中包含用于创建和附加到 WAV 文件的函数。它们相对较小，而且因为它们具有内聚性，所以我可以在任何需要创建 WAV 文件的项目中使用它们，而不会带来很多其他负担。其他文件可能很大（或非常大），但如果功能是内聚的，我会得到同样的好处。

当我开始这样做时，有一件让我感到困惑的事情是“多次包含”，这是由于在项目中多次包含相同的 header 而没有“保护”它。既然你说你是新手，我将添加一个快速示例，说明你可以采取哪些措施来防止它发生。

/**
   @file  my_header.h  
*/

ifndef  MY_HEADER_H // <- Prevents multiple inclusions
#define MY_HEADER_H // <- ...

#ifdef __cplusplus  // <- Allows this to be called from c++
extern "C" {        // <- See "name mangling for more info.
#endif              // <- ...

/**************************/
// your stuff goes here

struct my_struct
{
   // ...
};

// function prototypes, etc.

/**************************/
#ifdef __cplusplus
}
#endif

#endif // MY_HEADER_H

C头文件-划分主要代码

C Header Files - Dividing the main code

c

header-files