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

C++變量命名規范

Posted on 2011-12-31 13:23 冷鋒 閱讀(2572) 評論(0)  編輯 收藏 引用 所屬分類: C/C++

(轉載自http://blog.csdn.net/huayehanshan/article/details/3860363
在軟件開發過程中,代碼的命名規范是一項很突出的內容。一套定義完整、結構清晰明了的命名規范將大大提升源代碼的可讀性和軟件的可維護性。

據考證,沒有一種命名規則可以讓所有的程序員都滿意,程序設計教科書一般也不會指定命名規則。但是制定一套令開發組成員基本滿意的命名規則,并在項目中貫徹實施,也是團隊開發一項必不可少的工作。

我將我的團隊的實際工作中的命名規則整理如下:

 

第一部分:共性規則

共有八項。作為指導供成員采納。

【規則1】標識符應簡單明了,望文知意。

標識符采用英文單詞。切忌使用漢語拼音來命名。程序中的英文單詞一般不要太復雜,用詞應當準確。例如不要把CurrentValue寫成NowValue。

盡量不要使用單詞縮寫或首字母縮寫。只有當標識符過長時才考慮使用單詞縮寫。在使用縮寫時,不要自創縮寫,盡量使用被廣泛接受的縮寫。

 

【規則2】標識符長度應當符合“min-length && max-information”原則。

一般的講,長名字能更好地表達含義,所以函數名、變量名、類名長達十幾個字符不足為怪。但是名字也不是越長越好。例如:變量名maxval就比maxValueUntilOverflow更好用。單字符的名字也是有用的,常見的如i,j,k,m,n,x,y,z等,它們通常用作函數內的局部變量。

 

【規則3】命名規則盡量與所采用的操作系統或開發工具的風格保持一致。

例如Windows應用程序的標識符通常采用大小寫混排的方式,如AddChild。而Unix應用程序的標識符通常采用小寫加下劃線的方式,如add_child。別把這兩類風格混在一起用。

 

【規則4】程序中不要出現僅靠大小寫區分的標識符。

例如:int  xint  X;void foo() void FOO() 等。

 

【規則5避免在不同級別的作用域中重名。

程序中不要出現標識符完全相同的局部變量和全局變量,盡管兩者因作用域的不同而不會發生語法錯誤,但會使人產生誤解。

 

【規則6】正確命名具有互斥意義的標識符。

使用正確的反義詞組命名具有互斥意義的變量或相反動作的函數。

如:"MinValue"和"MaxValue","GetName()" 和 "SetName()"

 

【規則7】盡量避免名字中出現數字編號。

Value1,Value2等,除非邏輯上的確需要編號。這是為了防止程序產生無意義的名字,降低程序的可讀性。

 

【規則8】使用庫標志

在開發動態庫時,為了防止軟件庫中的一些標識符和其它軟件庫中標識符沖突,可以為各種標識符加上能反映軟件性質的前綴。

例如三維圖形標準OpenGL的所有庫函數均以gl開頭,所有常量(或宏定義)均以GL開頭。

 

第二部分:細則

      我采用了一部分的匈牙利法命名規范,但沒有照搬。匈牙利法最大的特征就是類型前綴。例如:

int nNum = 0; // n 為類型信息,表明 nNum 是一個 int 類型

class CUser;  // C 為類型信息,表明 CUser 是一個類

但是正因為如此,匈牙利法命名規范也給人一種繁瑣的感覺。例如:

int i, j, k; 

float x, y, z;

倘若采用匈牙利命名規則,則應當寫成:

int iI, iJ, ik; // 前綴 i表示int類型

float fX, fY, fZ; // 前綴 f表示float類型

對于此類情況,我的處理方式是不加類型前綴。而對于下列情況我會加:

int iHeigh;

Bool bFlag;

總之,在我的命名規范中,類型前綴是一個可選的命名規則。下面分類進行詳細的規范。

 

一、        類和接口

1、           命名:類名都以大寫字母“C”開頭,后跟一個或多個單詞。每個單詞的首字母要大寫。接口以大寫"I"開頭,代表Interface。

2、           組成形式:推薦用"名詞""形容詞+名詞"的形式,例如:"CAnalyzer", "CFastVector" ....

二、        函數

1、           命名:函數的名稱由一個或多個單詞組成。每個單詞的首字母要大寫。最長不得超過20個字符。

2、           組成形式:全局函數應當使用"動詞"或者"動詞+名詞"(動賓詞組)的形式。例如:"gGetName()", " gDrawBox()"。

類成員函數應當只使用動詞,被省略掉的名詞就是對象本身。例如:

" box->Draw();"

3、           全局函數:以小寫前綴"g"開頭。

4、           保護成員函數:開頭應當加上一個下劃線“_”以示區別,例如:"_SetState()"

5、           私有成員函數:開頭應當加上兩個下劃線“__”,例如:"__DestroyImp()"

6、           虛函數:習慣以“Do”開頭,如:"DoRefresh()", "_DoEncryption()"

7、           回調和事件處理函數 :習慣以單詞“On”開頭。例如:"_OnTimer()", "OnExit()"

三、        變量

變量是程序中使用最多的標識符,變量的命名規范是一套C++命名規范中最重要的部分:

1、           命名:變量名由作用域前綴+類型前綴+一個或多個單詞組成。變量用小寫字母開頭的單詞組合而成,第二個單詞的首字母要大寫。例如:int nDrawMode。變量最長不得超過20個字符。

特殊的:對于某些用途簡單明了的局部變量,也可以使用簡化的方式,如:i, j, k, x, y, z

2、           組成形式:變量的名字應當使用"名詞"或者"形容詞+名詞"。例如:"nCode", "m_nState","nMaxWidth"," oldValue "," newValue "。

3、           作用域前綴:作用域前綴標明一個變量的可見范圍。作用域可以有如下幾種:

前綴

說明

例子

局部變量

 

m_

類的成員變量(member

Int  m_width

ms_

類的靜態成員變量(static member

static int ms_initValue;

s_

靜態變量(static

static int s_initValue; 

g_

外部全局變量(global

int g_howManyPeople;

sg_

靜態全局變量(static global

 

gg_

進程間共享的共享數據段全局變量(global global

 

說明:作用域前綴不同于下面的類型前綴,應該堅決執行。原因是:

1變量作用域和鏈接性改變的情況是很少的,例如,很少的情況下會把一個成員變量改成靜態變量

2編程中使用的工具常常不會直觀的顯示變量的作用域和鏈接性

4、           類型前綴:作用域前綴標明一個變量的可見范圍。類型前綴標明一個變量的類型,有如下幾種:

前綴

說明

例子

b

布爾型變量(bool, BOOL

bEnable

ch

字符型變量(char TCHAR

chName

lpsz

LPSTR、LPCSTR、LPCTSTR

lpszName

n

整型和位域變量(int, UINT,__int32,__int64

nLength

l

long

lOffset

by

BYTE

 

w

WORD

wPos

dw

DWORD

dwRange

f

浮點型變量(float

 

d

double

 

p

指針型變量和迭代子(pointer

pDoc

lp

遠指針

 

e

枚舉型變量(enumeration

 

pfn

特別針對指向函數的指針變量和函數對象指針(pointer of function

 

g

數組(grid

 

h

handle   Windows對象句柄

hWnd

四、        常量

常量名由類型前綴+全大寫字母組成,單詞間通過下劃線來界定,如:cDELIMITERnMAX_BUFFER類型前綴的定義與變量命名規則中的相同。

五、        結構體、宏、枚舉變量、聯合體

全部由前綴+大寫字母組成,單詞間使用下劃線界定。

1、           結構體:加小寫前綴"tag",之后以大寫字母開頭。

例:

typedef struct tagPOINT

{

int x;

int y;

} POINT;

2、           宏:大寫字母組成,單詞間使用下劃線界定

例:#define MAXNUMBER 100

3、           枚舉變量:加小寫前綴"enum" 

例:

typedef enum _FILE_OPEN_MODE

{

OPEN_READONLY,

OPEN_READWRITE

}FILE_OPEN_MODE;

4、           聯合體:加小寫前綴"uni"

例:

typedef union _VARIANT

{

char unichVal;

int uninVal;

float uniftVal;

} VARIANT;

posts - 15, comments - 18, trackbacks - 0, articles - 0

Copyright © 冷鋒

青青草原综合久久大伊人导航_色综合久久天天综合_日日噜噜夜夜狠狠久久丁香五月_热久久这里只有精品
  • <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>
            亚洲一区二区三区四区五区黄| 亚洲伦理在线免费看| 亚洲欧美国产高清| 国产欧美二区| 久久精品国产欧美亚洲人人爽| 亚洲欧美色婷婷| 国产亚洲一区二区精品| 久久免费国产精品| 久久综合九色欧美综合狠狠| 一色屋精品视频在线看| 亚洲二区视频在线| 欧美日韩国产一区精品一区| 亚洲在线1234| 久久久精品视频成人| 亚洲精选一区| 亚洲欧美国产高清va在线播| 韩国精品一区二区三区| 亚洲高清在线观看| 欧美色欧美亚洲另类二区| 久久精品99| 蜜臀99久久精品久久久久久软件| 亚洲国产老妈| 这里是久久伊人| 狠狠爱成人网| 日韩视频在线观看国产| 国产精品爽黄69| 女人香蕉久久**毛片精品| 欧美连裤袜在线视频| 久久精品国产一区二区三| 久热精品视频在线观看| 亚洲欧美一区二区视频| 久久国产精彩视频| 一本色道久久综合狠狠躁篇怎么玩| 亚洲一级在线| 亚洲电影免费观看高清完整版在线| 亚洲精品中文字幕女同| 国内自拍视频一区二区三区| 亚洲国内精品| 激情视频亚洲| 亚洲一区二区三区视频| 亚洲精品影视| 久久久五月天| 欧美一区二区性| 欧美日韩视频在线一区二区观看视频| 久久久久青草大香线综合精品| 欧美老女人xx| 欧美国产激情二区三区| 国产日韩亚洲| 洋洋av久久久久久久一区| 亚洲国产片色| 欧美中文在线观看| 午夜伦欧美伦电影理论片| 欧美黄色免费网站| 媚黑女一区二区| 国产日韩亚洲欧美| 亚洲综合国产激情另类一区| 夜夜狂射影院欧美极品| 免费成人av在线看| 久久视频国产精品免费视频在线| 国产精品多人| 艳女tv在线观看国产一区| 亚洲精品美女在线观看| 麻豆精品精华液| 欧美大胆人体视频| 亚洲国产精品第一区二区| 欧美一区二区在线免费观看| 欧美一区二区在线免费播放| 国产精品久久久久久五月尺| 在线视频免费在线观看一区二区| 一区二区三区波多野结衣在线观看| 免费一级欧美片在线播放| 欧美大片第1页| 亚洲精品欧美日韩| 欧美日韩mp4| 在线视频你懂得一区| 亚洲欧美日韩国产综合| 国产精品乱码久久久久久| 亚洲午夜一区二区| 久久精品国产99| 狠狠88综合久久久久综合网| 久久夜色撩人精品| 欧美激情视频免费观看| 99视频日韩| 国产精品美女久久| 香港久久久电影| 免费观看久久久4p| 亚洲每日在线| 欧美亚洲不卡| 久久精品论坛| 亚洲精品欧美| 欧美一区二区三区四区在线观看地址 | 久久婷婷麻豆| 亚洲精品婷婷| 久久黄金**| 亚洲国产欧美一区| 欧美午夜精品理论片a级大开眼界 欧美午夜精品理论片a级按摩 | 激情文学综合丁香| 欧美成人免费视频| 亚洲午夜极品| 欧美成人精品在线播放| 一本久道久久久| 国产日韩精品入口| 欧美成人一区二区三区片免费| 亚洲精品欧美一区二区三区| 欧美一区二区黄| 91久久国产精品91久久性色| 国产精品黄页免费高清在线观看| 午夜精品久久久久久99热| 亚洲第一狼人社区| 性欧美1819sex性高清| 亚洲国产欧美日韩精品| 国产精品每日更新| 免费在线国产精品| 亚洲欧美电影院| 亚洲精品中文字幕女同| 麻豆视频一区二区| 亚洲欧美日韩国产综合精品二区 | 欧美高清视频一区| 午夜久久黄色| 亚洲精选中文字幕| 欧美顶级艳妇交换群宴| 欧美在线看片a免费观看| 亚洲欧洲一二三| 国内精品久久久久影院优| 欧美日韩一区二| 欧美1区免费| 久久久久88色偷偷免费| 亚洲视频一区在线观看| 亚洲第一在线综合在线| 久久久女女女女999久久| 亚洲欧美激情视频在线观看一区二区三区| 狠狠色丁香久久婷婷综合丁香| 国产精品美女| 欧美三级视频| 欧美日韩国产欧美日美国产精品| 久久女同精品一区二区| 欧美在线3区| 亚洲欧美一级二级三级| 亚洲视频精选在线| av成人动漫| 一本色道久久加勒比88综合| 亚洲欧洲中文日韩久久av乱码| 猛干欧美女孩| 欧美大香线蕉线伊人久久国产精品| 久久性色av| 欧美不卡视频一区发布| 免费成人高清| 亚洲电影一级黄| 91久久精品国产91久久性色tv| 欧美激情视频给我| 亚洲人屁股眼子交8| 亚洲精品一级| 日韩午夜激情av| 亚洲网站在线| 午夜激情久久久| 久久国产直播| 久久伊人精品天天| 欧美国产日韩亚洲一区| 欧美精品色综合| 国产精品国产福利国产秒拍| 国产精品视频999| 国内精品久久久久久久果冻传媒| 黄色一区二区三区| 亚洲国产视频直播| 在线亚洲精品| 欧美在线视频导航| 另类专区欧美制服同性| 亚洲国产精品久久久久秋霞影院| 亚洲国产一区二区三区高清| 夜夜爽夜夜爽精品视频| 在线一区二区三区四区| 欧美一区二区三区久久精品茉莉花 | 亚洲一区二区三区四区五区黄 | 亚洲一区精品在线| 欧美在线中文字幕| 免费久久久一本精品久久区| 亚洲国产精品综合| 亚洲视频免费| 久久久久欧美精品| 欧美色图一区二区三区| 国产综合色在线视频区| 亚洲激情视频在线| 午夜老司机精品| 欧美激情亚洲精品| 亚洲欧美激情四射在线日| 久久综合五月天婷婷伊人| 欧美日韩亚洲一区二区三区在线| 国产一区91| 正在播放亚洲一区| 欧美1区2区| 午夜宅男久久久| 欧美日韩一区二区精品| 在线免费观看日本一区| 亚洲欧美日韩中文视频| 欧美成人一区二区三区在线观看| 亚洲性视频网站| 欧美激情综合五月色丁香| 国产一区二区精品丝袜| 亚洲一区二区欧美| 亚洲啪啪91|