C 编程规范要求

C编程规范要求

（1）   文件头

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

       /*  程序题目：1.2 ***

       /*  程序员: 2008**** 张三

       /*  编程时间: 2008-10-30

       /*  程序功能：***

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

（2）    格式

程序必须遵守缩进格式，要求大括号分行写,两个语句不能写在同一行

例如：

  main()

  {

      //

     if (****)

{

   *****;

}

  }

（3）   起名

变量名，函数名等必须望文知意，采用匈牙利变量命名法，不可用a,b,c, i,j,k 之类的简单变量名，除非确实是没有特别意义的练习题

   变量起名规则

l  以小写字母代表变量类型

n 代表整型，f代表实型，c代表字符型，an代表整型数组，af代表实型数组，p代表指针类型，pn代表整型指针类型等等（详见变量起名规则）

l  变量名一般是主谓结构，单词首字母大写

例如： nCharNum, cString, 等等

l  函数名一般是动宾结构，单词首字母大写

例如：PrintStar( ), CalculateLine 等等

（4）   注释

l  变量时候必须有注释，中英文不限，但应该一致

例如： int nNum; //计数器的个数

l  主要功能完成后应该有注释 （每10行之间必有一个注释）

l  函数定义的时候注释规范如下：

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

/*函数名：***

/*输入参数： nStar：星号个数  nPos：换行位置

/*返回值：无

/*函数功能： ****

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

PrintStar(int nStar, int nPos)

{ 

   int nI; //循环变量

   //输出nPos个空格

   for（ nI=1;nI<=nPos;nI++）

      putChar(‘ ‘);

    //输出nStar个*

   for（nI=1;nI<=nStar;nI++）

      putChar(‘* ‘);

 

}

 

（5）   用户界面

l  用户界面必须友好，随时让用户知道程序要求他做什么，怎么做，程序运行到什么状态了。