Merhaba arkadaşlar,
Bu konumuzda size bu yolda rehber niteliğinde bir bilgilendirme yapmak istiyorum. Şahsen benimde bazen zorlandığım bir konu ama kod yazarken üzerinde durulması gereken hassas bir konu, benim düşünceme göre...
Bu konu, özellikle “şimdilik çalışsın yeter” mantığıyla kod yazanlara küçük ama etkili bir rehber olacak.
En basit sebebi, kod bir gün kesinlikle geri döneceğin bir şeydir.
Bugün hatırlıyorsun, yarın unutacaksın.
Kural:
Her fonksiyonun tepesine kısacık bir açıklama yaz.
Karmaşık satırların yanına 1–2 kelimelik yorum yeterlidir.
Örnek çalışma;
Yorum yazmak seni yavaşlatmaz — hata ayıklarken iki kat hızlandırır.
Aşağıdaki örneğin hangisi daha okunabilir?
Kötü ;
İyi:
Kodun okunabilirliği, hızından daha önemlidir.
Düzensiz kod, hata üretme makinesidir.
Kötü:
İyi:
Bir fonksiyon tek bir iş yapsın.
Örn; “hesaplama + ekrana basma + input alma” aynı fonksiyonda olmasın.
Doğru yapı:
Aynı kodu iki kez yazıyorsan yanlış yapıyorsun.
Onu bir fonksiyona çevir.
DRY: Don't Repeat Yourself
(“Kendini tekrar etme”)
En tehlikeli durum:
“Niye böyle çalışıyor bilmiyorum ama çalışıyor.”
Bu ilerde seni çok uğraştırır.
Kodu yazdıktan sonra kendine sor:
Tek dosyada her şeyi yazma.
Proje büyüdükçe dağ gibi olur.
main.c
matris.c
matris.h
hesaplayici.c
Böl, ayır, düzenle.
Bunun en güzel örneğini metin2'de görüyoruz.
Mesela bu konuyu inceleyebilirsiniz. Dosyalar oluşturulurken isimlendirmeleri dosyaların içeriğine, yapısına ve kullanım amacına göre yazılmış ve ona göre dizayn edilmiştir. Bizlere çok güzel somut bir örnek teşkil eder.
Bugün öğrendiğin şeylere yarın eklemeler yapacaksın.
Temiz bir başlangıç, seni ileride inanılmaz rahatlatır.
Bu rehber kısa ama etkili bir özet.
Kodunun okunabilir olması:
Bu konumuzda size bu yolda rehber niteliğinde bir bilgilendirme yapmak istiyorum. Şahsen benimde bazen zorlandığım bir konu ama kod yazarken üzerinde durulması gereken hassas bir konu, benim düşünceme göre...
Kod yazmaya yeni başlayan herkesin yaptığı ortak hatalar var:
Yorum satırı yazmamak
Bu konu, özellikle “şimdilik çalışsın yeter” mantığıyla kod yazanlara küçük ama etkili bir rehber olacak.
1. Yorum Satırları Neden Önemli?
En basit sebebi, kod bir gün kesinlikle geri döneceğin bir şeydir.Bugün hatırlıyorsun, yarın unutacaksın.
Kural:
Her fonksiyonun tepesine kısacık bir açıklama yaz. Karmaşık satırların yanına 1–2 kelimelik yorum yeterlidir.Örnek çalışma;
C++:
// Matrisin tüm elemanlarının ortalamasını hesaplar
float Ortalama(int dizi[], int adet) {
int toplam = 0;
for (int i = 0; i < adet; i++) {
toplam += dizi[i]; // elemanları topla
}
return (float)toplam / adet; // ortalama döndür
}Yorum yazmak seni yavaşlatmaz — hata ayıklarken iki kat hızlandırır.
2. Değişken İsimleri Rastgele Olmasın
Aşağıdaki örneğin hangisi daha okunabilir? Kötü ;
1.örnek:
int a, b, c;
örnek 2:
int satirSayisi, sutunSayisi, toplam;Kodun okunabilirliği, hızından daha önemlidir.
3. Kod Bloklarını Düzenle (Indentation)
Düzensiz kod, hata üretme makinesidir. Kötü:
C++:
for(int i=0;i<3;i++){
printf("Merhaba");
if(i==1){
printf("Test");
}
}
C++:
for (int i = 0; i < 3; i++) {
printf("Merhaba");
if (i == 1) {
printf("Test");
}
} 4. Fonksiyonları Küçük Tut
Bir fonksiyon tek bir iş yapsın.Örn; “hesaplama + ekrana basma + input alma” aynı fonksiyonda olmasın.
Doğru yapı:
- input alan fonksiyon
- hesaplayan fonksiyon
- yazdıran fonksiyon
5. Gereksiz Tekrarları Bitir (DRY Kuralı)
Aynı kodu iki kez yazıyorsan yanlış yapıyorsun.Onu bir fonksiyona çevir.
DRY: Don't Repeat Yourself(“Kendini tekrar etme”)
6. Kodunun Neden Çalıştığını Bil
En tehlikeli durum:“Niye böyle çalışıyor bilmiyorum ama çalışıyor.”
Bu ilerde seni çok uğraştırır.
Kodu yazdıktan sonra kendine sor:
- Bu mantık doğru mu?
- Sınır durumları ne?
- Girilen veri yanlış olursa ne olur?
7. Dosya Düzeni (İlerde Mecbur Olacaksın)
Tek dosyada her şeyi yazma.Proje büyüdükçe dağ gibi olur.
main.c matris.c matris.h hesaplayici.cBöl, ayır, düzenle.
Bunun en güzel örneğini metin2'de görüyoruz.
Mesela bu konuyu inceleyebilirsiniz. Dosyalar oluşturulurken isimlendirmeleri dosyaların içeriğine, yapısına ve kullanım amacına göre yazılmış ve ona göre dizayn edilmiştir. Bizlere çok güzel somut bir örnek teşkil eder.
8. Kod Seninle Büyür – O Yüzden Temiz Başla
Bugün öğrendiğin şeylere yarın eklemeler yapacaksın.Temiz bir başlangıç, seni ileride inanılmaz rahatlatır.
Sonuç
Bu rehber kısa ama etkili bir özet.Kodunun okunabilir olması:
- daha az hata
- daha hızlı gelişim
- daha profesyonel görünüm
- ekipte çalışmayı kolaylaştırma
