嵌入式C编码文件头申明规范

编码规范2.1 文件头申明◎ 新增.c必须添加注释,标注公司名称、文件功能说明,创建日期、作者,后续修改说明 范例如下:
/********************************************************************* * copyright (c) hehe,ltd. all rights reserved.* description:用于详细说明此程序文件完成的主要功能,* 与其他模块或函数的接口依赖等关系 ** history:修改历史记录列表,包括修改日期、修改者及修改内容简述 * date author modification: * 2023-11-25 embedded-system create v1.0*********************************************************************/可配置source insight 自动生成模板。
2.2 文件◎ 所有.h头文件必须采取阻止内容被包含多于一次的机制
#ifndef __xxx__#define __xxx__#endif /*__xxx__*/◎ 头文件对外接口,应放置对外部的声明,如对外提供的函数声明、宏定义、类型定义等。
◎ 内部使用的函数声明不应放在头文件中。
◎ 内部使用的宏、枚举、结构定义不应放入头文件中。
◎ 变量定义禁止在头文件中,应放在.c文件中。
◎ 模块内使用的全局变量,不应通过在头文件中声明的方式直接暴露给外部。
◎ 头文件中只包含接口的声明,不含实现。
◎ 头文件应当职责单一,头文件过于复杂,依赖过于复杂是导致编译时间过长的主要原因。
◎ 每一个.c文件应有一个同名.h文件,用于声明需要对外公开的接口。
◎ 禁止头文件循环依赖,禁止包含用不到的头文件。
◎ 每个.c源文件内容片段按如下顺序,文件注释-包含头文件-宏定义-数据结构定义-变量定义-引用外部变量-引用外部函数-本地函数-全局函数。

诺基亚公布其5G商用合同达到100个
荣耀V9评测:华为荣耀V9你不知道的两项功能,还不看看?
区块链永续合约交易所开发币币交易所开发
直流电源的测试与规范
中际联合:风电高空安全作业设备“隐形冠军”
嵌入式C编码文件头申明规范
猎板宣布多层板工艺再次升级
E现场:vivo z5x性能实力派
中国建设银行开设全自动化分行
迅捷GIF制作工具
苹果明年将推AirPods Max运动版
探秘广州亚运安防设施应用
不用任何仪器且达到佳点的寻星方法
有了Android,谷歌为何还要从零开始开发新系统
5G和AI融合将是华为未来发展趋势 华为海思芯片解决方案未来或将开放
重磅!华为云Stack与佳杰云星联合发布云运营联合解决方案
苹果新专利:85-160mm范围内的可折叠相机 超强变焦!
FPGA硬件电路的调试必备原则和技巧
微星RTX 2060 Super与2080 Ti光追性能测试 实时光线追踪是无法绕过的技术
TCL宣布已与JOLED合作开发喷墨印刷OLED电视