Comment Dart

Sebelum membangun sebuah aplikasi yang komplek, ada beberapa hal penting yang harus diketahui. Salah satunya yaitu instruksi komputer yang berfungsi untuk mengabaikan sintax dari suatu program. kode atau perintah yang tidak dijalankan oleh komputer adalah “Comments”. Comments atau Komentar berfungsi sebagai catatan untuk mendeskripsikan lebih detail tentang suatu kode. Pada Dart, penggunaan comment juga sangat mirip dengan bahasa pemrograman lainnya.

Jenis Comment Dart

Ada tiga jenis comments yang digunakan pada pemrograman dart :

Single Line Comments

single line comments atau komentar satu baris yang di awali dengan // (Double Forward Slash)

Syntax:

// Contoh Single Line Comments

Contoh:

void main() {
  // ini untuk menampilkan Hello World!
  print('Hello world!');
}

Hasil:

Hello world!

Multi Line Comments

Multi Line Comments untuk membuat beberapa komentar sehingga kita dapat menuliskan beberapa komentar, komentar ini di awali dengan /* dan di akhiri dengan */

Syntax:

/*
  Multi
  Line 
  Comments
*/

Contoh:

void main() {
    /*
      Multi
      Line 
      Comments
    */
    print('Hello world!');
}

Hasil:

Hello world!

Document Line Comments

Document Line Comments ini adalah single line comments atau multi line comments yang diawali dengan /// atau bisa juga /**

Syntax:

/// contoh document comments

Contoh:

/**
 * Created by Herry Prasetyo
 * website: BelajarFlutter.com
 * Date: 2020-09-09
 * Time: 08:02
 */
String negara = "Indonesia";

/// contoh document comments
/// fungsi [main] akan menampilkan 2 output
/// output pertama menampilkan text
/// lalu output kedua menampilkan string dari variable [negara]
void main() {
  //mencetak kalimat dart di console print('Belajar Dart di belajarflutter.com');
  print('Belajar Dart di belajarflutter.com');

  // Testing documentation comment with [negara].
  print('Hello world: ${negara}');
}

Hasil:

Belajar Dart di belajarflutter.com
Hello world: Indonesia

Khusus untuk documentation line comment, IDE akan mengabaikan semua teks kecuali yang memiliki tanda []. Di dalam tanda siku kita dapat memasukkan referensi dari nama kelas, variable, atau fungsi yang mana jika kita klik variable tersebut akan mengarah ke referensi yang dimaksud. Meskipun begitu, referensi yang terdapat dalam documentation line comment TIDAK akan dijalankan oleh dart

Kesimpulan

Dengan menggunakan komentar yang ada di aplikasi kita, kita dapat mengamati program yang telah dibuat agar memudahkan para programmer lainnya dapat mengerti apa yang dimaksud kode yang telah kita buat.

Referensi :
https://dart.dev/guides/language/effective-dart/documentation