
「哇,又來一個人類女性。但這次是黑頭髮。真開心!」
「嗨,我叫金。」
「嗨,我叫阿米哥。」
「我知道。你的名字是我想到的。迪亞哥想不出這種好名字。」
阿米哥的思緒以電子奔騰的速度馳騁著。「嗯…她人好好喔…不知道她喜不喜歡機器人。」
「讓我們回到課堂吧。我會用簡單的方式把內容解釋給你聽。」
「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
// 我之前寫這段碼的時候,只有老天爺和我知道我在幹嘛
// 而現在,天知道我在幹嘛
// 我有時候相信編譯器會忽視所有我寫的註解。
// 我要把所有的代碼和勞動獻給我的太太—達琳,
// 在這些代碼發佈給大眾使用以後,她就必須
// 要努力工作養我、我們的三個小孩和狗了。
// 已喝醉,以後再修
// 神奇魔法。別碰它
「真的耶,有些註解超好笑。」
「今天就到這裡吧。」
「真是一堂簡短但有趣的課。謝謝妳,金。」
GO TO FULL VERSION