教材 / AA 競程語法書 上冊 / 第一單元 / Token 與排版規則

1.5 Token 與排版規則

「Token」是程式碼中的最小單位——就像英文句子由單詞組成,程式碼由 token 組成。認識 token 有兩個用處:看懂程式碼的結構,以及看懂編譯錯誤訊息——編譯器報錯時,就是用下面這些名稱在指程式裡的某一個字。

Token 分為 5 類。括號裡是英文名稱;最右欄是把那一類寫錯時,g++ 編譯器實際印出的錯誤訊息:

類型 說明 例子 寫錯時的編譯錯誤訊息
關鍵字(keyword) C++ 保留的特殊詞,不能拿來當名字 int、return、using、namespace 把 return 當變數名(int return = 5;):expected unqualified-id before 'return'
識別碼(identifier) 你自己取的名字 a、sum、myFunction 用了沒宣告的名字(cin >> a;):'a' was not declared in this scope
字面常數(literal) 直接寫的值(數字或文字) 5、3.14、"Hello" cout 和 "Hello" 之間漏了 <<(cout "Hello";):expected ';' before string constant
運算子(operator) 計算或比較的符號 +、-、*、/、<<、>> 讀入的箭頭寫反(cin << a;):no match for 'operator<<'
特殊符號(punctuator) 程式結構的符號 ;、{、}、()、, 括號沒關(int a = (3 + 4;):expected ')' before ';' token

對照著讀:string constant/numeric constant 就是字面常數,'operator<<' 是運算子,unqualified-id 是編譯器對「名字(識別碼)」的叫法,token 就是 token 本身。這些名稱值得記起來——編譯器就是用它們在指程式裡的某一個字;訊息的格式與讀法見 1.4,常見錯誤怎麼修見 1.9。

例子拆解

int a = 5;
  • int — 關鍵字(keyword)
  • a — 識別碼(identifier)
  • = — 運算子(operator)
  • 5 — 字面常數(literal)
  • ; — 特殊符號(punctuator)

排版規則

C++ 對空格、縮排的要求不嚴格,但為了可讀性,我們要遵守基本規則:

規則 ✓ 好的做法 ✗ 不好的做法 為什麼
運算子周圍 int sum = a + b; int sum=a+b; 加空格讓程式更容易讀
逗號後面 int a, b, c; int a,b,c; 逗號後面加空格
括號前後 main() main ( ) 括號緊貼前面的名稱,括號裡面也不留空格

縮排:讓「誰在誰裡面」一眼看出來

排版規則裡最重要的是縮排——就是把某些行的開頭往右推幾個空格再開始寫。回頭看 1.1 的 Hello World:

int main() {
    cout << "Hello World" << endl;
    return 0;
}

main() 後面那對大括號 { } 框住的是「main 要做的事」。注意裡面的 cout 和 return 0;,開頭都先空了幾格(這裡是 4 格)才開始寫——這就是縮排。它讓你一眼看出「這兩行是包在 main 裡面的」。1.3 的 A+B 也一樣,int a, b;、cin >> a >> b; 這些 main 裡的動作,全都往右縮了一層。

C++ 其實不強迫你縮排(就算每行都頂著最左邊也能編譯成功),但沒縮排的程式很難讀。等之後寫到一層包一層的結構(例如迴圈裡再放迴圈),就全靠縮排才看得出層次。所以從現在開始養成習慣:每進到一層 { } 裡面,就往右縮一層(固定縮 2~4 格)。

換行:一行一個指令

C++ 不在意你怎麼換行——把 1.3 的 A+B 除了第一行以外全部擠成一行,照樣能編譯、執行:

#include <iostream>
using namespace std; int main() { int a, b; cin >> a >> b; int sum = a + b; cout << sum << endl; return 0; }

(#include 那一行例外:它是給編譯器的「前置處理指令」,必須自己獨占一行,不能和別的東西擠在一起。另外 1.7 會教的 // 註解,也是到換行為止。)

但這樣很難讀,出錯時也不好看出是哪一個指令出問題。養成習慣:一行只寫一個指令,像 1.3 原本那樣一行一個動作,再配合上面說的縮排,清清楚楚:

#include <iostream>
using namespace std;

int main() {
    int a, b;
    cin >> a >> b;
    int sum = a + b;
    cout << sum << endl;
    return 0;
}

動手試試看: 把上面擠成一行的 A+B 貼進編輯器執行,輸入 5 3,確認它真的印出 8;再把它恢復成一行一個指令、加上縮排,比較兩個版本哪個一眼就看得出「這支程式在做什麼」。


自我檢測

讀完這一節,做做看下面 4 題,送出後馬上看得到解說。

第 1 題

編譯錯誤訊息 error: expected ';' before string constant 裡的 string constant,指的是程式碼裡哪一種東西?

第 2 題

小華的程式看起來和範例一模一樣,卻一直編譯失敗,錯誤訊息是:

add.cpp:7:18: error: 'endl;' was not declared in this scope

最可能的原因是什麼?

第 3 題

int sum = a + b; 這一行裡,sum 屬於哪一類 token?

第 4 題

小明為了省一行,把開頭寫成這樣:

#include <iostream> using namespace std;

int main() {
    cout << "Hi" << endl;
    return 0;
}

會怎樣?