1.7 註解

當程式變複雜時,你會想在程式碼旁邊寫「說明」,幫助自己和別人理解這段在做什麼。這就是註解(Comment)——註解只是寫給人看的,編譯器會直接略過、不會把它當成指令執行。

C++ 提供兩種註解方式:

單行註解://

  • 用法:// 後面的文字到行尾都會被編譯器忽略
  • 例子:
    int a = 5;  // 宣告整數 a,初始值為 5
    

多行註解:/* */

  • 用法:/* 和 */ 之間的所有文字都被忽略,可以跨越多行
  • 例子:
    /*
    * 這是一個讀入兩個數字並計算它們的和的程式
    * 輸入:兩個整數 a 和 b
    * 輸出:它們的和
    */
    int a, b;
    cin >> a >> b;
    

範例

#include <iostream>
using namespace std;

int main() {
    // 宣告變數
    int a, b;

    /* 讀入資料
       這個程式期望使用者輸入兩個整數 */
    cin >> a >> b;

    // 計算和
    int sum = a + b;

    // 印出結果
    cout << sum << endl;

    return 0;
}

動手試試看: 給你之前寫的 A+B 程式加上註解,讓第一次看到程式的人能輕易理解。


自我檢測

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

第 1 題

下面的程式會印出什麼?

#include <iostream>
using namespace std;

int main() {
    // cout << "A" << endl;
    cout << "B" << endl;  // cout << "C" << endl;
    /* cout << "D" << endl; */
    return 0;
}
第 2 題

下面的程式會怎樣?

#include <iostream>
using namespace std;

int main() {
    /* 開始一個多行註解
    cout << "Hello" << endl;
    return 0;
}
第 3 題

小華想把一段已經有 /* */ 註解的程式整段註解掉,就在外面再包一層:

/* 外層註解開始
int b = 10; /* 內層註解 */
外層註解結束 */

會怎樣?