高質量C++/C編程指南

文件狀態 [ ] 草稿文件 [√] 正式文件 [ ] 更改正式文件	文件標識：
	當前版本：	1.0
	作    者：	林銳 博士
	完成日期：	2001年7月24日

版本/狀態	作者	參與者	起止日期	備注
V 0.9 草稿文件	林銳		2001-7-1至 2001-7-18	林銳起草
V 1.0 正式文件	林銳		2001-7-18至 2001-7-24	朱洪海審查V 0.9， 林銳修正草稿中的錯誤

/* * Copyright (c) 2001,上海貝爾有限公司網絡應用事業部 * All rights reserved. * * 文件名稱：filename.h * 文件標識：見配置管理計劃書 * 摘    要：簡要描述本文件的內容 * * 當前版本：1.1 * 作    者：輸入作者（或修改者）名字 * 完成日期：2001年7月20日 * * 取代版本：1.0 * 原作者 ：輸入原作者（或修改者）名字 * 完成日期：2001年5月10日 */

// 版權和版本聲明見示例1-1，此處省略。   #ifndef   GRAPHICS_H // 防止graphics.h被重複引用 #define   GRAPHICS_H   #include <math.h>     // 引用標準庫的頭文件 … #include “myheader.h”  // 引用非標準庫的頭文件 … void Function1(…);   // 全局函數聲明 … class Box             // 類結構聲明 { … }; #endif

// 版權和版本聲明見示例1-1，此處省略。   #include “graphics.h”     // 引用頭文件 …   // 全局函數的實現體 void Function1(…) { … }   // 類成員函數的實現體 void Box::Draw(…) { … }

// 空行 void Function1(…) {  … } // 空行 void Function2(…) {  … } // 空行 void Function3(…) {  … }

// 空行 while (condition) {  statement1;  // 空行  if (condition)  {      statement2;  }  else  {      statement3;  } // 空行  statement4; }

int width;    // 寬度 int height;   // 高度 int depth;    // 深度	int width, height, depth; // 寬度高度深度
x = a + b; y = c + d; z = e + f;	X ＝ a + b;   y = c + d; z = e + f;
if (width < height) { dosomething(); }	if (width < height) dosomething();
for (initialization; condition; update) { dosomething(); } // 空行 other();	for (initialization; condition; update)      dosomething(); other();

void Func1(int x, int y, int z);          // 良好的風格 void Func1 (int x,int y,int z);           // 不良的風格

if (year >= 2000)                         // 良好的風格 if(year>=2000)                            // 不良的風格 if ((a>=b) && (c<=d))                     // 良好的風格 if(a>=b&&c<=d)                            // 不良的風格

for (i=0; i<10; i++)                      // 良好的風格 for(i=0;i<10;i++)                         // 不良的風格 for (i = 0; I < 10; i ++)                 // 過多的空格

x = a < b ? a : b;                        // 良好的風格 x=a<b?a:b;                                // 不好的風格

int *x = &y;                              // 良好的風格  int * x = & y;                            // 不良的風格

array[5] = 0;                             // 不要寫成 array [ 5 ] = 0; a.Function();                             // 不要寫成 a . Function(); b->Function();                            // 不要寫成 b -> Function();

void Function(int x) { … // program code }	void Function(int x){ … // program code }
if (condition) { … // program code } else { … // program code }	if (condition){ … // program code } else { … // program code }
for (initialization; condition; update) { … // program code }	for (initialization; condition; update){ … // program code }
While (condition) { … // program code }	while (condition){ … // program code }
如果出現嵌套的｛｝，則使用縮進對齊，如：      {        …           {            …           }        … }

if ((very_longer_variable1 >= very_longer_variable12) && (very_longer_variable3 <= very_longer_variable14) && (very_longer_variable5 <= very_longer_variable16)) {     dosomething(); }

virtual CMatrix CMultiplyMatrix (CMatrix leftMatrix,                                  CMatrix rightMatrix);

for (very_longer_initialization;      very_longer_condition;      very_longer_update) {     dosomething(); }

/* * 函數介紹： * 輸入參數： * 輸出參數： * 返回值 ： */ void Function(float x, float y, float z) {  … }

if (…) {  …  while (…)  { … } // end of while … } // end of if

class A {  private: int    i, j; float x, y;     …  public: void Func1(void); void Func2(void); … }

class A {  public: void Func1(void); void Func2(void); …  private: int    i, j; float x, y;     … }