Comments

 Sebelum mulai mengembangkan aplikasi yang lebih kompleks, ada satu hal penting lagi yang perlu kita tahu, yaitu instruksi kepada komputer untuk mengabaikan bagian dari suatu program. Kode yang ditulis dalam suatu program tetapi tidak dijalankan oleh komputer disebut “comments.”

Sebuah komentar akan dilewatkan ketika proses kompilasi, sehingga tidak akan memengaruhi alur program yang kita tulis. Komentar bisa digunakan sebagai dokumentasi yang menjelaskan kode yang kita tulis.

Terdapat tiga jenis komentar yang bisa digunakan pada Dart. Pertama adalah single-line comment atau komentar satu baris yang diawali dengan tanda // dan berakhir pada akhir baris tersebut.

// Single line comment

Selanjutnya ada multi-line comment di mana kita bisa menuliskan beberapa baris komentar. Komentar ini dimulai dari tanda /* dan diakhiri dengan */.

/*
  multi
  line
  comment
 */

Kemudian terakhir adalah documentation comment. Komentar ini adalah single-line comment atau multi-line comment yang diawali dengan /// atau /**.

Di dalam documentation comment, kompiler Dart akan mengabaikan semua teks kecuali yang tertutup dalam kurung siku ([]). Di dalam kurung siku kita dapat memasukkan referensi dari nama kelas, variabel, atau fungsi. Berikut ini adalah contoh penggunaan komentar.

• main.dart

1

/// Fungsi [main] akan menampilkan 2 output

2

/// Output pertama menampilkan teks dan output kedua menampilkan hasil perkalian pada fungsi [calculate]

3

void main(List<String> arguments) {

4

  // Mencetak Hello Dart! Dart is great. pada konsol

5

  print('Hello Dart! Dart is great.');

6

  // Testing documentation comment with [].

7

  print('6 * 7 = ${calculate()}');

8

}

9

​

10

int calculate() {

11

  return 6 * 7;

12

}

13

​

14

/// Output:

15

/// Hello Dart! Dart is great.

16

/// 6 * 7 = 42

Tes

Jika Anda menggunakan IDE lalu menekan Ctrl dan mengarahkan ke teks di dalam kurung siku, maka Anda akan dapat klik dan mengarah ke kode referensinya.

Menulis komentar pada kode adalah praktik yang baik. Ada pepatah yang mengatakan, “A bad comment is worse than no comment at all,” sehingga pastikan Anda menulis komentar dengan baik. 

Apabila ingin melihat sumber dari interactive code di atas, silakan kunjungi tautan berikut.

• Comments - Code

Selain itu, info lebih lanjut terkait materi ini dapat Anda lihat pada dokumentasi berikut.

• Introduction - Comment
• Comment