c语言通用编码规范 (c语言编码变量命名规则)

编号

5.1.1.b

标题

每个源文件应以文件头开始,文件头中应填写"文件名"、"描述"和版权声明。

语言

C

级别

8

类别

概念模型

规范说明

文件头中应提供足够的信息,以便在不阅读源代码的情况下能够理解功能。版权声明描述了文件的法律所有权。

在编辑源文件时,可以考虑更新版权头:

  • 对于大型更改,请考虑将当前年份添加到版权年份中(参见下面的示例)
  • 确保公司名称正确

您声明的年份应该是创建该作品的年份。如果更改足够重大以赋予新的版权,则还应该提及该年份。最重要的年份是第一年。

当软件开发人员遇到旧的或错误的版权声明存在于现有的源文件中时,他们应该:

  • 在不更改文件时保持原样
  • 更新为最新的模板
  • 保留原始的版权年份,这样你可能会得到1995-2003,2021

示例

/*------------------------------------------------------------------------------
|
| C 模块
|
|-------------------------------------------------------------------------------
|
| 文件名 : CC_module.c
| 描述: