C 命名的基本約定

2021-06-06 23:24:46 字數 4067 閱讀 2113

要使用可以準確說明變數/字段

/類的完整的英文描述符,如

firstname

。對一些作用顯而易見的變數可以採用簡單的命名,如在迴圈裡的遞增(減)變數就可以被命名為

」 i 」

。要盡量採用專案所涉及領域的術語。

要採用大小寫混合,提高名字的可讀性。為區分乙個識別符號中的多個單詞,把識別符號中的每個單詞的首字母大寫。不採用下劃線作分隔字元的寫法。有兩種適合的書寫方法,適應於不同型別的識別符號:

pasalcasing

:識別符號的第乙個單詞的字母大寫;

camelcasing

:識別符號的第乙個單詞的字母小寫。

下表描述了不同型別識別符號的大小寫規則:

識別符號

大小寫

示例

命名空間

pascal

namespace com.techstar.productioncenter型別

pascal

public class devslist介面

pascal

public inte***ce itablemodel方法

pascal

public void updatedata()屬性

pascal

public int length事件

pascal

public event eventhandler changed;

私有字段

camel

private string fieldname;

非私有字段

pascal

public string fieldname

;列舉值

pascal引數

camel

public void updatedata(string fieldname)

區域性變數

camel

string fieldname;

避免使用縮寫,如果一定要使用,就謹慎使用。同時,應該保留乙個標準縮寫的列表,並且在使用時保持一致。

對常見縮略詞,兩個字母的縮寫要採用統一大小寫的方式(示例:

iostream

,getiostream

);多字母縮寫採用首字母大寫,其他字母小寫的方式(示例:

gethtmltag

);避免使用長名字(最好不超過

15個字母)。

避免使用相似或者僅在大小寫上有區別的名字。

6.2.

各種標示符型別的命名約定

6.2.1.

程式集命名

公司網域名稱(

techstar)+

專案名稱

+ 模組名稱(可選),例如:

中心系統程式集:

techstar.productioncenter

;中心系統業務邏輯程式集:

techstar. productioncenter.business

;6.2.2.

命名空間命名

採用和程式集命名相同的方式:公司網域名稱(

techstar)+

專案名稱

+ 模組名稱。

另外,一般情況下建議命名空間和目錄結構相同。例如:

中心系統:

techstar.productioncenter

;中心系統下的使用者控制項:

techstar.productioncenter.usercontrol

;中心系統業務邏輯:

techstar. productioncenter.business

;中心系統資料訪問:

techstar. productioncenter.data

;6.2.3.

類和介面命名

類的名字要用名詞;

避免使用單詞的縮寫,除非它的縮寫已經廣為人知,如

。介面的名字要以字母

i開頭。保證對介面的標準實現名字只相差乙個

「i」字首,例如對

icomponent

的標準實現為

component

;泛型型別引數的命名:命名要為

t或者以

t開頭的描述性名字,例如:

public class list

public class myclass

對同一專案的不同命名空間中的類,命名避免重複。避免引用時的衝突和混淆;

6.2.4.

方法命名

第乙個單詞一般是動詞

如果方法返回乙個成員變數的值,方法名一般為

get+

成員變數名,如若返回的值

是bool

變數,一般以

is作為字首。另外,如果必要,考慮用屬性來替代方法,具

體建議見

10.1.2節;

如果方法修改乙個成員變數的值,方法名一般為:

set +

成員變數名。同上,考慮

用屬性來替代方法;

6.2.5.

變數命名

按照使用範圍來分,我們**中的變數的基本上有以下幾種型別,類的公有變數;類的私有變數(受保護同公有);方法的引數變數;方法內部使用的區域性變數。這些變數的命名規則基本相同,見識別符號大小寫對照表。區別如下:

i. 類的公有變數按通常的方式命名,無特殊要求;

ii.

類的私有變數採用兩種方式均可:採用加

「m」字首,例如

mworkername;

iii.

方法的引數變數採用

camalstring

,例如workername

;iv.

方法內部的區域性變數採用

camalstring

,例如workername

;不要用_或

&作為第乙個字母;

盡量要使用短而且具有意義的單詞;

單字元的變數名一般只用於生命期非常短暫的變數。

i,j,k,m,n

一般用於

integer

;c,d,e

一般用於

characters;s

用於string

如果變數是集合,則變數名要用複數。例如**的行數,命名應為:

rowscount

;命名元件要採用匈牙利命名法,所有字首均應遵循同乙個元件名稱縮寫列表

6.3.

元件名稱縮寫列表

縮寫的基本原則是取元件類名各單詞的第乙個字母,如果只有乙個單詞,則去掉其中的母音,留下子音。縮寫全部為小寫。

元件型別

縮寫             

例子                

label

lbllblnote

textbox

txttxtname

button

btnbtnok

imagebutton

ibibok

linkbutton

lblbjump

hyperlink

hlhljump

dropdownlist

ddlddllist

checkbox

cbcbchoice

checkboxlist

cblcblgroup

radiobutton

rbrbchoice

radiobuttonlist

rblrblgroup

image

imgimgbeauty

panel

pnlpnltree

treeview

tvtvunit

webcomtable

wctwctbasic

imagedatetimeinput

dtidtistart

combobox

cbcblist

myimagebutton

mibmibok

webcomm.treeview

tvtvunit

pagebar

pbpbmaster

C 命名約定

駝峰原則,即除第乙個單詞首字母小寫,其它大寫,如 int firstnumber 當然,還有一種基於駝峰原則的叫做匈牙利法,首字母指明了變數的型別如 int ifirstnumber i表示變數型別為int隨著ide的改進,游標會提示變數的型別,但是個人認為匈牙利法仍具有重要意義,因為它一目了然!帕...

C 命名約定

c 語言規範建議使用特定大小寫約定建立識別符號。對於大多數識別符號,應該使用pascal大小寫風格,在這種風格中,連線成識別符號的每個單詞都首字母大寫,例如firstname和lastname。一 pascal大小寫 描述 識別符號中每個單詞都首字母大寫。使用建議 用於型別名和成員名,示例 card...

命名規範 C 命名規範約定

命名規則約定 序 號描述示例 1類命名混合使用大小寫,首字母大寫 classname 2型別定義,包括列舉和typedef,混合使用大小寫,首字母大寫 typename 3區域性變數混合使用大小寫,且首字母小寫,名字與底層資料型別無關,且應該反映其所代表的事物 localvariable 4子程式引...