文档介绍:C/C++源代码书写规范
精选ppt
1. /.cpp的开头应有一段格式统一的说明,内容包括:
a. 文件名 (FileName);
b. 创建人 (Creator);
c. 文件创建时间 (Date);
d.
例:可写做:
int* pnsize;
也可写做:int *pnsize;
但不得写做:int * pnsize;
精选ppt
6. 在类的成员函数内调用非成员函数时,在非成员函数名前必须加上"::"。 例:::Sleep(2000);
精选ppt
7. 函数入口参数有缺省值时,应注释说明。 例: BOOL KSSaveToFile( const char cszFileName[], BOOL bCanReplace /* = TRUE */ );
或者: BOOL KSSaveToFile( const char cszFileName[], BOOL bCanReplace // = TRUE );
精选ppt
8. else if 必须写在一行。
精选ppt
9. 与‘{’、‘}’有关的各项规定:
‘{’、‘}’应独占一行。在该行内可有注释。 例:正确:
for (i = 0; i < cbLine; i++)
{ // .....
printf("Line %d:", i);
printf("%s\n", pFileLines); }
不得写做: for (i = 0; i < cb; i++)
{ printf("Line %d:", i);
printf("%s\n", pFileLines); }
精选ppt
‘{’必须另起一行,‘{’之后的代码必须缩进一个Tab。‘{’与‘}’必须在同一列上。
例:正确:
if (i > 0)
{
m = 1;
n++;
}
精选ppt
不得写做: if (i > 0) {
m = 1; n++;
}
例外:
if (i == 0)
{ ASSERT(FALSE); return; }
精选ppt
在循环、分支之后若只有一行代码,虽然可省略‘{’、‘}’,但不推荐这么做。若省略后可能引起歧义,则必须加上‘{’、‘}’。
例:正确:
if (n == -2)
n = 1;
Else
n = 2;
精选ppt
或者:
if (n == -2)
{ n = 1; }
else if (n != nTemp)
{ n = 2; }
else
{ n = 3; }
精选ppt
不得写做:
if (n == -2)
n = 1;
else if (n != nTemp)
n = 2;
else
n = 3;
精选ppt
不推荐:
if (i < 1)
{ n = 1; }
else
{
if (i == 1)
{ n = 2; }
else {
if (i > 1) { n = 3; }
}
}
精选ppt
10. 与空格有关的各项规定。
在所有两目、三目运算符的两边都必须有空格。在单目运算符两端不必空格。但在‘->’、‘::’、‘.’、‘[’、‘]’等运算符前后,及‘&’(取地址)、‘*’(取值)等运算符之后不得有空格。
精选ppt
例:正确:
int n = 0, nTemp;
for (int i = nMinLine; i <= nMaxLine; i++)
不得写做:
int n=0, nTemp;
for ( int i=nMinLine; i<=nMaxLine; i++ )
精选ppt
for、while、if 等关键词之后应有1个空格,再接‘(’,之后无空格;在结尾的‘)’前不得有空格。
例:正确:
if (-2 == n)
不得写做:
if(-2 == n)
或 if ( -2 == n ) 等等。
精选ppt
调用函数、宏时,‘(’、‘)’前后不得有空格。
例:正确:
printf("%d\n", nIndex);
不得写做:
printf ("%d\n", nIndex);
printf( "%d\n", nIndex ); 等等。
精选ppt
类型强制转换时,‘(’‘)’前后不得有空格 例:可写做:
(KSFile*)pFile;
也可写做:
(KSFile *)pFile
不得写做:
( KSFile* )pFile ( KSFile * ) pFile
精选ppt
11. 与缩进有关的各项