C++ 入門指南 4.01

單元 5 - 變數命名規則

-unit5-

程式 (program) 裡需要自行命名的識別字 (identifier) 非常多,例如變數 (variable) 函數 (function) 類別 (class) 成員 (member) 等等

#include <iostream>
#include <string>
using namespace std;
int main(void)
{
    string m("There is no spoon.");
    cout << endl << m << endl << endl << endl;
    return 0;
}

以上用紅色框起來的字都是識別字。

有些名稱是自行定義的,有些名稱則屬於標準程式庫 (standard library) 中已經定義好的,例如 stringcout 等。標準程式庫是依 C++ 標準隨編譯器 (compiler) 提供的程式庫 (library) ,提供非常多樣的功能,例如資料結構、處理時間、輸入輸出、圖形介面、網路通訊等,我們在需要時可以引入所需的程式庫,無須自行開發相同或類似的程式。

標準程式庫裡頭的東西都是開發完成、測試無誤的,很多經常使用的程式都無須從頭開發自己的版本,這個好處大大節省了我們開發軟體的時間。

我們自行定義的識別字應避免與標準程式庫中的相同,如果我們定義相同的識別字名稱,雖然可以通過編譯,但容易造成混淆或名稱衝突,因此應避免,例如以下程式

#include <iostream>

using namespace std;

int main(void) {
    // 變數 string 用到跟程式庫相同的識別字
    char string[] = {'h', 'e', 'l', 'l', 'o', '\0'};

    cout << endl << string << endl << endl << endl;

    return 0;
}

/* 《程式語言教學誌》的範例程式
   http://kaiching.org/
   檔名:wrong_name.cxx
   功能:示範錯誤的命名
   作者:張凱慶 */

這個例子中我們用 string 當變數名稱,編譯執行都是沒有問題的

-wrongname.png-

但是當我們要用到標準程式庫中的 string 來宣告變數時,這裡就會產生名稱衝突。簡單說, wrong_name.cxxmain() 已經有 string 當區域變數,之後再用任何 string 都是指已經建立的區域變數 string ,而非標準程式庫中的 string 類別,因而造成標準程式庫中的識別字 string 無法使用。

至於識別字命名是採用英文二十六的大小寫字母為主,另加上數字、底線符號,如下

_
a b c d e f g
h i j k l m n
o p q r s t u
v w x y z
A B C D E F G
H I J K L M N
O P Q R S T U
V W X Y Z
0 1 2 3 4 5 6
7 8 9

基本上變數或識別字的命名習慣以簡單、清楚為原則,常見的就是小寫英文單字

iter
total
screen
rfind

或是以底線連接的英文單字組合小寫英文單字

exam_score
test_result
my_file
find_first_of

數字不能當作識別字的開頭,另外建議識別字不要用連續兩個底線命名。

每個英文單字之間也不可以有空格,空格是區別兩個程式中記號 (token) 的符號。

型態 (type) 使用的識別字,例如類別 (class) 結構 (structure) 列舉 (enumeration) 等,這些比較常採大寫駝峰型 (upper camel case)

SimpleGame
MyStory
ThreadTestDrive
RunThreads

函數的命名也是以大寫駝峰型為主,第一個單字通常採動詞

DoSomething()
Rotate()
LoadRecord()
ForgetIt()

另外簡單的函數,或是類別裡的存取函數 (accessor) 修改函數 (mutator) ,比較常用英文小寫字母組合

set_number()
get_number()
is_present()
gcd()

以上舉出一些基本常見的命名習慣,許多也見於標準程式庫中,至於其他第三方程式庫可能有不同的命名習慣,例如我們在 GUI 篇要介紹的 Qt , Qt 在函數的命名習慣部分,偏向小寫駝峰型 (lower camel case)

actionPerformed()
setUpNetworking()
getField()
myField()

當然仔細來講,標準程式庫跟其他第三方程式庫的命名習慣可能還有很多不同,倒是我們先要掌握基本的命名規則,日後學習其他的程式庫再去熟習命名習慣囉!

程式的每一行都要以分號結尾,若是漏打分號的話,編譯器還會中斷編譯,並且提供警告訊息,因為有分號結尾的程式碼,在 C++ 稱之為陳述 (statement) ,簡單的陳述可由運算式 (expression) 組成,接下來我們開始介紹運算式與陳述囉!

中英文術語對照
存取函數accessor
類別class
編譯器compiler
列舉enumeration
運算式expression
函數function
識別字identifier
程式庫library
小寫駝峰型lower camel case
成員member
修改函數mutator
程式program
標準程式庫standard library
陳述statement
結構structure
記號token
大寫駝峰型upper camel case
變數variable
重點整理
1. 自行命名的識別字應該避免與標準程式庫中相同。
2. C++ 接受的命名符號包括底線、大小寫英文字母及數字。
3. 識別字多採有意義的英文單字組合,型態、函數名稱多採大寫駝峰型,變數、簡單的函數則用小寫英文字母組合。
4. 第三方程式庫如 Qt 的命行習慣,不見得會和標準程式庫中相同。
5. 分號為陳述的結尾,漏打分號會產生編譯錯誤。
問題與討論
1. 數字為什麼不可以當作識別字的起始字元?
2. 為什麼建議識別字中不要用連續兩個底線?
3. 為什麼識別字中不可以有空格?
4. 為什麼命名變數要用有意義的英文單字?
5. 大寫駝峰型跟小寫駝峰型的差別在哪裡?為什麼要有不同的命名習慣?
練習
1. 寫一個程式 exercise0501.cxx ,命名一個接收使用者輸入的字串變數,利用 cin >> 其後接字串變數來接收使用者輸入,然後在命令列把該字串變數印出來。 參考程式碼
2. 寫一個程式 exercise0502.cxx ,命名一個計數用的整數變數,初始化為 0 ,利用遞增運算子 ++ 遞增,然後在命令列把該整數變數印出來。 參考程式碼
3. 寫一個程式 exercise0503.cxx ,命名一個暫存計算結果的整數變數,初始化為 100 ,利用加等於 += 將該變數加上整數 100 ,然後在命令列把該整數變數印出來。 參考程式碼
4. 寫一個程式 exercise0504.cxx ,命名一個迴圈用的整數變數,初始化為 0 ,利用加等於 while 迴圈將該變數遞增到整數 5 ,然後在命令列把該整數變數最後的值印出來。 參考程式碼
5. 寫一個程式 exercise0505.cxx ,命名圓周率常數 PI 的變數,初始化為 3.14 ,然後在命令列把圓周率常數 PI 印出來。 參考程式碼
6. 寫一個程式 exercise0506.cxx ,用數字命令變數,例如 2 ,觀察編譯結果。 參考程式碼
7. 寫一個程式 exercise0507.cxx ,用數字當變數的起始字元,例如 2m ,觀察編譯結果。 參考程式碼
8. 寫一個程式 exercise0508.cxx ,用底線當變數的名稱,例如 _ ,觀察編譯結果。 參考程式碼
9. 寫一個程式 exercise0509.cxx ,用中文當變數的名稱,例如中文 ,觀察編譯結果。 參考程式碼
10. 寫一個程式 exercise0510.cxx ,設計一個 int 變數 apple_num ,然後把 apple_num 中的底線改成空格,觀察編譯結果。 參考程式碼

相關教學影片

上一頁 單元 4 - 指標與參考
回 C++ 入門指南 4.01 目錄
下一頁 單元 6 - 運算式與陳述
回 C++ 教材
回程式語言教材首頁