【79.1 命名規范的必要。】
一個大型的項目程序,涉及到的變量常量非常多,各種變量常量眼花繚亂,名字不規范就無法輕松掌控全局。若能一開始就遵守特定的命名規范,則普天之下,率土之濱,都被你牢牢地掌控在手里,天下再也沒有難維護的代碼。本節教給大家的是我多年實踐所沿用的命名規范和習慣,它不是唯一絕對的,只是給大家參考,大家今后也可以在自己的實踐中慢慢總結出一套適合自己的命名規范和習慣。
【79.2 普通變量常量的命名規范和習慣。】
在C51編譯器的平臺下,unsigned char ,unsigned int ,unsigned long三類常用的變量代表了“無符號的8位,16位,32位”,這類型的變量前綴分別加“u8,u16,u32”來表示。但是這種類型的變量還分全局變量和局部變量,為了有所區分,就在全局變量前加“G”來表示,不帶“G”的就默認是局部變量。比如:
unsigned char Gu8Number; //Gu8就代表全局的8位變量
unsigned int Gu16Number; //Gu16就代表全局的16位變量
unsigned long Gu32Number; //Gu32就代表全局的32位變量
void HanShu(unsigned char u8Data) //u8就代表局部的8位變量
{
unsigned char u8Number; //u8就代表局部的8位變量
unsigned int u16Number; //u16就代表局部的16位變量
unsigned long u32Number; //u32就代表局部的32位變量
}
全局變量和局部變量繼續往下細分,還分“靜態”和“非靜態”,為了有所區分,就在前面增加“ES”或“S”來表示,“ES”代表全局的靜態變量,“S”代表局部的靜態變量。比如:
static unsigned char ESu8Number; //ESu8就代表全局的8位靜態變量
static unsigned int ESu16Number; //ESu16就代表全局的16位靜態變量
static unsigned long ESu32Number; //ESu32就代表全局的32位靜態變量
void HanShu(unsigned char u8Data) //u8就代表局部的8位變量
{
static unsigned char Su8Number; //Su8就代表局部的8位靜態變量
static unsigned int Su16Number; //Su16就代表局部的16位靜態變量
static unsigned long Su32Number; //Su32就代表局部的32位靜態變量
}
剛才講的只是針對“變量”,如果是“常量”,則前綴加“C”來表示,不管是全局的常量還是局部的常量,都統一用“C”來表示,不再刻意區分“全局常量”和“靜態常量”,比如:
const unsigned char Cu8Number=1; //Cu8就代表8位常量,不刻意區分“全局”和“局部”
const unsigned int Cu16Number=1; //Cu16就代表16位常量,不刻意區分“全局”和“局部”
const unsigned long Cu32Number=1; //Cu32就代表32位常量,不刻意區分“全局”和“局部”
void HanShu(unsigned char u8Data) //u8就代表局部的8位變量
{
const unsigned char Cu8Number=1; //Cu8就代表8位常量,不刻意區分“全局”和“局部”
const unsigned int Cu16Number=1; //Cu16就代表16位常量,不刻意區分“全局”和“局部”
const unsigned long Cu32Number=1; //Cu32就代表32位常量,不刻意區分“全局”和“局部”
}
【79.3 循環體變量的命名規范和習慣。】
循環體變量是一個很特定場合用的變量,為了突出它的特殊,這類變量在命名上用單個字母,可以不遵守命名規范,這里的“不遵守命名規范”就是它的“命名規范”,頗有道家“無為就是有為”的韻味,它是命名界的另類。比如:
unsigned char i; //超越了規則約束的循環體變量,用單個字母來表示。
unsigned long k; //超越了規則約束的循環體變量,用單個字母來表示。
void HanShu(unsigned char u8Data) //u8就代表局部的8位變量
{
unsigned int c; //超越了規則約束的循環體變量,用單個字母來表示。
for(c=0;c<5;c++) //用在循環體的變量
{
u8Data=u8Data+1; //u8就代表局部的8位變量
}
for(i=0;i<5;i++) //用在循環體的變量
{
u8Data=u8Data+1; //u8就代表局部的8位變量
}
for(k=0;k<5;k++) //用在循環體的變量
{
u8Data=u8Data+1; //u8就代表局部的8位變量
}
}
【79.4 數組的命名規范和習慣。】
數組有四種應用場合,一種是普通數組,一種是字符串,一種是表格,一種是信息。在命名上分別加入后綴“Buffer,String,Table,Message”來區分,但是它們都是數組。比如:
unsigned int Gu16NumberBuffer\[5\]; //后綴是Buffer。16位的全局變量數組。用在普通數組。
unsigned char Gu8NumberString\[5\]; //后綴是String。8位的全局變量數組。用在字符串。
//根據原理圖得出的共陰數碼管字模表
code unsigned char Cu8DigTable\[\]=//后綴是Table。這里的code是代表C51的常量(類似const)。
{
0x3f, //0 序號0
0x06, //1 序號1
0x5b, //2 序號2
0x4f, //3 序號3
0x66, //4 序號4
0x6d, //5 序號5
0x7d, //6 序號6
0x07, //7 序號7
0x7f, //8 序號8
0x6f, //9 序號9
0x00, //不顯示 序號10
};
void HanShu(unsigned char u8Data) //u8就代表局部的8位變量
{
unsigned char u8NumberMessage\[5\]; //后綴是Message。8位的局部變量數組。用在信息。
}
【79.5 指針的命名規范和習慣。】
指針的前綴加“p”來區分。再往下細分,指針有全局和局部,有“靜態”和“非靜態”,有“8位寬度”和“16位寬度”和“32位寬度”,有變量指針和常量指針。比如:
unsigned char \*pGu8NumberString; //pGu8代表全局的8位變量指針
void HanShu(const unsigned char \*pCu8Data) //pCu8代表局部的8位常量指針
{
unsigned char \*pu8NumberBuffer; //pu8代表局部的8位變量指針
static unsigned int \*pSu16NumberBuffer; //pSu16代表局部的16位靜態變量指針
static unsigned long \*pSu32NumberBuffer; //pSu32代表局部的32位靜態變量指針
}
【79.6 結構體的命名規范和習慣。】
結構體的前綴加“t”來區分。再往下細分,指針有全局和局部,有“靜態”和“非靜態”,有結構體變量和結構體指針。比如:
struct StructSignData //帶符號的數
{
unsigned char u8Sign; //符號 0為正數 1為負數
unsigned long u32Data; //數值
};
struct StructSignData GtNumber; //Gt代表全局的結構體變量。
void HanShu(struct StructSignData \*ptData) //pt代表局部的結構體指針
{
struct StructSignData tNumber; //t代表局部的結構體變量。
static struct StructSignData StNumber; //St代表局部的靜態結構體變量。
}
【79.7 宏常量的命名規范和習慣。】
所謂“宏常量”往往是指用#define語句定義的常量。宏常量的所有字符都用大寫字母。比如:
\#define DELAY\_TIME 30 //宏常量所有字符都用大寫字母。DELAY\_TIME代表延時的時間。
void HanShu(void)
{
delay(DELAY\_TIME); //相當于delay(30),這里的delay代表某個延時函數(這里沒有具體寫出來)
}
【79.8 首字符用大寫字母以及下劃線“\_”的靈活運用。】
兩個以上的英文單詞連在一起命名時,每個單詞的首字符用大寫,其余用小寫,這樣可以把每個單詞“斷句”開來,方便閱讀。如果遇到兩個英文單詞連在一起不好“斷句”的情況(比如某個英文單詞全部是大寫字母的專用名詞),只要在兩個英文單詞之間插入下劃線“\_”就可以清晰的“斷句”了。比如:
unsigned long Gu32GetFileLength; //GetFileLength寓意“獲取某個文件的長度”。
unsigned char Gu8ESD\_Flag; //ESD是專業用名詞,代表“靜電釋放”的意思。用下劃線“\_”斷句。
- 首頁
- 第一節:我的價值觀
- 第二節:初學者的疑惑
- 第三節:單片機最重要的一個特性
- 第四節:平臺軟件和編譯器軟件的簡介
- 第五節:用Keil2軟件關閉,新建,打開一個工程的操作流程
- 第六節:把.c源代碼編譯成.hex機器碼的操作流程
- 第七節:本節預留
- 第八節:把.hex機器碼程序燒錄到單片機的操作流程
- 第九節:本節預留
- 第十節:程序從哪里開始,要到哪里去?
- 第十一節:一個在單片機上練習C語言的模板程序
- 第十二節:變量的定義和賦值
- 【TODO】第十三節:賦值語句的覆蓋性
- 【TODO】第十四節:二進制與字節單位,以及常用三種變量的取值范圍
- 【TODO】第十五節:二進制與十六進制
- 【TODO】第十六節:十進制與十六進制
- 【TODO】第十七節:加法運算的5種常用組合
- 【TODO】第十八節:連加、自加、自加簡寫、自加1
- 【TODO】第十九節:加法運算的溢出
- 【TODO】第二十節:隱藏中間變量為何物?
- 【TODO】第二十一節:減法運算的5種常用組合。
- 【TODO】第二十二節:連減、自減、自減簡寫、自減1
- 【TODO】第二十三節:減法溢出與假想借位
- 【TODO】第二十四節:借用unsigned long類型的中間變量可以減少溢出現象
- 【TODO】第二十五節:乘法運算中的5種常用組合
- 【TODO】第二十六節:連乘、自乘、自乘簡寫,溢出
- 【TODO】第二十七節:整除求商
- 【TODO】第二十八節:整除求余
- 【TODO】第二十九節:“先余后商”和“先商后余”提取數據某位,哪家強?
- 【TODO】第三十節:邏輯運算符的“與”運算
- 【TODO】第三十一節:邏輯運算符的“或”運算
- 【TODO】第三十二節:邏輯運算符的“異或”運算
- 【TODO】第三十三節:邏輯運算符的“按位取反”和“非”運算
- 【TODO】第三十四節:移位運算的左移
- 【TODO】第三十五節:移位運算的右移
- 【TODO】第三十六節:括號的強制功能---改變運算優先級
- 【TODO】第三十七節:單字節變量賦值給多字節變量的疑惑
- 【TODO】第三十八節:第二種解決“運算過程中意外溢出”的便捷方法
- 【TODO】第三十九節:if判斷語句以及常量變量的真假判斷
- 【TODO】第四十節:關系符的等于“==”和不等于“!=”
- 【TODO】第四十一節:關系符的大于“>”和大于等于“>=”
- 【TODO】第四十二節:關系符的小于“<”和小于等于“<=”
- 【TODO】第四十三節:關系符中的關系符:與“&&”,或“||”
- 【TODO】第四十四節:小括號改變判斷優先級
- 【TODO】第四十五節: 組合判斷if...else if...else
- 【TODO】第四十六節: 一維數組
- 【TODO】第四十七節: 二維數組
- 【TODO】第四十八節: while循環語句
- 【TODO】第四十九節: 循環語句do while和for
- 【TODO】第五十節: 循環體內的continue和break語句
- 【TODO】第五十一節: for和while的循環嵌套
- 【TODO】第五十二節: 支撐程序框架的switch語句
- 【TODO】第五十三節: 使用函數的三要素和執行順序
- 【TODO】第五十四節: 從全局變量和局部變量中感悟“棧”為何物
- 【TODO】第五十五節: 函數的作用和四種常見書寫類型
- 【TODO】第五十六節: return在函數中的作用以及四個容易被忽略的功能
- 【TODO】第五十七節: static的重要作用
- 【TODO】第五十八節: const(./book/或code)在定義數據時的作用
- 【TODO】第五十九節: 全局“一鍵替換”功能的#define
- 【TODO】第六十節: 指針在變量(./book/或常量)中的基礎知識
- 【TODO】第六十一節: 指針的中轉站作用,地址自加法,地址偏移法
- 【TODO】第六十二節: 指針,大小端,化整為零,化零為整
- 【TODO】第六十三節: 指針“化整為零”和“化零為整”的“靈活”應用
- 【TODO】第六十四節: 指針讓函數具備了多個相當于return的輸出口
- 【TODO】第六十五節: 指針作為數組在函數中的入口作用
- 【TODO】第六十六節: 指針作為數組在函數中的出口作用
- 【TODO】第六十七節: 指針作為數組在函數中既“入口”又“出口”的作用
- 【TODO】第六十八節: 為函數接口指針“定向”的const關鍵詞
- 【TODO】第六十九節: 宏函數sizeof(./book/)
- 【TODO】第七十節: “萬能數組”的結構體
- 【TODO】第七十一節: 結構體的內存和賦值
- 【TODO】第七十二節: 結構體的指針
- 【TODO】第七十三節: 結構體數據的傳輸存儲和還原
- 【TODO】第七十四節: 結構體指針在函數接口處的頻繁應用
- 【TODO】第七十五節: 指針的名義(例:一維指針操作二維數組)
- 【TODO】第七十六節: 二維數組的指針
- 【TODO】第七十七節: 指針唯一的“單向輸出”通道return
- 【TODO】第七十八節: typedef和#define和enum
- 【TODO】第七十九節: 各種變量常量的命名規范
- 【TODO】第八十節: 單片機IO口驅動LED
- 【TODO】第八十一節: 時間和速度的起源(指令周期和晶振頻率)
- 【TODO】第八十二節: Delay“阻塞”延時控制LED閃爍
- 【TODO】第八十三節: 累計主循環的“非阻塞”延時控制LED閃爍
- 【TODO】第八十四節: 中斷與中斷函數
- 【TODO】第八十五節: 定時中斷的寄存器配置
- 【TODO】第八十六節: 定時中斷的“非阻塞”延時控制LED閃爍
- 【TODO】第八十七節: 一個定時中斷產生N個軟件定時器
- 【TODO】第八十八節: 兩大核心框架理論(四區一線,switch外加定時中斷)
- 【TODO】第八十九節: 跑馬燈的三種境界
- 【TODO】第九十節: 多任務并行處理兩路跑馬燈
- 【TODO】第九十一節: 蜂鳴器的“非阻塞”驅動
- 【TODO】第九十二節: 獨立按鍵的四大要素(自鎖,消抖,非阻塞,清零式濾波)
- 【TODO】第九十三節: 獨立按鍵鼠標式的單擊與雙擊
- 【TODO】第九十四節: 兩個獨立按鍵構成的組合按鍵
- 【TODO】第九十五節: 兩個獨立按鍵的“電腦鍵盤式”組合按鍵
- 【TODO】第九十六節: 獨立按鍵“一鍵兩用”的短按與長按
- 【TODO】第九十七節: 獨立按鍵按住不松手的連續均勻觸發
- 【TODO】第九十八節: 獨立按鍵按住不松手的“先加速后勻速”的觸發
- 【TODO】第九十九節: “行列掃描式”矩陣按鍵的單個觸發(原始版)
- 【TODO】第一百節: “行列掃描式”矩陣按鍵的單個觸發(優化版)
- 【TODO】第一百零一節: 矩陣按鍵鼠標式的單擊與雙擊
- 【TODO】第一百零二節: 兩個“任意行輸入”矩陣按鍵的“有序”組合觸發
- 【TODO】第一百零三節: 兩個“任意行輸入”矩陣按鍵的“無序”組合觸發
- 【TODO】第一百零四節: 矩陣按鍵“一鍵兩用”的短按與長按
- 【TODO】第一百零五節: 矩陣按鍵按住不松手的連續均勻觸發
- 【TODO】第一百零六節: 矩陣按鍵按住不松手的“先加速后勻速”觸發
- 【TODO】第一百零七節: 開關感應器的識別與軟件濾波
- 【TODO】第一百零八節: 按鍵控制跑馬燈的啟動和暫停和停止
- 【TODO】第一百零九節: 按鍵控制跑馬燈的方向
- 【TODO】第一百一十節: 按鍵控制跑馬燈的速度
- 第一百一十一節: 工業自動化設備的開關信號的運動控制
- 【TODO】第一百一十二節: 數碼管顯示的基礎知識
- 【TODO】第一百一十三節: 動態掃描的數碼管顯示數字
- 【TODO】第一百一十四節: 動態掃描的數碼管顯示小數點
- 【TODO】第一百一十五節: 按鍵控制數碼管的秒表
- 【TODO】第一百一十六節: 按鍵控制數碼管的倒計時
- 【TODO】第一百一十七節: 按鍵切換數碼管窗口來設置參數
- 【TODO】第一百一十八節: 按鍵讓某位數碼管閃爍跳動來設置參數
- 【TODO】第一百一十九節: 一個完整的人機界面的程序框架的脈絡
- 【TODO】第一百二十節: 按鍵切換窗口切換局部來設置參數
- 【TODO】第一百二十一節: 可調參數的數碼管倒計時
- 【TODO】第一百二十二節: 利用定時中斷做的“時分秒”數顯時鐘
- 【TODO】第一百二十三節: 一種能省去一個lock自鎖變量的按鍵驅動程序
- 【TODO】第一百二十四節: 數顯儀表盤顯示“速度、方向、計數器”的跑馬燈
- 【TODO】第一百二十五節: “雙線”的肢體接觸通信
- 【TODO】第一百二十六節: “單線”的肢體接觸通信
- 【TODO】第一百二十七節: 單片機串口接收數據的機制
- 【TODO】第一百二十八節: 接收“固定協議”的串口程序框架
- 【TODO】第一百二十九節: 接收帶“動態密匙”與“累加和”校驗數據的串口程序框架
- 【TODO】第一百三十節: 接收帶“動態密匙”與“異或”校驗數據的串口程序框架
- 【TODO】第一百三十一節: 靈活切換各種不同大小“接收內存”的串口程序框架
- 【TODO】第一百三十二節:“轉發、透傳、多種協議并存”的雙緩存串口程序框架
- 【TODO】第一百三十三節:常用的三種串口發送函數
- 【TODO】第一百三十四節:“應用層半雙工”雙機串口通訊的程序框架