google開源項(xiàng)目風(fēng)格指南二 命名約定(C++)

命名規(guī)則具有一定隨意性, 但相比按個(gè)人喜好命名, 一致性更重, 所以不管你怎么想, 規(guī)則總歸是規(guī)則


1 通用命名規(guī)則

函數(shù)拘哨,變量,文件命名要有描述性,少用縮寫 盡可能給出有描述性的命名力惯,別心疼空間碗誉,讓代碼易于理解更加重要 不要用只有項(xiàng)目開發(fā)者才能理解的縮寫 不要通過(guò)省略幾個(gè)字母來(lái)縮寫單詞

警示實(shí)例:

int n; //不知所名召嘶,莫名其妙 int nerr; //奇怪的縮寫 int n_comp_conns; //奇怪的縮寫 int wgc_connections; //只有開發(fā)者才明白的縮寫 int pc_reader; //pc可以有很多種解釋 int cstmr_id; //刪減了字母


2 文件命名

文件名稱要全部小寫父晶, 可以包含下劃線或者連字符,按照項(xiàng)目的約定選擇弄跌,最好選擇下劃線 通常盡量讓文件名更加明確 內(nèi)聯(lián)函數(shù)必須放在.h 文件中甲喝,如果內(nèi)聯(lián)函數(shù)比較短,可以直接放在.h中


3 類型命名

類型名稱的每個(gè)單詞首字母都使用大寫铛只,不包含下劃線 所有的類型命名埠胖,類\結(jié)構(gòu)體\類型定義\枚舉使用相同的約定

類型命名實(shí)例:

class UrlTable {... class UrlTableTester { ... struct UrlTableTester { ... typedef hash_map<UrlTableProperties * ,string> PropertiesMap; enum UrlTableErrors { ...


4 變量命名

變量名一律小寫 單詞之間使用下劃線連接 類的成員變量以下劃線結(jié)尾,結(jié)構(gòu)體不需要 對(duì)全局變量沒(méi)有特別要求淳玩,但是少用為好直撤,可以使用g_或者其他標(biāo)志作為前綴,更好的區(qū)分局部變量

變量命名實(shí)例:

string table_name ; string tablename;


5 常量命名

在全局或者類里面的常量名稱之前加k 除去開頭的k之外的每個(gè)單詞開頭字母均使用大寫

常量命名實(shí)例:

const int kDaysInAWeek = 7;


6 函數(shù)命名

常規(guī)函數(shù)使用大小寫混合蜕着,每個(gè)單詞的首字母大寫谋竖,沒(méi)有下劃線 取值和設(shè)值函數(shù)則要求與變量名匹配 其他非常短小的內(nèi)聯(lián)函數(shù)名可以用小寫字母,例如承匣,如果在循環(huán)中調(diào)用這樣的函數(shù)甚至都不用緩存其返回值蓖乘,小寫命名可以接受

常量命名實(shí)例:

常規(guī)函數(shù) AddTableEntry() DeleteUrl() 如果函數(shù)出錯(cuò)的時(shí)候直接崩潰,可以在函數(shù)名加上OrDie,但函數(shù)本身必須集成在產(chǎn)品代碼中韧骗,OpenFileDie()


7 名字空間命名

名字空間用小寫字母命名嘉抒,基于項(xiàng)目名稱和目錄結(jié)構(gòu)

常量命名實(shí)例:

常規(guī)函數(shù) AddTableEntry() DeleteUrl() 如果函數(shù)出錯(cuò)的時(shí)候直接崩潰,可以在函數(shù)名加上OrDie,但函數(shù)本身必須集成在產(chǎn)品代碼中袍暴,OpenFileDie()

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末些侍,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子政模,更是在濱河造成了極大的恐慌娩梨,老刑警劉巖,帶你破解...
    沈念sama閱讀 217,826評(píng)論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件览徒,死亡現(xiàn)場(chǎng)離奇詭異狈定,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)习蓬,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,968評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門纽什,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人躲叼,你說(shuō)我怎么就攤上這事芦缰。” “怎么了枫慷?”我有些...
    開封第一講書人閱讀 164,234評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵让蕾,是天一觀的道長(zhǎng)浪规。 經(jīng)常有香客問(wèn)我,道長(zhǎng)探孝,這世上最難降的妖魔是什么笋婿? 我笑而不...
    開封第一講書人閱讀 58,562評(píng)論 1 293
  • 正文 為了忘掉前任,我火速辦了婚禮顿颅,結(jié)果婚禮上缸濒,老公的妹妹穿的比我還像新娘。我一直安慰自己粱腻,他們只是感情好庇配,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,611評(píng)論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著绍些,像睡著了一般捞慌。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上柬批,一...
    開封第一講書人閱讀 51,482評(píng)論 1 302
  • 那天啸澡,我揣著相機(jī)與錄音,去河邊找鬼萝快。 笑死锻霎,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的揪漩。 我是一名探鬼主播旋恼,決...
    沈念sama閱讀 40,271評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼奄容!你這毒婦竟也來(lái)了冰更?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,166評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤昂勒,失蹤者是張志新(化名)和其女友劉穎蜀细,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體戈盈,經(jīng)...
    沈念sama閱讀 45,608評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡奠衔,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,814評(píng)論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了塘娶。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片归斤。...
    茶點(diǎn)故事閱讀 39,926評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖刁岸,靈堂內(nèi)的尸體忽然破棺而出脏里,到底是詐尸還是另有隱情,我是刑警寧澤虹曙,帶...
    沈念sama閱讀 35,644評(píng)論 5 346
  • 正文 年R本政府宣布迫横,位于F島的核電站番舆,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏矾踱。R本人自食惡果不足惜恨狈,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,249評(píng)論 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望介返。 院中可真熱鬧拴事,春花似錦沃斤、人聲如沸圣蝎。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,866評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)徘公。三九已至,卻和暖如春哮针,著一層夾襖步出監(jiān)牢的瞬間关面,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,991評(píng)論 1 269
  • 我被黑心中介騙來(lái)泰國(guó)打工十厢, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留等太,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,063評(píng)論 3 370
  • 正文 我出身青樓蛮放,卻偏偏與公主長(zhǎng)得像缩抡,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子包颁,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,871評(píng)論 2 354

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

  • importUIKit classViewController:UITabBarController{ enumD...
    明哥_Young閱讀 3,805評(píng)論 1 10
  • 1瞻想、引言 數(shù)據(jù)庫(kù)設(shè)計(jì)過(guò)程中表、字段等的命名規(guī)范也算是設(shè)計(jì)規(guī)范的一部分娩嚼,不過(guò)設(shè)計(jì)規(guī)范更多的是為了確保數(shù)據(jù)庫(kù)設(shè)計(jì)的合理...
    SnowflakeCloud閱讀 40,996評(píng)論 0 48
  • 開發(fā)cocoa框架蘑险、插件或者其它帶公共API的可執(zhí)行文件需要不同于應(yīng)用開發(fā)一些方法和慣例。你的產(chǎn)品的主要客戶是開發(fā)...
    醬油不愛(ài)醋閱讀 1,637評(píng)論 0 4
  • 《善用時(shí)間》1 推薦序及序言 帶著目的和疑問(wèn)來(lái)讀書: 什么是善用時(shí)間岳悟?就是合理利用 為什么善用時(shí)間佃迄? 善用時(shí)間的方...
    寬幸福閱讀 377評(píng)論 0 0
  • 洪崖的洞前流淌著歲月的年華 年華在你的眼眸里流轉(zhuǎn) 一眼眨碎在飛舞的流光
    泊客行閱讀 160評(píng)論 0 0