Merhabalar.

Dart eğitimlerimize kısa ama önemli bir konuyla devam ediyoruz.

Açıklama satırları.

Program yazarken yazdığımız kodların ne işe yaradığını kısaca açıklayarak kendimize notlar düşmek isteyebiliriz.

Ya da bir takım ile beraber çalışıyoruzdur. Yazdığımız kodların neden yazıldığını takım arkadaşlarımıza bildirmek isteyebiliriz.

Bir durumda vardır ki açıklama satırı yazmanın en önemli sebeplerinden biridir. O da şu, biz bir programı yazıp daha sonra uzunca bir süre o kodlara bakmayabiliriz. Ve bir gün gelir o kodlarda bir güncelleme ya da bir değişiklik yapmak isteyebiliriz. Uzun bir zaman sonra insan kendi yazdığı kodları bile unuttuğu için açıklama satırları o kodların neden yazıldığını yıllar sonra bile size anımsatabilir bu sebepten önemlidir.

Ayrıca bazen yazdığımız kodları silmek istemeyiz güncelleme yaptıktan sonra eski kodlar da orada dursun isteriz böyle bir durumda o kodları açıklama satırı bloklarına dönüştürebiliriz. Böylelikle hem nasıl bir kod güncellemesi yaptığımızdan haberdar oluruz. Hem de yeni kodlarda bir sıkıntı çıkarsa eksiye dönmek daha kolay olacaktır.

İşte bu saydığım nedenlerden ve spesifik olarak sizin aklınıza gelebilecek pek çok nedenden dolayı kodlarımız içinde açıklama satırlarına ihtiyaç duyarız.

Açıklama Satırları Dart’da 3 Şekildedir.

  1. Tek Satır Açıklama Satırı

Bazen tek satır açıklamalar bize yeter.

Bunun için yapmamız gereken şey çok basit.

// Yan yana 2 bölü işaretini koyuyoruz ve yazmak istediğimiz açıklamayı yanına yazmaya başlıyoruz.

Burada dikkat etmemiz gereken bir alt satıra geçmemek olmalı. Çünkü Enter ile bir alt satıra geçerseniz o açıklama satırından çıkmış olursunuz ve hata alırsınız.

Açıklama satırları kod olarak algılanıp okunmazlar. Kullanıcı ekranına yansımaz. Sadece geliştiriciler görebilir.

void main(){
  
  // Bu tek satır açıklamadır. Dart eğitimi için yazılmıştır.
  // Bu başka bir satır açıklamadır.
  
}

2. Çoklu Satırda Açıklama

Bazı açıklamalarımız için tek satır yeterli gelmez. Uzun uzun işlemi anlatmak isteyebiliriz. Böyle bir durumda her satırda // işareti kullanmayalım diye çoklu satır açıklama yazmamıza imkan veriyor dart.

Bunun için yapmamız gereken

/* Açıklamalar */

ifadeleri arasına açıklamalarımızı yazmamızdır.

Bu ifade içindeyken Enter ile istediğiniz kadar bir alt satıra geçebilirsiniz. Tamamını açıklama olarak algılayacaktır.

void main(){

  // Bu tek satır açıklamadır. Dart eğitimi için yazılmıştır.
  // Bu başka bir satır açıklamadır.
  
  /* 
  *  Çoklu Satır Açıklama Yqzıyorum.
  *  Bu eğitim faydalı gibi
  *  Hadi bir satır daha yazalım.
  * 
  *  Ve istersem daha pek çok satır daha yazabilirim.
  *  Bu yıldızlar ben enter'a bastıkça otomatik oluşuyor.
  * */

}

3. Dokumantasyon Açıklaması

Bulunduğumuz sınıf ya da metodun dokümantasyonunu yazmak isteyebiliriz.

Bunun için

/// 3 Tane yan yana bölü işareti kullanırız.

Bu şekilde yazdığımız ifadeler. Bu sınıfı kullanmak için dart ekranında yazdığımızda açılan bilgi kutucuğunda gözükecektir.

void main(){

  // Bu tek satır açıklamadır. Dart eğitimi için yazılmıştır.
  // Bu başka bir satır açıklamadır.
  
  /*
  *  Çoklu Satır Açıklama Yqzıyorum.
  *  Bu eğitim faydalı gibi
  *  Hadi bir satır daha yazalım.
  *
  *  Ve istersem daha pek çok satır daha yazabilirim.
  *  Bu yıldızlar ben enter'a bastıkça otomatik oluşuyor.
  * */
  
  /// Bu bir 
  /// Dokümantasyon
  /// Açıklama satırıdır.
  /// Alt satıra Enter'la geçtiğimde 3 bölü otomatik oluşur.
  
  
}

Bu kadardı bir sonraki yazımda görüşmek üzere.


What's Your Reaction?

hate hate
0
hate
fail fail
0
fail
fun fun
0
fun
geeky geeky
0
geeky
love love
0
love
lol lol
0
lol
omg omg
0
omg
win win
0
win
Murat Bilginer
21 Şubat 1992 Doğumlu. Endüstri Mühendisi olarak Lisansını 2016 yılında tamamlamıştır. Industryolog Akademi - NGenius oluşumlarının kurucusudur. Şu anda kendi şirketi Brainy Tech ile hem Yazılım Hizmetleri Sunmakta Hem de Online Eğitimler Vermektedir.