@param ve @return
- Dart kursu
- Orta seviye
- Ders 109/116
- 5 dk
@param ve @return etiketlerini öğrenirsin.
@param ve @return yerine [name]
Dart doc comment'larında parametreler [name] köşeli parantez ile referanslanır. Java'daki @param ve @return etiketleri Dart'ta kullanılmaz.
Örnek: /// [name] parametresi selamlanır. Döndürülen değer bir mesajdır. dartdoc, [name]'i parametre belgelerine köprü olarak çevirir.
Dönüş değeri düz cümleyle anlatılır; ayrı bir etikete gerek yoktur. Bu, daha doğal okunan belgeler verir.
[name] örneği
Tipik doc comment: /// [a] ve [b] toplanır. satırının altına /// Sonuç bir tamsayıdır. eklersin.
[a] ve [b], fonksiyon parametrelerine köprü olur; okuyucu tıklayıp tanıma gider. Dönüş değeri ikinci cümlede anlatılır.
Bu yaklaşım, Java'daki @param a ... @return ... çiftinin yerini doğal bir dille alır.
Uygulama [name] ile doc comment
int subtract(int a, int b) => a - b; fonksiyonunu yaz. Üzerine doc comment ekle: /// [a] değerinden [b] çıkarılır.. main içinde print(subtract(10, 4)) çağır.
Başlangıç kodu
// subtract fonksiyonunu ve doc comment'ini yaz
void main() {
// subtract(10, 4) sonucunu yazdır
}Örnek çözüm
/// [a] değerinden [b] çıkarılır.
int subtract(int a, int b) => a - b;
void main() {
print(subtract(10, 4));
}Beklenen çıktı
6
Soru ve cevaplar
Dersin sorularını cevaplarıyla birlikte inceleyebilirsin. Kendini denemek istersen dersi interaktif olarak çöz.
1 Dart'ta parametre nasıl referanslanır?
- @param name
- $name
- #{name}
- [name] Doğru cevap
Açıklama: [name] köşeli parantez parametreye bağlantı verir.
2 Parametre referansı
| Kavram | Anlamı |
|---|---|
[name] |
Parametre bağlantısı |
@param |
Java etiketi |
/// |
Doc comment |
Düz yazı |
Dönüş açıklaması |
3 [name] referansı
/// ____ ve [b] toplanır./// [a] ve [b] toplanır.Açıklama: [a] parametreye bağlantı verir.