四级上机编程修养

1、版权和版本

ALt="四级上机编程修养" title="四级上机编程修养">

———————

好的程序员会给自己的每个函数，每个文件，都注上版权和版本。

对于C/C 的文件，文件头应该有类似这样的注释：

/************************************************************************

*

* 文件名：network.c

*

* 文件描述：网络通讯函数集

*

* 创建人： Hao Chen, 2003年2月3日

*

* 版本号：1.0

*

* 修改记录：

*

*

************************************************************************/

而对于函数来说，应该也有类似于这样的注释：

/*================================================================

*

* 函 数 名：XXX

*

* 参 数：

*

* type name [IN] : descripts

*

* 功能描述:

*

* ..............

*

* 返 回 值：成功TRUE，失败FALSE

*

* 抛出异常：

*

* 作 者：ChenHao 2003/4/2

*

*

================================================================*/

这样的描述可以让人对一个函数，一个文件有一个总体的认识，对代码的易读性和易维护

性有很大的好处。这是好的作品产生的开始。

2、缩进、空格、换行、空行、对齐

————————————————

i) 缩进应该是每个程序都会做的，只要学程序过程序就应该知道这个，但是我仍然看过不

缩进的程序，或是乱缩进的程序，如果你的公司还有写程序不缩进的程序员，请毫不犹豫

的开除他吧，并以破坏源码罪起诉他，还要他赔偿读过他程序的人的精神损失费。缩进，

这是不成文规矩，我再重提一下吧，一个缩进一般是一个TAB键或是4个空格。(最好用TAB

键)

ii) 空格。空格能给程序代来什么损失吗?没有，有效的利用空格可以让你的程序读进来

更加赏心悦目。而不一堆表达式挤在一起。看看下面的代码：

ha=(ha*128 *key )%tabPtr->size;

ha = ( ha * 128 *key ) % tabPtr->size;

有空格和没有空格的感觉不一样吧。一般来说，语句中要在各个操作符间加空格，函

数调用时，要以各个参数间加空格。如下面这种加空格的和不加的：

if ((hProc=OpenProcess(PROCESS_ALL_ACCESS,FALSE,pid))==NULL){

}

if ( ( hProc = OpenProcess(PROCESS_ALL_ACCESS, FALSE, pid) ) == NULL ){

}

iii) 换行。不要把语句都写在一行上，这样很不好。如：

for(i=0;i’9’)&&(a[i]<’a’||a[i]>’z’)) break;