欢迎来到天天文库
浏览记录
ID:34486675
大小:375.54 KB
页数:10页
时间:2019-03-06
《完整版linux内核代码风格》由会员上传分享,免费在线阅读,更多相关内容在教育资源-天天文库。
1、Linux内核代码风格——dashsoft这是一个简短的文档,描述了linux内核的首选代码风格。代码风格是因人而异的,而且我不愿意把我的观点强加给任何人,不过这里所讲述的是我必须要维护的代码所遵守的风格,并且我也希望绝大多数其他代码也能遵守这个风格。请在写代码时至少考虑一下本文所述的风格。首先,我建议你打印一份GNU代码规范,然后不要读它。烧了它,这是一个意义重大的象征性的动作。不管怎样,现在我们开始:第一章:缩进制表符是8个字符,所以缩进也是8个字符。有些异端运动试图将缩进变为4(乃至2)个字符深,这几乎相当于尝试将圆周率的值定义为3。理由:缩进的全部意义就在于
2、清楚的定义一个控制块起止于何处。尤其是当你盯着你的屏幕连续看了20小时之后,你将会发现大一点的缩进将会使你更容易分辨缩进。现在,有些人会抱怨8个字符的缩进会使代码向右边移动的太远,在80个字符的终端屏幕上就很难读这样的代码。这个问题的答案是,如果你需要3级以上的缩进,不管用何种方式你的代码已经有问题了,应该修正你的程序。简而言之,8个字符的缩进可以让代码更容易阅读,还有一个好处是当你的函数嵌套太深的时候可以给你警告。留心这个警告。在switch语句中消除多级缩进的首选的方式是让“switch”和从属于它的“case”标签对齐于同一列,而不要“两次缩进”“case”标
3、签。比如:switch(suffix){case'G':case'g':mem<<=30;break;case'M':case'm':mem<<=20;break;case'K':case'k':mem<<=10;/*fallthrough*/default:break;}不要把多个语句放在一行里,除非你有什么东西要隐藏:if(condition)do_this;do_something_everytime;也不要在一行里放多个赋值语句。内核代码风格超级简单。就是避免可能误导别人的表达式。除了注释、文档和Kconfig之外,不要使用空格来缩进,前面的例子是例外,是有
4、意为之。选用一个好的编辑器,不要在行尾留空格。第二章:把长的行和字符串打散代码风格的意义就在于使用平常使用的工具来维持代码的可读性和可维护性。每一行的长度的限制是80列,我们强烈建议您遵守这个惯例。长于80列的语句要打散成有意义的片段。每个片段要明显短于原来的语句,而且放置的位置也明显的靠右。同样的规则也适用于有很长参数列表的函数头。长字符串也要打散成较短的字符串。唯一的例外是超过80列可以大幅度提高可读性并且不会隐藏信息的情况。voidfun(inta,intb,intc){if(condition)printk(KERN_WARNING"Warningthisi
5、salongprintkwith""3parametersa:%ub:%u""c:%u",a,b,c);elsenext_statement;}第三章:大括号和空格的放置C语言风格中另外一个常见问题是大括号的放置。和缩进大小不同,选择或弃用某种放置策略并没有多少技术上的原因,不过首选的方式,就像Kernighan和Ritchie展示给我们的,是把起始大括号放在行尾,而把结束大括号放在行首,所以:if(xistrue){wedoy}这适用于所有的非函数语句块(if、switch、for、while、do)。比如:switch(action){caseKOBJ_AD
6、D:return"add";caseKOBJ_REMOVE:return"remove";caseKOBJ_CHANGE:return"change";default:returnNULL;}不过,有一个例外,那就是函数:函数的起始大括号放置于下一行的开头,所以:intfunction(intx){bodyoffunction}全世界的异端可能会抱怨这个不一致性是……呃……不一致的,不过所有思维健全的人都知道(a)K&R是_正确的_,并且(b)K&R是正确的。此外,不管怎样函数都是特殊的(在C语言中,函数是不能嵌套的)。注意结束大括号独自占据一行,除非它后面跟着同一
7、个语句的剩余部分,也就是do语句中的“while”或者if语句中的“else”,像这样:do{bodyofdo-loop}while(condition);和if(x==y){..}elseif(x>y){...}else{....}理由:K&R。也请注意这种大括号的放置方式也能使空(或者差不多空的)行的数量最小化,同时不失可读性。因此,由于你的屏幕上的新行的供应不是可回收的资源(想想25行的终端屏幕),你将会有更多的空行来放置注释。当只有一个单独的语句的时候,不用加不必要的大括号。if(condition)action();这点不适用于本身为某个条件语句的一个
此文档下载收益归作者所有