C语言编程规范

2018 /10

图片来源于网络

C语言入门到精通

公众号

闫小林

C是一门朴素的语言,它是大部分程序员的入门语言,那么C语言的常见编程规范都有哪些呢

1

头文件:

1.头文件中适合放置接口的声明,不适合放置实现

2.头文件应向稳定的方向包含,产品依赖于平台,平台依赖于标准库

3. .c/.h文件禁止包含用不到的头文件

4.每一个.c文件应有一个同名.h文件,用于声明需要对外公开的接口

5.禁止头文件循环依赖

6.头文件应当自包含(任意一个头文件均可独立编译)

7.禁止在extern"C"中包含头文件

8.禁止在头文件中定义变量,如果头文件被其他文件包含,会引发重复定义

9.只能通过包含头文件的方式使用其他.c提供的接口,禁止在.c中通过extern的方式使用外部函数接口、变量

10.如果一个模块包含多个子模块,则建议每一个子模块提供一个对外的.h,文件名为子模块名,降低接口使用者的编写难度

2

编码:

1.函数不变参数使用const

2.全局变量应增加“g_”前缀

3.静态变量应增加“s_”前缀

4.在源文件范围内声明和定义的所有函数,除非外部可见,否则应该增加static关键字

5.函数调用不要作为另一个函数的参数使用,否则对于代码的调试、阅读都不利

6.函数break,return时一定要注意资源的释放,比如释放申请的内存、释放锁

3

禁止内存操作越界:

1.使用memcpy/memset时一定要确保长度不要越界

2.字符串考虑最后的'\0',确保所有字符串是以'\0'结束

3.指针加减操作时,考虑指针类型长度

4.数组下标进行检查

5.使用时sizeof或者strlen计算结构/字符串长度,避免手工计算

6.数组的大小要考虑最大情况,避免数组分配空间不够

C语言入门到精通

4

禁止内存泄漏:

1.异常出口处检查内存、定时器/文件句柄/Socket/队列/信号量/GUI等资源是否全部释放

2.删除结构指针时,必须从底层向上层顺序删除

3.使用指针数组时,确保在释放数组时,数组中的每个元素指针是否已经提前被释放了

4.避免重复分配内存

5.小心使用有return、break语句的宏,确保前面资源已经释放

6.检查队列中每个成员是否释放

5

禁止引用已经释放的内存空间:

1.内存释放后,把指针置为NULL;使用内存指针前进行非空判断

2.耦合度较强的模块互相调用时,一定要仔细考虑其调用关系,防止已经删除的对象被再次使用

3.避免操作已发送消息的内存

4.自动存储对象的地址不应赋值给其他的在第一个对象已经停止存在后仍然保持的对象(具有更大作用域的对象或者静态对象或者从一个函数返回的对象)

END

原文发布于微信公众号 - C语言入门到精通(yclzl960229)

原文发表时间:2018-10-22

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

扫码关注云+社区

领取腾讯云代金券