網頁

2013年9月3日 星期二

Ch1_3為程式加入註解

為程式加入說明在日後進行程式維護修改的時候會有幫助,在JAVA有2種主要的註解種類可以使用。


  • 單行註解   //文字敘述
標記"//"告訴編輯器忽略此標記之後到此行結尾之間的內容。



有時候註解文字必須分作好幾行來撰寫,一行一行的使用單行註解並不方便,在這個時候酒可以使用多行註解,在 /* 與 */ 之間撰寫註解文字。
  • 多行註解  /* 文字敘述 */    


標記/*與*/告訴編譯器忽略 /*標記之後到下一個 */之間的內容。

以 /* 開始   遇到 */結束,所以不可以使用巢狀的方式來撰寫多行註解,例如:

             /* 
名稱:
目的:
*/         因為註解到這邊就結束了。
*/          所以到這邊就會視為不合法的程式撰寫,因而發出編譯錯誤的訊息。
還有第3種註解方式,稱為文件註解。這種方式的註解是藉由JDK內附的工具javadoc來產生文件,文件註解必須以斜線和兩個星號開始(/**),而由一個星號和一個斜線結束(*/)。

範例程式
/*
名稱:第1個程式
目的:多行註解
...文字敘述
 */
package chapter;

public class Ch1_3 {
    public static void main(String[] args) {
        // 顯示Hello JAVA
        // 輸出後換行
        System.out.println("Hello JAVA" + 1);
        System.out.println("Hello JAVA" + 2);
        // 輸出後不換行
        System.out.print("Hello JAVA" + 3);
        System.out.print("Hello JAVA" + 4);
    }

}

沒有留言:

張貼留言