Menggunakan Comment di Java

Apa itu Comment

Comment adalah bagian nonexecutable dari program yang digunakan untuk mendokumentasikan program yang kita buat. Comment bukan merupakan intruksi yang executable, jadi akan diabaikan oleh compiler. Jadi penulisan program yang baik harus diawali dengan blok comment yang menjelaskan nama program, penulis program, dan deskripsi dari program tersebut (apa yg dilakukan oleh program tersebut).

Jenis comment

Terdapat 2 jenis comment yang bisa digunakan, yaitu multi-line comment dan single-line comment.

multi-line comment

Teks yang terisi dalam /* dan */ dianggap sebagai comment dan dalam penggunaanya dapat diperluas lebih dari satu baris. Ketika compiler menemukan tanda awal /* maka teks yang berada pada setelah tanda tersebut akan diloncat sampai compiler menemukan tanda akhir */. Kita tidak dapat menaruh satu multi-line comment di dalam multi-line comment yang lain. Lihat kode dibawah:

/* Ini adalah comment pertama */
	/* Ini adalah comment kedua
		Penulis:ghanoz2480
		TheONEmAn2480
		Deskripsi Program:

	   Ini akhir dari comment kedua
	*/
Single-line comment

Untuk menggunakan comment jenis ini kita cukup menggunakan // lalu diikuti dengan teks, tetapi jika kita menggunakan comment ini hanya untuk satu baris, jika masih ingin membuat comment pada baris kedua kita gunakan // lagi lalu teks. Lihat kode di bawah:


	// ini adalah comment baris 1
	// ini adalah comment baris 2
	// dan seterusnya

Tujuan Menggunakan Comment

Tujuan kita menggunakan comment dalam program kita semata-mata agar program yang kita buat tidak sulit untuk dibaca dan mudah untuk dimengerti. Misalnya menggunakan comment untuk menandakan awal atau akhir suatu blok kode pada program, lihat kode di bawah:


// awal dari blok method main
public static void main(String args[])
{

}	// akhir dari blok method main

Referensi

  1. Morelli, R., Walde R., “Java, Java, Java™: Object-Oriented Problem Solving, Third Edition”, Prentice-Hall, 2005
  2. Mulholland A., Murphy G., “Java 1.4 Game Programming“, Wordware, 2003

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s