高質量C++/C編程指南 -- 第2章 程序的版式

2019-11-17 05:18:13

字體：大中小

來源：轉載

供稿：網友

第 2 章程序的版式版式雖然不會影響程序的功能，但會影響可讀性。程序的版式追求清楚、美觀，是程序風格的重要構成因素。可以把程序的版式比喻為“書法”。好的“書法”可讓人對程序一目了然，看得興致勃勃。差的程序“書法”如螃蟹爬行，讓人看得索然無味，更令維護者煩惱有加。請程序員們學習程序的“書法”，彌補大學計算機教育的漏洞，實在很有必要。 2.1 空行空行起著分隔程序段落的作用。空行得體（不過多也不過少）將使程序的布局更加清楚。空行不會浪費內存，雖然打印含有空行的程序是會多消耗一些紙張，但是值得。所以不要舍不得用空行。 l 【規則 2-1-1 】在每個類聲明之后、每個函數定義結束之后都要加空行。參見示例 2-1 （ a ） l 【規則 2-1-2 】在一個函數體內，邏揖上密切相關的語句之間不加空行，其它地方應加空行分隔。參見示例 2-1 （ b ） // 空行 void Function1(…) { … } // 空行 void Function2(…) { … } // 空行 void Function3(…) { … } // 空行 while (condition) { statement1; // 空行 if (condition) { statement2; } else { statement3; } // 空行 statement4; } 示例 2-1(a) 函數之間的空行示例2-1(b) 函數內部的空行 2.2 代碼行 l 【規則 2-2-1 】一行代碼只做一件事情，如只定義一個變量，或只寫一條語句。這樣的代碼輕易閱讀，并且方便于寫注釋。 l 【規則 2-2-2 】 if 、 for 、 while 、 do 等語句自占一行，執行語句不得緊跟其后。不論執行語句有多少都要加 {} 。這樣可以防止書寫失誤。示例 2-2 （ a ）為風格良好的代碼行，示例 2-2 （ b ）為風格不良的代碼行。 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(); 示例 2-2(a) 風格良好 的代碼行示例2-2(b) 風格不良 的代碼行 2 【建議 2-2-1 】盡可能在定義變量的同時初始化該變量（就近原則）假如變量的引用處和其定義處相隔比較遠，變量的初始化很輕易被忘記。假如引用了未被初始化的變量，可能會導致程序錯誤。本建議可以減少隱患。例如 int width = 10; // 定義并初紿化width int height = 10; // 定義并初紿化height int depth = 10; // 定義并初紿化depth 2.3 代碼行內的空格 l 【規則 2-3-1 】要害字之后要留空格。象 const 、 virtual 、 inline 、 case 等要害字之后至少要留一個空格，否則無法辨析要害字。象 if 、 for 、 while 等要害字之后應留一個空格再跟左括號‘（'，以突出要害字。 l 【規則 2-3-2 】函數名之后不要留空格，緊跟左括號‘（'，以與要害字區別。 l 【規則 2-3-3 】 ‘（'向后緊跟，‘）'、‘，'、‘ ; '向前緊跟，緊跟處不留空格。 l 【規則 2-3-4 】 ‘，'之后要留空格，如 Function(x, y, z) 。假如‘ ; '不是一行的結束符號，其后要留空格，如 for (initialization; condition; update) 。 l 【規則 2-3-5 】賦值操作符、比較操作符、算術操作符、邏輯操作符、位域操作符，如“ = ”、“ += ” “ >= ”、“ <= ”、“ + ”、“ * ”、“ % ”、“ && ”、“ ”、“ << ” , “ ^ ”等二元操作符的前后應當加空格。
l 【規則 2-3-6 】一元操作符如“ ! ”、“ ~ ”、“ ++ ”、“ -- ”、“ & ”（地址運算符）等前后不加空格。 l 【規則 2-3-7 】象“ ［］”、“ .”、“->” 這類操作符前后不加空格。 2 【建議 2-3-1 】對于表達式比較長的 for 語句和 if 語句，為了緊湊起見可以適當地去掉一些空格，如 for (i=0; i<10; i++)和 if ((a<=b) && (c<=d)) 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(); 示例 2-3 代碼行內的空格 2.4 對齊 l 【規則 2-4-1 】程序的分界符‘ { '和‘ } '應獨占一行并且位于同一列，同時與引用它們的語句左對齊。 l 【規則 2-4-2 】 { } 之內的代碼塊在‘ { '右邊數格處左對齊。示例 2-4 （ a ）為風格良好的對齊，示例 2-4 （ b ）為風格不良的對齊。 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 } 假如出現嵌套的｛｝，則使用縮進對齊，如： { … { … } … } 示例 2-4(a) 風格良好 的對齊示例2-4(b) 風格不良 的對齊 2.5 長行拆分 l 【規則 2-5-1 】代碼行最大長度宜控制在 70 至 80 個字符以內。代碼行不要過長，否則眼睛看不過來，也不便于打印。 l 【規則 2-5-2 】長表達式要在低優先級操作符處拆分成新行，操作符放在新行之首（以便突出操作符）。拆分出的新行要進行適當的縮進，使排版整潔，語句可讀。 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(); }

上一篇：C++程序設計語言編程風格演變史

下一篇：五種VC++數據庫開發技術的比較