Comments
Kita sebagai developer ada baiknya untuk memberikan komentar-komentar pada code yang kita tulis baik project sendiri atau project yg bersifat barengan untuk di jadikan sebagai dokumentasi gimana sih code itu bekerja,
komen sesederahana ini sangat bermanfaat untuk dirimu sendiri loh di masa depan yang mungkin udah lupa dengan alur berpikir program atau code itu bekerja.
Sehingga anda akan menjadi lebih yakin ketika akan menambah atau memodifikasi kode karena ada pesan dari dirimu di masa lalu.
Comments/Komentar akan dilewatkan ketika proses kompilasi program/code, sehingga tidak akan mempengaruhi alur program/code yang kita tulis, seperti yg saya sebutkan comments/komentar itu bisa kita manfaat kan untuk dokumentasi yang akan menjelaskan kode yang kita tulis.
Ada tiga jenis komentar yang digunakan pada Dart,
- Single Line Comment
- Multi Line Comment
- Documentation Comment.
Single Line Comment atau komentar satu baris untuk membuat komentar itu anda bisa awali dengan tanda //
void main() {
// Single Line Comment
print('Hello world!');
}
Selanjutnya ada Multi Line Comment pada dasarnya kita ingin menuliskan beberapa baris komentar supaya mudah terbaca, Anda bisa mulai dengan tanda ini /* dan akhiri dengan */
void main() {
/*
Multi
line
Comment
*/
print('Hello world!');
}
Kemudian yang terakhir ini adalah Docummentation Comment, yang dmna komentar ini adalah single-line comment atau multi-line comment juga loh,anda bisa mulai dengan tanda ini /// atau /**
/**
* Hi IJlal Naufal Hibrizi
* Instagram: IJlnflhbrz
* Website: www.example.com
*/
void main() {
String name = 'IJlal Naufal Hibrizi';
int age = 20;
/// contoh: document comments
/// pada fungsi [main] ini akan menampilkan 2 output
/// output pertama menampilkan nama : IJlal Naufal Hibrizi
/// output kedua menampilkan umur : 20
// mencetak variable di console ;
print('Hi ${name} - $age Tahun'); // output: Hi IJlal Naufal Hibrizi - 20 Tahun
}
Ketika Menulis komentar pada kode adalah kebiasaan yang baik. Namun perlu anda diperhatikan lagi, “Kode yang baik memiliki banyak komentar, sementara kode yang buruk memerlukan banyak komentar.”