C語言程式設計規範4 命名規則

2021-07-07 06:10:43 字數 1992 閱讀 4827

我們不僅要寫高效的**,還要寫可讀性很強的**,隨著我們所開發系統的複雜性的不斷提高,這就要求我們所寫的程式具有3個特性:1、可讀性;2、可多人協作性;3、可移植性。但是,像我們這樣電子專業畢業的學生,都沒有接受過「軟體設計方**」、「作業系統原理」等課程的深入訓練,這就使我們所寫的程式與軟體專業工程師所寫的程式具有較大的差距,這些問題使得公司在程式的**維護上面臨著諸多的困難。這種窘境需要打破!

本文從「c語言程式設計規範」著手,著重講授如何書寫規範性的c語言程式**,文中所舉例項,均為知名公司所採用的c語言規範。按照本系列課程嚴格要求自己規範性編寫c語言**,可使得我們書寫的程式給人耳目一新的感覺,易於閱讀,並避免潛在的邏輯性錯誤的發生。

命名規則;

a、函式

函式的規模盡量限制在200行以內,函式名應該能體現該函式完成的功能,建議採用動詞+名次的形式。關鍵部分應該採用完整的單詞,輔助部分若太長可採用縮寫,縮寫應符合英文的規範。每個單詞的第乙個字母大寫。

showpoints ctrldestboard sendresetmsg

識別符號的命名要清晰、明了,有明確含義,同時使用完整的單詞或大家基本可以理解的縮寫,避免使人產生誤解。

說明:較短的單詞可通過去掉「母音」形成縮寫;較長的單詞可取單詞的頭幾個字母形成縮寫;一些單詞有大家公認的縮寫。

temp 可縮寫為 tmp ;

flag 可縮寫為 *** ;

statistic 可縮寫為 stat ;

increment 可縮寫為 inc ;

message 可縮寫為 msg ;

b、變數

①在命名常量時,用大寫:max_value

②結構:結構的定義有兩個名稱,乙個是該結構的型別名,乙個是變數名。按照c語言的語法,這兩個名稱都是可選的,但二者必有其一。我們要求寫型別名,型別名以tag作字首。

struct tagmodel 

model;

tagmodel direction;

對於程式中的常用的結構,希望能使用typedef定義,

typedef struct tagmodel 

model, pmodel;

③聯合:(同上)

④變數的命名建議採用名詞和匈牙利命名規則,變數的第乙個字母小寫,表示其資料型別。

int iindex,icount;

char cindex,cserialout;

指標型別 psever, pmsg;

⑤對於變數命名,禁止取單個字元(如i、j、k...),建議除了要有具體含義外,還能表明其變數型別、資料型別等,但i、j、k作區域性迴圈變數是允許的。

說明:變數,尤其是區域性變數,如果用單個字元表示,很容易敲錯(如i寫成j),而編譯時又檢查不出來,有可能為了這個小小的錯誤而花費大量的查錯時間。

示例:下面所示的區域性變數名的定義方法可以借鑑。

int liv_width

其變數名解釋如下:

l 區域性變數(local) (其它:g 全域性變數(global)...)

i 資料型別(interger)

v 變數(variable) (其它:c 常量(const)...)

width 變數含義

這樣可以防止區域性變數與全域性變數重名。

⑥採用unix的大小寫混排的方式,不要使用大小寫與下劃線混排的方式,用作特殊標識如標識成員變數或全域性變數的m_和g_,其後加上大小寫混排的方式是允許的。

adduser m_adduser

⑦除非必要,不要用數字或較奇怪的字元來定義識別符號。

示例:如下命名,使人產生疑惑。

#define _example_0_test_

#define _example_1_test_

void set_sls00( byte sls );

應改為有意義的單詞命名

#define _example_unit_test_

#define _example_assert_test_

void set_udt_msg_sls( byte sls );

。csdn:

C 程式設計規範 第3章 命名規則

比較 著名的命名規則當推 microsoft 公司的 匈牙利 法,該命名規則的主要思想是 在變數和函式名中加入字首以增進人們對程式的理解 例如所有的字元變數均以ch為字首,若是指標變數則追加字首p。如果乙個變數由ppch開頭,則表明它是指向字元指標的指標。匈牙利 法最大的缺點是煩瑣,例如 inti,...

C 程式設計命名規範

c 程式設計命名規範 ps 根據多年工作經驗和其它命名規範整理而成,個人感覺比較規範的標準,現應用於我的開發團隊。檔名 函式名 變數名命名應具有描述性,不要過度的縮寫,型別變數是名詞,函式名是動詞或動詞 名詞。函式名必須是指令性的,非常普遍性的才用縮寫。c 檔案應以.cpp,標頭檔案以.h結尾,檔名...

C 程式設計命名規範

命名規範是乙個十分重要但有比較有爭議的話題,本文主要談一下我的體會並介紹一種較常用的c 命名規範。匈牙利命名法 我最早接觸到的命名規範是匈牙利命名法,該方法出自微軟,基本上是一些在你的所有變數前建立乙個字首的規則。這個字首會說明那個變數的型別。其好處在於,通過它們的字首,你可以方便地知道兩個變數是否...