image-ru-00-21

「哇,又來一個人類女性。但這次是黑頭髮。真開心!」

「嗨,我叫金。」

「嗨,我叫阿米哥。」

「我知道。你的名字是我想到的。迪亞哥想不出這種好名字。」

阿米哥的思緒以電子奔騰的速度馳騁著。「嗯…她人好好喔…不知道她喜不喜歡機器人。」

「讓我們回到課堂吧。我會用簡單的方式把內容解釋給你聽。」

「OK。」

「我想幫教授和利施說過的內容加上說明。」

「在 Java 裡,你可以寫命令,你也可以直接在代碼裡那些命令旁邊加上註解 (comment)。編譯器會完全忽略那些註解。程式運行的時候,所有的註解都會被忽略。

「可以請你給我一個範例嗎?」

「噢,當然:」

public class Home
{
    public static void main(String[] args)
    {
        /*
        現在我們要把『阿米哥是最棒的』這句話顯示在螢幕上
        */
        System.out.print("阿米哥");
        System.out.print("是");
        System.out.print("最");
        System.out.print("棒的");
    }
}    

「我們加了『現在我們要把…』這個註解。註解的開頭用一個符號對 (/*) 標示,結尾則是用 (*/) 標示。程式被編譯時,編譯器會忽略在符號 /**/ 中間的所有東西。

「也就是說我可以愛寫什麼就寫什麼?」

「是的。一般來說,代碼裡的註解是有關代碼中比較難懂的部分。有些註解是由好幾個字串構成的,通常寫在方法之前,以描述方法運作的原理細節。」

「要在代碼裡加上註解還有一種方法。你可以使用兩個前斜線 (//)。」

public class Home
{
    public static void main(String[] args)
    {
        System.out.print("阿米哥");
        System.out.print("是最"); // 這也是一個註解
        System.out.print("棒的");
    }
}

「在這裡,// 開始一直到有 // 符號的同一行結束前的代碼,都被視為註解。也就是說,沒有第二個符號對來『完成註解』。」

「順帶一提,有些註解真的很有趣。」

// 這個代碼我是不負責的。他們強逼我寫的,我根本不願意。
// 親愛的未來的我。我要祈求你的原諒。
// 我甚至不知道該從何開始表達我有多抱歉。
// 如果再讓我看到這種東西,只要一次,我就要在辦公室精神崩潰了。
// 如果這個條件居然成立了,
// 請通知我,有賞。電話: xxx-xxx-xxx。
// 親愛的代碼維護者:
// 一旦你放棄嘗試『最佳化』這段程式,
// 並了解到這個嘗試是個糟糕的錯誤時,
// 請把下面這個計數變量加一,
// 好警告下個想嘗試的傢伙:
// total_hours_wasted_here = 42
// 我之前寫這段碼的時候,只有老天爺和我知道我在幹嘛
// 而現在,天知道我在幹嘛
// 我有時候相信編譯器會忽視所有我寫的註解。
// 我要把所有的代碼和勞動獻給我的太太—達琳, 
// 在這些代碼發佈給大眾使用以後,她就必須 
// 要努力工作養我、我們的三個小孩和狗了。
// 已喝醉,以後再修
// 神奇魔法。別碰它

「真的耶,有些註解超好笑。」

「今天就到這裡吧。」

「真是一堂簡短但有趣的課。謝謝妳,金。」