Yorum Satırları

Bu zamana kadar birçok şeyi öğrendik. Bu noktada gereksiz gibi gözüken ancak oldukça önemli olan bir konumuz daha var: 'Yorum satırları'. Yorum satırı, adından da anlayacağınız üzere kodlarımızın ne işe yaradığını kısaca açıklamamıza olanak tanıyan bir özelliktir. Programlama dilinden programlama diline değişebilen bu durum, Bash için '#' (hash) işareti ile sağlanır. Bakalım.

İlk satırdaki kodumuz gördüğünüz gibi renkli şekilde. Fakat üçüncü satırın başlangıcına baktığınızda '#' işaretini göreceksinizdir. Hemen ardından gelen yazılar, normal şartlarda çalışması gereken kodlardır. Ancak hash işareti sayesinde bunlar, çalıştırılmayacaktır. Çıktı kısmına baktığınızda, bunu teyit edebilirsiniz.

Bunu nerede, nasıl kullanıyoruz?

Bir fonksiyon tanımlarken ona verdiğimiz ismi, fonksiyonun işini tanımlayacak şekilde belirleriz; değişken tanımlama kurallarından hatırlarsınız. Örneğin toplama işlemi yapan bir fonksiyonun ismini 't' veya 'top' şeklinde yazmak yerine düzgün bir şekilde 'toplama' olarak yazmak her zaman faydalıdır.

Bu noktada bahsettiğimiz bu yorum satırlarını, fonksiyonun ne iş yaptığını daha net bir şekilde ifade etmek için kullanabilirsiniz. Ne demek istiyorum?

Gördüğünüz gibi, yukarıdaki fonksiyona baktığınızda ilk görüşte bunun ne iş yaptığını anlayabilirsiniz. Ancak daha karmaşık bir fonksiyon söz konusu olduğunda yorum satırlarını kullanmamız gerekir. Yani şimdi yazdığınız kodun ne yaptığını bir siz bir de Allah biliyorsa 3 ay sonra kendi kodunuzu açtığınızda kodun ne yaptığını sadece Allah biliyor olabilir; yani kodunuzu unutabilirsiniz. O yüzden kullanıyoruz.

Yukarıda gördüğünüz gibi istediğiniz yere istediğiniz şekilde yorum bırakabilirsiniz. Burada söz konusu olan yapının fonksiyon olmasına da gerek yok. Örneğin normal ama karışık bir kod yazdığınızda da birkaç satırda bir ya da her satır için bir yorum bırakabilirsiniz.

Peki, bütün bu yorumlar yalnızca tek bir satır şeklinde mi olmak zorunda? Tabii ki hayır. Şimdi, yorum çeşitlerine de bakalım.

: ' ' :

Bunu, yukarıdaki gibi kullanıyoruz. Yazacağımız şeyleri ise aradaki iki kesme işaretinin ortasına yazıyoruz. Aşağıda örneğine bakabilirsiniz.

Başlangıcı ve sonu iki nokta üst üste ile (:) ve bu noktalama işaretlerinin arasına bir çift kesme işareti bırakıyoruz. Daha sonra yazacaklarımızı, onların arasına yazıyoruz. Zaten dikkat edin; aradaki yazıların hepsi yeşil renge dönmüş durumda. Yani bu kodu çalıştıracağınızda, herhangi bir sonuç alamayacaksınızdır.

<< comment comment ve << com com

Bu çeşit için de aynı şey geçerlidir. en başa '<< comment' yazdıktan sonra en sona 'comment' yazıp yorum cümlelerimizi bu iki kalıp arasına yerleştiriyoruz.

Kullanımı, yukarıdaki görseldeki gibidir. Ancak dikkat edin; yazıların tümü beyaz iken özel karakterli yazıların rengi değişmedi. Zaten çalıştırıldığında 'sonuç alamamak' yerine hata aldığımızı görüyorsunuz. Demek ki bu yorum çeşidi, sadece 'gerçek anlamda yorumlar' için uygundur.

Aynı kullanımı, yukarıdaki gibi '<< com com' olarak da sağlayabilirsiniz.

Şimdi, aşağıdaki görseli biraz inceleyelim.

Dikkat edin; biraz önce tam olarak yorum olmayan kısım, : ' ' : ifadesiyle tamamen yoruma döndü. En aşağıda ise biraz önce kullandığımız << comment comment yapısı gayet işe yaramış durumda; çıktıya baktığımızda bir sorun göremiyoruz. Demek ki öğrendiğimiz bu 3 - 4 yorum çeşidini iyi ayarlamanız, ait olduğu yerde kullanmanız gerekiyor. Eğer tek satırlık yoruma ihtiyacınız varsa bunu hash (#) ile, çok satırlı sade metin yorumuna ihtiyacınız varsa << comment comment veya << com com ile ve özel karakterli yorumlara ihtiyacınız varsa : ' ' : ile iş yapmanız uygun olacaktır.


Yayınlanma Tarihi: 2022-09-21 14:28:53

Son Düzenleme Tarihi: 2022-09-22 21:23:56