青青草原综合久久大伊人导航_色综合久久天天综合_日日噜噜夜夜狠狠久久丁香五月_热久久这里只有精品

Creative Commons License
本Blog采用 知識共享署名-非商業性使用-禁止演繹 3.0 Unported許可協議 進行許可。 —— Fox <游戲人生>

游戲人生

游戲人生 != ( 人生 == 游戲 )
站點遷移至:http://www.yulefox.com。請訂閱本博的朋友將RSS修改為http://feeds.feedburner.com/yulefox
posts - 62, comments - 508, trackbacks - 0, articles - 7

[譯]Google C++編程風格指南(五)

Posted on 2008-07-22 11:59 Fox 閱讀(4211) 評論(3)  編輯 收藏 引用 所屬分類: T技術碎語

原文地址:

  • 命名約定

最重要的一致性規則是命名管理,命名風格直接可以直接確定命名實體是:類型、變量、函數、常量、宏等等,無需查找實體聲明,我們大腦中的模式匹配引擎依賴于這些命名規則。

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

1. 通用命名規則(General Naming Rules)

函數命名、變量命名、文件命名應具有描述性,不要過度縮寫,類型和變量應該是名詞,函數名可以用“命令性”動詞。

如何命名

盡可能給出描述性名稱,不要節約空間,讓別人很快理解你的代碼更重要,好的命名選擇:

int num_errors;                  // Good.
int num_completed_connections;   // Good.

丑陋的命名使用模糊的縮寫或隨意的字符:

int n;                           // Bad - meaningless.
int nerr;                        // Bad - ambiguous abbreviation.
int n_comp_conns;                // Bad - ambiguous abbreviation.

類型和變量名一般為名詞:如FileOpenernum_errors

函數名通常是指令性的,如OpenFile()set_num_errors(),訪問函數需要描述的更細致,要與其訪問的變量相吻合。

縮寫

除非放到項目外也非常明了,否則不要使用縮寫,例如:

// Good
// These show proper names with no abbreviations.
int num_dns_connections;  // Most people know what "DNS" stands for.
int price_count_reader;   // OK, price count. Makes sense.
 
// Bad!
// Abbreviations can be confusing or ambiguous outside a small group.
int wgc_connections;  // Only your group knows what this stands for.
int pc_reader;        // Lots of things can be abbreviated "pc".

不要用省略字母的縮寫:

int error_count;  // Good.
int error_cnt;    // Bad.

2. 文件命名(File Names)

文件名要全部小寫,可以包含下劃線(_)或短線(-),按項目約定來。

可接受的文件命名:

my_useful_class.cc
my-useful-class.cc
myusefulclass.cc

C++文件以.cc結尾,頭文件以.h結尾。

不要使用已經存在于/usr/include下的文件名(譯者注,對UNIX、Linux等系統而言),如db.h

通常,盡量讓文件名更加明確,http_server_logs.h就比logs.h要好,定義類時文件名一般成對出現,如foo_bar.hfoo_bar.cc,對應類FooBar

內聯函數必須放在.h文件中,如果內聯函數比較短,就直接放在.h中。如果代碼比較長,可以放到以-inl.h結尾的文件中。對于包含大量內聯代碼的類,可以有三個文件:

url_table.h      // The class declaration.
url_table.cc     // The class definition.
url_table-inl.h  // Inline functions that include lots of code.

參考第一篇-inl.h文件一節。

3. 類型命名(Type Names)

類型命名每個單詞以大寫字母開頭,不包含下劃線:MyExcitingClassMyExcitingEnum

所有類型命名——類、結構體、類型定義(typedef)、枚舉——使用相同約定,例如:

// classes and structs
class UrlTable { ... 
class UrlTableTester { ... 
struct UrlTableProperties { ...

// typedefs
typedef hash_map<UrlTableProperties *, string> PropertiesMap;

// enums
enum UrlTableErrors { ...

4. 變量命名(Variable Names)

變量名一律小寫,單詞間以下劃線相連,類的成員變量以下劃線結尾,如my_exciting_local_variablemy_exciting_member_variable_

普通變量命名

舉例:

string table_name;  // OK - uses underscore.
string tablename;   // OK - all lowercase.
string tableName;   // Bad - mixed case.

類數據成員

結構體的數據成員可以和普通變量一樣,不用像類那樣接下劃線:

struct UrlTableProperties {
  string name;
  int num_entries;
}

結構體與類的討論參考第三篇結構體vs.類一節。

全局變量

對全局變量沒有特別要求,少用就好,可以以g_或其他易與局部變量區分的標志為前綴。

5. 常量命名(Constant Names)

在名稱前加kkDaysInAWeek

所有編譯時常量(無論是局部的、全局的還是類中的)和其他變量保持些許區別,k后接大寫字母開頭的單詞:

const int kDaysInAWeek = 7;

6. 函數命名(Function Names)

普通函數(regular functions,譯者注,這里與訪問函數等特殊函數相對)大小寫混合,存取函數(accessors and mutators)則要求與變量名匹配:MyExcitingFunction()MyExcitingMethod()my_exciting_member_variable()set_my_exciting_member_variable()

普通函數

函數名以大寫字母開頭,每個單詞首字母大寫,沒有下劃線:

AddTableEntry()
DeleteUrl()

存取函數

存取函數要與存取的變量名匹配,這兒摘錄一個擁有實例變量num_entries_的類:

class MyClass {
 public:
  ...
  int num_entries() const { return num_entries_; }
  void set_num_entries(int num_entries) { num_entries_ = num_entries; }

 private:
  int num_entries_;
};

其他短小的內聯函數名也可以使用小寫字母,例如,在循環中調用這樣的函數甚至都不需要緩存其值,小寫命名就可以接受。

譯者注:從這一點上可以看出,小寫的函數名意味著可以直接內聯使用。

7. 命名空間(Namespace Names)

命名空間的名稱是全小寫的,其命名基于項目名稱和目錄結構:google_awesome_project

關于命名空間的討論和如何命名,參考第二篇命名空間

8. 枚舉命名(Enumerator Names)

枚舉值應全部大寫,單詞間以下劃線相連:MY_EXCITING_ENUM_VALUE

枚舉名稱屬于類型,因此大小寫混合:UrlTableErrors

enum UrlTableErrors {
  OK = 0,
  ERROR_OUT_OF_MEMORY,
  ERROR_MALFORMED_INPUT,
};

9. 宏命名(Macro Names)

你并不打算使用宏,對吧?如果使用,像這樣:MY_MACRO_THAT_SCARES_SMALL_CHILDREN

參考第四篇預處理宏,通常是不使用宏的,如果絕對要用,其命名像枚舉命名一樣全部大寫、使用下劃線:

#define ROUND(x) ...
#define PI_ROUNDED 3.0
MY_EXCITING_ENUM_VALUE

10. 命名規則例外(Exceptions to Naming Rules)

當命名與現有C/C++實體相似的對象時,可參考現有命名約定:

bigopen()
函數名,參考open()
uint
typedef類型定義
bigpos
structclass,參考pos
sparse_hash_map
STL相似實體;參考STL命名約定
LONGLONG_MAX
常量,類似INT_MAX

______________________________________

譯者:命名約定就相對輕松許多,在遵從代碼一致性、可讀性的前提下,略顯隨意:

1. 總體規則:不要隨意縮寫,如果說ChangeLocalValue寫作ChgLocVal還有情可原的話,把ModifyPlayerName寫作MdfPlyNm就太過分了,除函數名可適當為動詞外,其他命名盡量使用清晰易懂的名詞;

2. 宏、枚舉等使用全部大寫+下劃線;

3. 變量(含類、結構體成員變量)、文件、命名空間、存取函數等使用全部小寫+下劃線,類成員變量以下劃線結尾,全局變量以g_開頭;

4. 普通函數、類型(含類與結構體、枚舉類型)、常量等使用大小寫混合,不含下劃線;

5. 參考現有或相近命名約定。

Feedback

# re: [譯]Google C++編程風格指南(五)  回復  更多評論   

2008-07-22 15:21 by 小夜
呵呵,辛苦啊。前兩天剛看英文版,費勁啊,怎么也看不下去;這下得好好看看了。

# re: [譯]Google C++編程風格指南(五)  回復  更多評論   

2011-09-15 14:48 by Rolex replica

學習學習!!

# re: [譯]Google C++編程風格指南(五)  回復  更多評論   

2011-11-21 11:25 by uggs replica
給力!不錯
青青草原综合久久大伊人导航_色综合久久天天综合_日日噜噜夜夜狠狠久久丁香五月_热久久这里只有精品
  • <ins id="pjuwb"></ins>
    <blockquote id="pjuwb"><pre id="pjuwb"></pre></blockquote>
    <noscript id="pjuwb"></noscript>
          <sup id="pjuwb"><pre id="pjuwb"></pre></sup>
            <dd id="pjuwb"></dd>
            <abbr id="pjuwb"></abbr>
            欧美日韩视频在线一区二区| 性欧美xxxx大乳国产app| 久久国产精品一区二区三区四区 | 日韩视频三区| 99国产精品99久久久久久粉嫩 | 一本一道久久综合狠狠老精东影业| 亚洲福利视频网站| 欧美激情视频网站| 亚洲天堂偷拍| 欧美一区二粉嫩精品国产一线天| 国产亚洲欧美日韩一区二区| 蜜臀av一级做a爰片久久| 另类国产ts人妖高潮视频| 一区二区三区|亚洲午夜| 亚洲少妇在线| 伊人久久大香线蕉av超碰演员| 欧美v国产在线一区二区三区| 欧美在线亚洲在线| 久久一区免费| 中国av一区| 欧美在线观看www| 99在线精品视频在线观看| 亚洲在线免费观看| 亚洲高清自拍| 亚洲性感美女99在线| 影音先锋久久资源网| 艳女tv在线观看国产一区| 国产亚洲高清视频| 亚洲人成网站精品片在线观看| 国产伦精品一区二区三区| 欧美激情二区三区| 国产精品黄色| 亚洲第一天堂av| 国产午夜精品美女视频明星a级| 欧美jizzhd精品欧美喷水| 国产精品女同互慰在线看| 欧美激情亚洲激情| 国产精品有限公司| 日韩一级免费| 亚洲激情av在线| 性欧美办公室18xxxxhd| 亚洲小说欧美另类婷婷| 久久都是精品| 欧美四级电影网站| 亚洲人成网在线播放| 怡红院av一区二区三区| 亚洲欧美综合国产精品一区| 亚洲午夜一区二区三区| 欧美激情一区二区三区蜜桃视频| 久久亚洲一区二区三区四区| 国产精品自在在线| 亚洲深夜影院| 亚洲综合精品一区二区| 欧美日韩精品一区二区三区| 亚洲国产精品一区制服丝袜| 极品少妇一区二区三区| 欧美中文在线观看国产| 欧美在线黄色| 国产伦精品一区二区三区视频黑人| 亚洲精品在线免费观看视频| 日韩一级免费观看| 欧美激情亚洲精品| 亚洲高清在线精品| 亚洲激情电影在线| 免费不卡亚洲欧美| 欧美黄色影院| 99精品欧美一区二区蜜桃免费| 免费不卡在线视频| 欧美大色视频| 亚洲精品在线看| 亚洲欧美日韩专区| 国产欧美另类| 久久精品一区二区三区不卡牛牛| 久久久福利视频| 国内自拍视频一区二区三区| 噜噜爱69成人精品| 亚洲欧洲日产国产网站| 亚洲一区二区在线看| 国产精品女人网站| 久久精品中文字幕免费mv| 狂野欧美激情性xxxx欧美| 午夜亚洲视频| 蜜桃av综合| 99国产精品久久久| 国产精品欧美日韩| 久久大逼视频| 亚洲人午夜精品| 午夜精品久久久久久久99水蜜桃| 国产日韩欧美综合精品| 久久久久久亚洲精品不卡4k岛国| 欧美国产日韩一二三区| 中文国产成人精品久久一| 国产精品乱码妇女bbbb| 久久久午夜精品| 亚洲免费观看高清在线观看| 欧美亚洲一区二区三区| 狠狠色综合网| 欧美三级电影一区| 欧美亚洲日本国产| 亚洲欧洲在线一区| 久久久精品一区| 亚洲伦理网站| 国产一区二区三区精品欧美日韩一区二区三区 | 亚洲精品一二| 国产女主播一区| 欧美国产日韩xxxxx| 亚洲欧美日韩精品久久奇米色影视| 免费欧美高清视频| 亚洲免费在线视频| 亚洲人成网站777色婷婷| 欧美日韩在线精品| 欧美sm极限捆绑bd| 亚洲小视频在线观看| 亚洲成在线观看| 国产精品你懂的| 欧美日韩大陆在线| 久久综合国产精品| 性欧美大战久久久久久久免费观看 | 久久免费视频网| 亚洲在线中文字幕| 99在线视频精品| 国内外成人免费激情在线视频| 欧美日本中文字幕| 麻豆av一区二区三区久久| 午夜精品福利电影| 亚洲小说春色综合另类电影| 日韩午夜三级在线| 亚洲国产精品一区| 欧美在线一区二区| 午夜精品国产| 亚洲欧美国产高清| 亚洲综合第一页| 亚洲一区国产| 亚洲综合导航| 欧美成人福利视频| 欧美在线啊v| 亚洲欧美国产高清va在线播| 亚洲视频狠狠| 在线亚洲免费视频| 亚洲一区二区三区精品视频| 一本色道久久综合精品竹菊 | 欧美视频国产精品| 欧美日韩在线观看一区二区| 欧美日韩亚洲视频| 国产精品v日韩精品v欧美精品网站| 欧美日韩一卡二卡| 欧美三级免费| 国产精品福利网站| 国产精品久久久久久久久动漫| 欧美天堂亚洲电影院在线播放| 欧美日韩一区二区三区| 欧美色一级片| 国产精品久久久久久av福利软件| 国产精品视屏| 国际精品欧美精品 | 欧美激情精品久久久久久变态| 欧美日本在线观看| 国产精品美女久久久久久免费| 国产精品女主播一区二区三区| 国产精品五月天| 狠狠久久亚洲欧美专区| 亚洲国产裸拍裸体视频在线观看乱了中文 | 欧美激情精品久久久久久免费印度 | 黄色精品免费| 亚洲看片一区| 亚洲免费网址| 久久久久久成人| 欧美高清一区二区| 99riav久久精品riav| 香蕉久久夜色| 老牛嫩草一区二区三区日本| 欧美日韩极品在线观看一区| 国产精品久久久久久久午夜片| 国产情侣久久| 亚洲日本欧美日韩高观看| 午夜欧美大尺度福利影院在线看| 久久精品一区四区| 国产精品裸体一区二区三区| 国产一区欧美| 一本色道久久综合精品竹菊| 久久久91精品国产| 亚洲国产欧美一区二区三区同亚洲 | 久久婷婷综合激情| 国产精品久久国产三级国电话系列 | 你懂的国产精品永久在线| 国产精品乱码妇女bbbb| 亚洲精品视频免费观看| 欧美在线视频全部完| 亚洲国产精品一区二区第四页av| 亚洲免费一级电影| 欧美91大片| 国产在线不卡视频| 亚洲一区二区在线视频| 亚洲福利专区| 久久黄色影院| 国产精品视频免费一区| 一区二区国产日产| 国产精品一二三四区| 午夜精品国产精品大乳美女| 久久蜜臀精品av|