Files
ornekler/dersler/03-yorumlar.md
T
semih 494781e84f Dersler ve Temeller; web örnekleri PORT ortam değişkenini okur
- dersler/: 29 kısa ders (açıklama, çalıştırılabilir örnek, alıştırma). Her örneğin
  ve alıştırma çözümünün çıktısı Online IDE'nin hazırlık adımında gerçekten koşulup
  dosyadakiyle karşılaştırılır; biçim dersler/BICIM.md.
- temeller/: tek konulu 12 başlangıç programı.
- web/anket, web/kisalt, web/pano: port PORT ortam değişkeninden okunur (Online IDE
  önizlemesi 8080 verir), yoksa eski sabit port.
- README: öğrenme bölümü, Online IDE bağlantısı.
2026-10-17 22:07:47 +03:00

95 lines
2.2 KiB
Markdown

---
baslik: Yorumlar
bolum: Giriş
ozet: Kodun içine kendine ve başkalarına not bırakmak
---
Yorum, derleyicinin okumadığı, yalnız insanlar için yazılmış nottur. Bir hafta sonra kendi koduna baktığında "bunu neden yazmıştım?" diye sormamak için yorum yazarsın.
## Tek satırlık yorum
`#` işaretinden sonra satırın sonuna kadar her şey yorumdur.
```kbl
# Bu program bir selam yazar.
yazdir("Merhaba!")
```
```cikti
Merhaba!
```
## Satır sonunda yorum
Kodun yanına da yorum yazabilirsin. `#`'den öncesi çalışır, sonrası yok sayılır.
```kbl
fiyat = 250 # TL cinsinden
adet = 3 # sepetteki ürün sayısı
yazdir(fiyat * adet)
```
```cikti
750
```
## Kodu geçici olarak kapatmak
Bir satırın başına `#` koyarsan o satır çalışmaz. Silmeden denemek için çok işe yarar.
```kbl
yazdir("Birinci satır")
# yazdir("Bu satır şimdilik kapalı")
yazdir("Üçüncü satır")
```
```cikti
Birinci satır
Üçüncü satır
```
## Metnin içindeki # yorum değildir
Tırnak içindeki `#` sıradan bir karakterdir.
```kbl
yazdir("Sıra numaran: #12") # bu kısım ise yorum
```
```cikti
Sıra numaran: #12
```
> **İpucu:** İyi yorum kodun *ne* yaptığını değil *neden* yaptığını anlatır. `x = x + 1 # x'i bir artır` gereksizdir; `misafir += 1 # kapıdaki kişiyi de sayıyoruz` işe yarar.
## Birden çok satırlık açıklama
Uzun bir açıklama için her satırın başına `#` koyarsın.
```kbl
# Kargo ücreti hesabı:
# 500 TL ve üstü siparişte kargo ücretsiz,
# altında 60 TL.
sepet = 420
kargo = 60
eger sepet >= 500:
kargo = 0
yazdir("Kargo:", kargo, "TL")
```
```cikti
Kargo: 60 TL
```
## Alıştırma
```alistirma
Aşağıdaki programda ikinci satır hatalı bir duyuru yazıyor. O satırı **silmeden**, başına `#` koyarak kapat. Çıktıda yalnız iki doğru satır kalsın.
%%%
yazdir("Kütüphane 09:00'da açılır.")
yazdir("Kütüphane pazar günü de açıktır.")
yazdir("Kütüphane 18:00'de kapanır.")
%%%
yazdir("Kütüphane 09:00'da açılır.")
# yazdir("Kütüphane pazar günü de açıktır.")
yazdir("Kütüphane 18:00'de kapanır.")
%%%
Kütüphane 09:00'da açılır.
Kütüphane 18:00'de kapanır.
```