分享

Minus-C

 quasiceo 2016-07-15

Minus-C 一个最小化的C语言规范

资深C++程序员都不会对C++编程规范太陌生,C++实在太复杂,以至于所有项目都需要裁剪一个子集共项目组内使用。经过在家休息这一小段时间,我发现其实C语言更需要一个相同的规范,这就是本文的目标,最大可能规避C语言的黑暗面。

这里说的“不支持、不使用”,是指在没有明确要求的程序中,不主动使用。但在特殊场景下(如调用外部接口等),有些黑暗的角落我们还是要去了解。

大体上分成这几个部分,这些有些还是只是一个初步的想法,逐步会进一步扩充和裁剪。

1.语言标准和编译器

如果我说出建议使用C99和GCC是不是有很多人长叹一口气,不过C99事实只用到了很少一点特性,大部分编译器都支持,比如说//注释。选择GCC是因为它广范的可获得性和一致性,而主要以GCC做为一个验证标准来看待。

2.文件格式

这部分只要求两点,一是包含基准头文件,stdc99.h。C语言的头文件实在不标准。二是使用前注释,而不是行注释和后注释。

3.数据类型选择

只选用char, unsigned char, int 这几个基本类型,64位系统程序中应该还要增加一个long long 。

不使用typedef的结构体和指针,即结构体都有前缀struct 。

不使用共用体。

不使用enum类型,但使用enum来定义常量。

数组类型,需要要特别说明,不强制使用。

只在有明确要求的地方使用double类型,小心不精确的表示。

4.函数使用

一般不使用malloc,以静态分配为主,必须进行动态内存管理时,必须使用这四个一组的函数完成。

xxxalloc/xxxsize/xxxfree/xxxextend

不使用scanf/printf这种内嵌的语言。

不使用(...)式的可变参数,除非可变参数是同一类型。

5.表达式

接受使用+,-,*,/

除提领‘*’外,不接受++与其它运算符同时出现。

不使用&,|,^,~,<<,>>,见后面“位操作”

不使用?:

不使用","逗号表达式,但接受在声明和函数参数中使用。

6.位操作

由于位操作在有符号问题上操作复杂,推荐使用以下函数形式的宏,完成位操作。u/s分别表示unsigned和signed

ushfleft,ushfright,uset,uclear,uisset,umask

sshfleft,sshfright,sset,sclear,sisset,smask

7.语句

不使用do ... while/switch...case,推荐使用if else/while。

对于数组循环处理,推荐使用for (int i = 0; i < n; ++i) 这个标准结构,必要的索引通过第二个变量计算出来。

8.数组

使用数组+长度两个变量来表示一个数组。

除首地址外,建议其它元素地址使用&a[i]结构来取得。

数组循环处理使用标准结构,例如,奇数索引的元素赋值为1:

for (int i = 0; i < n; ++i) {

  a[2*i + 1] = 1;

}

9.抽象数据

进程有唯一性的抽象(全局状态),定义为模块。

通过void foo_init(void)或void foo_init(int argc, char** args)这样的函数初始化。

通过void foo_close()这样的函数关闭,通常这些调用会在main函数中完成。

一般在头文件中声明为:

struct foo;

struct foo* foo_new();

void foo_dosomething(struct foo* o, void* error);

在C文中定义访问struct foo和访问内部成员的函数

#include "namespace/foo.h"

struct foo {

  成员

};

10.动态抽象数据

头文件中增加声明

struct foo_ops {

  void (*op1)(void);

      void (*op2)(void);

};

struct foo* foo_new(struct foo_ops* ops, void* data);

对应的C文中,在struct foo中要增加定义

struct foo {

  struct foo_ops *ops;

  void* data;

  其它成员

};

11.错误处理机制

主机制可以通过setjmp/longjmp这样的全局状态完成,这应由main函数完成。

程序库内部应提供非侵入式的错误处理机制,例如返回错误状态,惯例如下:

int parse_options(int argc, char** args, struct error* err);

错误状态保存在err中,如果不关心错误,可以通过传入0来忽略,但函数本身应把状态记录在全局的错误对象上。 在前一个错误未清除的情况,函数应没有动作,也不修改全局错误对象。输入了错误指针时,把全局对象复制给错误指针。

12.其它杂项和风格问题

不应忽略{},总是使用{}来表明范围。

使用//注释,C99支持

使用按需声明变量,C99支持

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多