《Google的C++編碼規(guī)范》閱讀隨筆 —— 第七章 格式

1.行長(zhǎng)度
每一行代碼字符數(shù)不超過(guò)80
結(jié)論:80個(gè)字符是最大值躏仇。例外:
1)如果一行注釋包含了超過(guò)80個(gè)字符的,命令或者URL腺办,出于復(fù)制粘貼的方便可以超過(guò)80個(gè)
2)頭文件保護(hù)

2.非ASCII字符
盡量不要使用非ASCII字符焰手,使用時(shí)必須使用UTF-8格式

3.空格還是制表位
只使用空格,每次縮進(jìn)2個(gè)空格
可以設(shè)定編輯器將tab轉(zhuǎn)為空格

4.函數(shù)聲明與定義
返回類型和函數(shù)名在同一行怀喉,合適的話书妻,參數(shù)也放在同一行
以下幾點(diǎn):
1)返回值和函數(shù)名總是在同一行
2)左圓括號(hào)總是核函數(shù)名在同一行
3)函數(shù)名和左圓括號(hào)間沒(méi)有空格
4)圓括號(hào)和參數(shù)間沒(méi)有空格
5)左大括號(hào)總是在最后一個(gè)參數(shù)同一行的末尾處
6)右大括號(hào)總是單獨(dú)位于函數(shù)最后一行
7)右圓括號(hào)和左大括號(hào)之間總是有一個(gè)空格
8)函數(shù)聲明和實(shí)現(xiàn)處的所有形參名稱必須保持一致
9)所有形參應(yīng)該盡可能對(duì)齊
10)缺省縮進(jìn)為2個(gè)空格
11)獨(dú)立封裝的參數(shù)保持4個(gè)空格的縮進(jìn)

5.函數(shù)調(diào)用
盡量放在同一行,否則磺送,將實(shí)參封裝在圓括號(hào)中驻子。
同一行放不下灿意,可斷為多行,后面每一行都和第一個(gè)實(shí)參對(duì)齊崇呵,左圓括號(hào)和右圓括號(hào)前不要留空格:
bool retval = DoSomething(argument1,
argument2,
argument3);

or

if{
if{
DoSomethingThatRequiresALongFunctionName(
very_long_argumrnt1,
argument2,
argument3
);
}
}

6.條件語(yǔ)句
更提倡不在圓括號(hào)中添加空格缤剧,關(guān)鍵字else另起一行。
圓括號(hào)和大括號(hào)最好空一格
if(condition) {...

有些語(yǔ)句放在一行域慷,增強(qiáng)可讀性
if(x) DoThis();

通常單行語(yǔ)句不要使用大括號(hào)

7.循環(huán)和開(kāi)關(guān)選擇語(yǔ)句
switch語(yǔ)句可以使用大括號(hào)分塊荒辕;空循環(huán)提應(yīng)使用{}或continue,不要只是一個(gè)建立單的分號(hào)犹褒。
switch語(yǔ)句中的case塊可以使用大括號(hào)也可以不用抵窒,如果輸入的值沒(méi)有case去處理,編譯器將會(huì)報(bào)警叠骑,因此添加default李皇,若default永不會(huì)執(zhí)行,可以簡(jiǎn)單地使用assert:
default:{
assert(false); //assert判斷為假中斷程序執(zhí)行
}

8.指針和引用表達(dá)式
句點(diǎn)(.)或箭頭(->)前后不要有空格宙枷,指針/地址操作符(*掉房, &)后不要有空格

9.布爾表達(dá)式
如果一個(gè)布爾表達(dá)式超過(guò)標(biāo)準(zhǔn)行寬(80字符),如果斷行要統(tǒng)一

10.函數(shù)返回值
return表達(dá)式中不要使用圓括號(hào)

11.變量及數(shù)組初始化
選擇=還是()慰丛。都可以

12.預(yù)處理指令
預(yù)處理指令不要縮進(jìn)卓囚,從行首開(kāi)始(即使預(yù)處理指令在縮進(jìn)的代碼塊中)
if(condition){

if DISASTER_PENDING

    ...

endif

    ...
}

13.類格式
聲明屬性依次是public、protected诅病、private哪亿。每次縮進(jìn)一個(gè)空格。
class MyClass{
public:
...
}
注意:
1)所有基類名應(yīng)在80列限制下盡量與子類名放在同一行
2)關(guān)鍵詞public 贤笆。蝇棉。。 要縮進(jìn)1個(gè)空格(MSVC所使用tab縮進(jìn)苏潜,且這三個(gè)關(guān)鍵詞不縮進(jìn))
3)除了第一個(gè)關(guān)鍵詞之外银萍,其他關(guān)鍵詞前空一行变勇。類小的話可以不空
4)這些關(guān)鍵詞之后不要空行

14.初始化列表
構(gòu)造函數(shù)初始化列表放在同一行或按四格縮進(jìn)并排幾行
MyClass::MyClass(int var):some_var_(var), some_other_var_(var + 1){
或者
MyClass::MyClass(int var)
:some_var_(var),
some_other_var_(var + 1){

15.命名空間格式化
命名空間內(nèi)容不要縮進(jìn)恤左。
namespace{
void foo() {

}

}

16.水平空白
水平空白的使用因地制宜,不要在行尾提那家無(wú)謂的空白

17.垂直空白
垂直空白越少越好

總結(jié):
1)行寬原則上不超過(guò)80列
2)盡量不要使用ASCII字符搀绣,要用的話飞袋,參考UTF-8格式,尤其在linux链患、unix下巧鸭。盡量不要將字符串常量耦合到代碼中,比如可以獨(dú)立出資源文件
3)UNIX/Linux無(wú)條件使用空格麻捻,MSVC的話使用tab也無(wú)可厚非
4)函數(shù)參數(shù)纲仍,邏輯條件呀袱、初始化列表:要么所有參數(shù)和函數(shù)名放在同一行,要么所有參數(shù)并排分行
5)除函數(shù)定義的左大括號(hào)可以置于行首外郑叠,包括函數(shù)夜赵、類、結(jié)構(gòu)體乡革、枚舉聲明寇僧。各種語(yǔ)句的左大括號(hào)置于行尾,所有右大括號(hào)獨(dú)立成行
6).or->操作符前后不留空沸版,*or&不要前后都留空嘁傀,一個(gè)就可,靠左靠右依個(gè)人愛(ài)好
7)預(yù)處理和命名空間不要使用額外縮進(jìn)视粮,類细办、結(jié)構(gòu)體、枚舉蕾殴。函數(shù)蟹腾。語(yǔ)句使用縮進(jìn)
8)初始化=還是()都可以
9)return不要加()
10)水平,垂直留白不要濫用区宇,怎么易讀怎么來(lái)

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末娃殖,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子议谷,更是在濱河造成了極大的恐慌炉爆,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,546評(píng)論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件卧晓,死亡現(xiàn)場(chǎng)離奇詭異芬首,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)逼裆,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,224評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門郁稍,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人胜宇,你說(shuō)我怎么就攤上這事耀怜。” “怎么了桐愉?”我有些...
    開(kāi)封第一講書(shū)人閱讀 164,911評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵财破,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我从诲,道長(zhǎng)左痢,這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,737評(píng)論 1 294
  • 正文 為了忘掉前任,我火速辦了婚禮俊性,結(jié)果婚禮上略步,老公的妹妹穿的比我還像新娘。我一直安慰自己定页,他們只是感情好纳像,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,753評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著拯勉,像睡著了一般竟趾。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上宫峦,一...
    開(kāi)封第一講書(shū)人閱讀 51,598評(píng)論 1 305
  • 那天岔帽,我揣著相機(jī)與錄音,去河邊找鬼导绷。 笑死犀勒,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的妥曲。 我是一名探鬼主播贾费,決...
    沈念sama閱讀 40,338評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼檐盟!你這毒婦竟也來(lái)了褂萧?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 39,249評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤葵萎,失蹤者是張志新(化名)和其女友劉穎导犹,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體羡忘,經(jīng)...
    沈念sama閱讀 45,696評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡谎痢,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,888評(píng)論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了卷雕。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片节猿。...
    茶點(diǎn)故事閱讀 40,013評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖漫雕,靈堂內(nèi)的尸體忽然破棺而出滨嘱,到底是詐尸還是另有隱情,我是刑警寧澤蝎亚,帶...
    沈念sama閱讀 35,731評(píng)論 5 346
  • 正文 年R本政府宣布九孩,位于F島的核電站先馆,受9級(jí)特大地震影響发框,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,348評(píng)論 3 330
  • 文/蒙蒙 一梅惯、第九天 我趴在偏房一處隱蔽的房頂上張望宪拥。 院中可真熱鬧,春花似錦铣减、人聲如沸她君。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 31,929評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)缔刹。三九已至,卻和暖如春劣针,著一層夾襖步出監(jiān)牢的瞬間校镐,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,048評(píng)論 1 270
  • 我被黑心中介騙來(lái)泰國(guó)打工捺典, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留鸟廓,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,203評(píng)論 3 370
  • 正文 我出身青樓襟己,卻偏偏與公主長(zhǎng)得像引谜,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子擎浴,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,960評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容