C语言编程规范

﹏ヽ暗。殇╰゛Y 2022-11-12 09:52 221阅读 0赞

# 1. 编译 #

a) 编译-0错误
    b) 编译-0警告

# 2. 代码整洁 #

a) **代码整洁-文件中各类元素分类放在一起。按顺序：头文件、宏定义、类型定义、静态变量定义、静态函数声明、函数定义**

b) 代码整洁-局部变量定义放在函数开始位置（misra-c）
    c) 代码整洁-缩进4空格，禁用制表符tab
    d) 代码整洁-代码缩进不超过 4 级
    e) 代码整洁-宏定义对齐。例如：
    f) 代码整洁-变量定义对齐。例如：
    INT32   val1    = 1;
    UINT32  val22   = 2U;
    CHAR    val333  = '\0';

# 3. 表达式 #

a) 表达式-多种运算符，必须加括号（misra-c）。例如：
    ( ( a + ( b * c ) ) > d )
    b) 表达式-运算变量、常量类型需要一致，强转无效（misra-c）。尽量保持一致
    c) 表达式-禁用指针类型和整数类型转换

# 4. 宏定义 #

a) 宏定义-宏名首字符不为下划线_ （misra-c）
    b) 宏定义-常数必须加括号。例如：
    #define ABC     ( 1U )
    c) 宏定义-参数必须加括号。例如：
    #define MIN(a,b)     ( ((a)<(b)) ? (a) : (b) )

# 5. 类型定义 #

a) 类型定义-尽量不使用枚举enum，用宏代替
    b) 类型定义-类型名首字符不为下划线_ （misra-c）
    c) 类型定义-结构体中禁用枚举

# 6. 变量定义 #

a) 变量定义-必须制定整数变量位长。 使用 INT32 UINT8，禁用 INT UINT
    b) 变量定义-使用封装类型。 使用 INT32 INT16 CHAR，禁用 int short char
    c) 变量定义-变量名首字符不为下划线_ （misra-c）
    d) 变量定义-无符号常整数后须携带后缀 U 或 u （misra-c）
    e) 变量定义-不允许使用系统预留名 （misra-c）。 例如： err system time 等

# 7. 可见性 #

a) 可见性-所有外部接口函数用 extern 修饰
    b) 可见性-不允许 extern 使用外部变量
    c) 可见性-外部函数必须通过头文件导入，不私用 extern
    d) 可见性-所有全局变量必须为静态static
    e) 可见性-内部函数必须修饰 static

# 8. 流控制 #

a) 流控制-一个函数只允许一个 return （misra-c）。原有代码慢慢改，新代码按这个要求。
    b) 流控制-不允许使用 goto （misra-c）
    c) 流控制-循环中不允许有 break （misra-c）

1.  返回值  
    a) 返回值-代表错误码的返回值必须处理  
    b) 返回值-不处理返回值，必须用(VOID)修饰（misra-c）。例如：  
    (VOID)memset( ptr, 0, 16U );