Comments
Comments (Yorumlar), not almak için yazılmış, herhangibir şekilde derlenmeyen satırlardır. Kod yazarken çeşitli sebeplerden ötürü not almamız gerekebiliyor. Bunu yaparken ayrı bir dosyaya yapmak yerine direk kodun bulunduğu dosyaya yazmak tahmin edebileceğiniz üzere çok pratik. Bu sebepten ötürü böyle bir çözüm bulunmuş. İki farklı yorum türü bulunur.
- Tek satırlık yorumlar
- Çok satırlı yorumlar
//Tek satirlik yorum
/*Cok
satirlik
yorum*/
int tamsayi=0; // yorum isaretinin solundaki kod calisir AMA solunda kalanlar yorumdur
int tamsayi2=0; /* cok satirli yorumlarin cok satirli olmasina gerek yoktur. */Tek satırlık yorumları // işaretiyle gösteriyoruz. // işaretinin sağında kalan her şey yorum olarak kabul edilir.
Çok satırlı yorumlar /* işaretiyle başlar ve */ işaretiyle biter. Bu iki işaret arasında kalan her şey yorum olarak kabul edilir.
Neden ve Nasıl Yorum Yapmalıyız?
Burada bazı tavsiyeler verdim. Katılıp katılmamak size bağlı.
Nerede yorum yapmalıyız:
- Açıklama yapmak istiyorsak
- Daha sonra o noktada yapılması gereken bir iş varsa
- Dosyanın başına kendimiz ve şirketimiz hakkında bilgi verirken.
- Yazdığımız kod hakkında bilgi verirken
Nasıl yorum yapmalıyız:
- Gereksiz yere yorum yapmamalıyız
- Anlamsız değişken isimleri verip daha sonra notla açıklamak yerine. Anlamlı değişken isimleri verip gerekiyorsa notla açıklama yapmalıyız.
- Kodda yapılan değişiklerin kaydını tutmak için kullanmamalıyız. (Yorumla tutmak yerine versiyon kontrol sistemi ile bu işi halletmeliyiz)
Leave a Reply