Merhabalar.

Bu yazımda kısaca Python’da yorum satırlarına değineceğim.

İyi programcılar açıklama-yorum satırları yazarlar.

Konuya böyle girmek istedim çünkü bu gerçekten doğrudur.

Kodlar yazarken her şeyine hakim olduğumuzu düşündüğümüz ama 3 gün sonra geri baktığımızda ben burada ne yapmışım dememize sebep olan şeylerdir.

O yüzden iyi bir yazılımcı hem gelecekteki kendine hem de çalışma arkadaşlarının yazdığı kodları kolayca anlayabilmesi için kodlarına önemli gördüğü açıklama satırlarını eklemelidir.

Olayı şöyle düşünebilirsiniz.

Bir yerde çalışıyorsunuz 10 000 satırlık kodlama yaptınız ve tek bir satır bile açıklama satırı yazmadınız.

Daha sonra siz bu şirketten ayrıldınız ve proje başka birine devredildi.

Projeyi devralan kişi için şu anda önünde 10 bin satırlık bir karmaşa var sadece. Halbuki siz geleceği düşünüp kodlarınızı açıklama satırlarıyla daha okunaklı hale getirmiş olsaydınız herkesin işini kolaylaştırmış olacaktınız.

O yüzden açıklama satırlarına önem verelim.

Python’da açıklama satırları 2 tiptir.

  1. Tek Satır Açıklama

Bazen kodları sadece ne olduğunu tarif edecek ya da bazen başlık koymamızı sağlayacak şekilde tek satır açıklamalar yazma gereksinimi duyarız.

Bunun için Python’da # işareti kullanılır.

# Bu bir tek satır açıklamadır.

a =  5

a

Bu şekilde yazdığımız açıklama satırı kod olarak okunmayacak kaynak dosyasına sahip olmayan kimse tarafından görüntülenmeyecektir.

2. Çoklu Satırda Açıklama Yazmak

Bazen kodları açıklamak uzun notlar alma gereksinimi duyarız. Böyle bir durumda her satıra # işareti koymayacağız tabii ki.

Bunun için yapmamız gereken şey açıklamalarımızı “”” “”” 3 tane çift tırnak arasına yazmak olacak.

Bu tırnakları açtıktan sonra bunun içinde kalmak şartıyla istediğiniz kadar açıklama yazabilirsiniz.

""" 
Bu çoklu bir açıklama satırıdır.
Bu satıra geçmemde herhangi bir sakınca yoktur.
Kodlarımı açıklıyorum.

"""

a = 5 

a

Bu şekilde olacaktır.

Not: Python’ın güzelliklerinden biri kodları herhangi bir noktalama işareti ile bitirmeniz gerekmez. Bu da daha hızlı kod yazabilmemizi sağlar.

Ancak başka dillerden getirdiğiniz alışkanlıklarınız varsa örneğin sonuna noktalı virgül koyarsanız herhangi bir hata da almazsınız.

Bir sonraki yazımda görüşmek üzere.


What's Your Reaction?

hate hate
0
hate
fail fail
0
fail
fun fun
0
fun
geeky geeky
0
geeky
love love
0
love
lol lol
0
lol
omg omg
0
omg
win win
0
win
Murat Bilginer
21 Şubat 1992 Doğumlu. Endüstri Mühendisi olarak Lisansını 2016 yılında tamamlamıştır. Industryolog Akademi - NGenius oluşumlarının kurucusudur. Şu anda kendi şirketi Brainy Tech ile hem Yazılım Hizmetleri Sunmakta Hem de Online Eğitimler Vermektedir.