c语言编程规范.txt

编程规范,各程编程的规范说明,及要注意的问题!

　　引用一: 文件开头的注释模板
/******************************************************************
** 文件名:
** Copyright (c) 1998-1999 *********公司技术开发部
** 创建人:
** 日　期:
** 修改人:
** 日　期:
** 描　述:
**
** 版　本:
**--------------------------------------------------------------------------
---


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

　　引用二: 函数开头的注释模板
/*****************************************************************
** 函数名:
** 输　入: a,b,c
**　　 a---
**　　 b---
**　　 c---
** 输　出: x---
**　　　x 为 1, 表示...
**　　　x 为 0, 表示...
** 功能描述:
** 全局变量:
** 调用模块:
** 作　者:
** 日　期:
** 修　改:
** 日　期:
** 版本
****************************************************************/
　　引用三: 程序中的注释模板
/*----------------------------------------------------------*/
/* 注释内容　　　　　　　　　　　 */
/*----------------------------------------------------------*/
8 程序
a.　　 程序编码力求简洁，结构清晰，避免太多的分支结构及太过于技巧性的程序，
尽量不采用递归模式。
b.　 编写程序时，亦必须想好测试的方法，换句话说，”单元测试” 的测试方案应
在程序编写时一并拟好。
c.　 注释一定要与程序一致。
d.　 版本封存以后的修改一定要将老语句用/* */ 封闭，不能自行删除或修改,并要
在文件及函数的修改记录中加以记录。
e.　　 程序中每个block 的开头 ”{" 及 "}” 必须对齐，嵌套的block 每进一套，
缩进一个tab，TAB 为4个空格,block类型包括if、for、while、do等关键字引出的。
f.　对于比较大的函数，每个block 和特殊的函数调用，都必须注明其功能，举例如下
：
count.divisor = 1193280 / freq;　　　　　　　 //　compute the proper count
OutByte((unsigned short)67, (unsigned char)182);　//　tell 8253 that a
count is coming
OutByte((unsigned short)66, count. c[0]);　　　//　send low-order byte
OutByte((unsigned short)66, count. c[1]);　　　//　send high-order byte

×××××××××××××××××××××××××××××××××××××××
bcb，delphi中的变量命名：
　遵循匈牙利命名法，命
名必须有意义，制定如下规定
　窗体：以大写的W开始，如About版权窗体， 命名为WAbout
文件：以大写的F开始，如About版权窗体，文件命名为FAbout.cpp
按钮(Button)：如退出按钮，命名为btnExit
　……
　基类：加base标记，如报表基类,窗体命名为：WBaseRep, 文件命名为FBaseRep.cpp

转贴
> 1. 在.h/.cpp的开头应有一段格式统一的说明，内容包括：
> a. 文件名 (FileName)；
> b. 创建人 (Creater)；
> c. 文件创建时间 (Date)；
> d. 简短说明文件功能、用途 (Comment)。
好习惯
> 2. 除非极其简单，否则对函数应有注释说明。内容包括：功能、入口/出口参数，必
要
> 时还可有备注或补充说明。
还是好习惯
> 3. 每列代码的长度推荐为 80列，最长不得超过120列；折行以对齐为准。
太宽了，我的限制是60列，因为文本方式下屏幕一共80列，如果你用BC这一类的编辑
器，窗口边框等又要占据一定空间，所以80列太宽
> 4. 循环、分支代码，判断条件与执行代码不得在同一行上。
很对
> 5. 指针的定义，* 号既可以紧接类型，也可以在变量名之前。
>
> 例：可写做：int*　pnsize;
>
> 也可写做：int　*pnsize;
>
> 但不得写做：int　*　pnsize;
建议采用第二种，除非附加另外一条规定：一次只声明一个变量，否则就会让人混淆，
比如：
int* a, b;
看起来b好像也是个指针，其实不是。
> 6. 在类的成员函数内调用非成员函数时，在非成员函数名前必须加上"::"。
这一条我倒觉得并不是必需的，我的看法是决不要让你的类成员函数和全局函数的名称
相同（或类似）
> 7. 函数入口参数有缺省值时，应注释说明。
>
> 例：BOOL CWpsDib::PaintDIB(CDC* pDC, CRect& rc,
>　　　int nBrightness, file://*=0*//
>　　　BOOL bGrayScale file://*=FALSE*// )
每个变量写一行，必要时加上/*in, out*/注释
> 8. else　if 必须写在一行。
应该尽量避免else if这样的结构
> 9. 与‘{’、‘}’有关的各项规定：
>
>　9.1‘{’、‘}’应独占一行。在该行内可有注释。
> 9.2 ‘{’必须另起一行，‘{’ 之后的代码必须缩进一个Tab。‘{’与‘}’必须在
同
> 一列上。
> 9.3 在循环、分支之后若只有一行代码，虽然可省略‘{’、‘}’，但不推荐这么
> 做。若省略后可能引起歧义，则必须加上‘{’、‘}’。
持保留意见，因为GNU的代码规范是这样的：
if ( NULL == ptr )
　　{
　　　　// do something here
　　}
或者
if ( NULL == ptr ) {
　　　　// do something here
}
争论哪个更好并没有意义，关键是统一，如果用VC当然你的办法最方便，可是如果你用
emacs或者vi，就不是这样了。
> 10. 与空格有关的各项规定。
>
> 10.1 在所有两目、三目运算符的两边都必须有空格。在单目运算符两端不必空格。
但
> 在‘—>’、‘::’、‘.’、‘[’、‘]’等运算符前后，及‘&’（取地址）、‘*
> ’（取值）等运算符之后不得有空格。
> 10.2　for、while、if 等关键词之后应有1个空格，再接‘(’，之后无空格；在结
尾
> 的‘)’前不得有空格。

我认为在括号两端加空格并不是什么错误，尤其是在一个条件十分复杂的if语句里
> 10.3 调用函数、宏时，‘(’、‘)’前后不得有空格。
> 10.4　类型强制转换时，‘(’‘)’前后不得有空格
同上
> 11. 与缩进有关的各项规定
>
> 11.1 缩进以 Tab 为单位。1 个 Tab 为 4 个空格
我认为这个值应该更大，我自己使用8个空格，如果你的代码因为缩进幅度太大而导致
折行，那么几乎可以肯定你的程序设计方案有问题。
> 11.2 下列情况，代码缩进一个 Tab:
> 1. 函数体相对函数名及'{'、'}'。
> 2. if、else、for、while、do 等之后的代码。
> 3. 一行之内写不下，折行之后的代码，应在合理的位置进行折行。若有 + - * / 等
运
> 算符，则运算符应在上一行末尾，而不应在下一行的行首。
这一条我反对，运算符应该放在下一行行首，以使人能清楚的知道这一行是续上一行
的，比如
if ( something
　　&& somethingelse
　　&& otherthings )
如果写做
if ( something &&
　　somethingelse &&
　　otherthings )
反而看不清楚
> 11.3 下列情况，不必缩进：switch 之后的 case、default。