CodeBlanks Logo Icon CodeBlanks

Örnek kod

Dokümantasyonda örnek kod öğrenirsin.

Örnek kod

Doc comment'larda örnek kod, öğrenciye kullanımı gösterir. Markdown kod bloğu ```dart ile başlar ve ``` ile biter.

Her satır /// ile başlamalıdır; bu yüzden /// ```dart yazıp altına /// square(4); gibi satırlar eklersin.

dartdoc, kod bloğunu renklendirilmiş HTML olarak gösterir; bu, API'nin nasıl kullanılacağını açıkça anlatır.

Örnek kod örneği

Tipik kullanım: /// Örnek: satırının altına /// ```dart, sonra /// final sum = add(2, 3); ve son olarak /// ``` yazarsın.

Kod bloğunun içinde gerçek çalışan kod olmalı; yorumlar // ile eklenir. dartdoc bunu olduğu gibi renklendirir.

Kısa ve anlamlı örnekler seç; uzun örnekler belgeyi şişirir ve okunabilirliği azaltır.

Uygulama Örnek kod içeren doc comment

int square(int n) => n * n; fonksiyonunu yaz. Üzerine doc comment ekle: birinci satır /// Örnek:, ikinci satır /// ```dart, üçüncü satır /// square(4); // 16, dördüncü satır /// ```. main içinde print(square(5)) çağır.

Başlangıç kodu

main.dart
// square fonksiyonunu ve örnek kod bloğunu yaz

void main() {
  // square(5) sonucunu yazdır
}

Örnek çözüm

main.dart
/// Örnek:
/// ```dart
/// square(4); // 16
/// ```
int square(int n) => n * n;

void main() {
  print(square(5));
}

Beklenen çıktı

25

Soru ve cevaplar

Dersin sorularını cevaplarıyla birlikte inceleyebilirsin. Kendini denemek istersen dersi interaktif olarak çöz.

1 Kod bloğu başlangıcı

Soru
/// ____dart
Cevap
/// ```dart

Açıklama: ```dart ile kod bloğu başlar.

2 Örnek kod parçaları

Kavram Anlamı
```dart Kod bloğu
/// Doc comment
// 16 Satır içi yorum
Örnek: Açıklama

3 Örnek kod bloğu nasıl başlar?

  • ```dart Doğru cevap
  • <code>
  • [code]
  • //code

Açıklama: ```dart bir Markdown kod bloğu açar.

Orta seviye bölümündeki tüm dersler