Yorum Satırları (Comments)

Dart, tek satırlık yorumları, çok satırlı yorumları ve belgelendirme yorumlarını destekler.

Tek Satırlık Yorumlar

Tek satırlık bir yorum, // ile başlar ve satırın sonu arasındaki her şey Dart derleyicisi tarafından görmezden gelinir.

void main() {
  // TODO: soyut bir LamaSelamlamaFabrikası'na refaktör yapılacak mı?
  print('Lama çiftliğime hoş geldiniz!');
}

Çok Satırlı Yorumlar

Çok satırlı bir yorum, /* ile başlar ve */ biter ve arasındaki her şey Dart derleyicisi tarafından görmezden gelinir (ancak yorum belgelendirme yorumu değilse; bir sonraki bölüme bakınız). Çok satırlı yorumlar iç içe geçebilir.

void main() {
  /*
   * Bu çok iş. Tavukları beslemeyi düşünün.

  Lama larry = Llama();
  larry.besle();
  larry.egzersizYap();
  larry.temizle();
   */
}

Belgelendirme Yorumları

Belgelendirme yorumları, /// veya /** ile başlayan çok satırlı veya tek satırlı yorumlardır. Ardışık satırlarda /// kullanmak, çok satırlı bir belgeleme yorumunun aynı etkiye sahip olmasını sağlar.

/// Güney Amerika'da evcilleştirilmiş bir devekuşu (Lama glama).
///
/// Andean kültürleri, lamaları Hispanik zamanlardan beri et ve yük hayvanı olarak kullanmıştır.
///
/// Diğer hayvanlar gibi, llamanın da [Besle] fonksiyonu ile biraz [Yiyecek]e ihtiyacı vardır.
class Lama {
  String? ad;

  /// Lamanıza [yiyecek] ile yem verir.
  ///
  /// Tipik bir lama haftada bir balya saman yer.
  void besle(Yiyecek yiyecek) {
    // ...
  }

  /// Lamanıza bir [aktivite] ile [zamanSınırı] dakika boyunca egzersiz yaptırır.
  void egzersizYap(Aktivite aktivite, int zamanSınırı) {
    // ...
  }
}

Sınıfın oluşturulan belgesinde, [besle] bağlantıları besle metodunun belgelerine ve [Yiyecek] bağlantıları Yiyecek sınıfının belgelerine yönlendirilir.