コメント
Java言語では3種類のコメントが用いられます。
- /* で始まり */ で終わる範囲。これは C のルールと同じです。
- // で始まり行末まで。これは C++ で追加されたルールと同じです。
- /** で始まり */ で終わる範囲。これは Java言語独自のルールです。
このコメント内のテキストは、
ソース・プログラムからドキュメントを自動生成する時に利用されます。
クラス定義や変数およびメソッドの定義の前には、
このコメントを置くことが半ば義務づけられています。
それ以外の場所でこの形式のコメントを用いると、
コンパイル時にエラーとされます。
/** このコメントは次のクラスの説明です。定義の直前に置きます。 */
public class NewClass {
/** このコメントは次のフィールドの説明です。定義の直前に置きます。 */
protected int x; // 行末まではコメントです。
/* この形式のコメントは
どの場所に置いてもかまいません。 */