Yorum satırı

Yorum satırı, program ve web sitesi projelerinde, kod yazan kişinin projenin kaynak kodlarına bakan herhangi bir kişiye mesaj vermesi amacıyla kullanılır.^[1] Yorum satırları, kodun okunabilirliğini artırmak, karmaşık algoritmaları açıklamak veya geçici notlar almak için kullanılır.

Yorum satırları, derleyiciler ve yorumlayıcılar tarafından genellikle atlanır, bu da performans artışına katkı sağlar. Ancak, bu her zaman geçerli değildir. Örneğin, yorumlayıcılar, blok yorumlarının yanında kod olabileceği için bu yorumları okumak zorundadır ve yorumlayıcılarda performans konusunda hafif de olsa sıkıntı oluşturabilir.

Yorum satırları, kodun farklı kısımlarını açıklamak ve diğer geliştiricilere rehberlik etmek için kullanılır. Büyük projelerde, birden fazla geliştirici aynı kod tabanı üzerinde çalıştığında, yorumlar kodun amacını, nasıl çalıştığını ve belirli kararların neden alındığını anlamalarına yardımcı olur. Bu, özellikle karmaşık veya eski projelerde oldukça önemlidir, çünkü yeni geliştiriciler yorumlar sayesinde daha hızlı adapte olabilirler.

Ayrıca, yorumlar hata ayıklama sürecinde de büyük kolaylık sağlar. Geliştiriciler, belirli kod bölümlerinin neden beklendiği gibi çalışmadığını belirlemeye çalışırken, yorumlar bu süreçte yol gösterici olabilir.

Genel bakış

Yorumlar genelde blok veya satırsal olarak yazılır. Blok yorumlar kodun belli bir kısmını geçmez kılar iken blok yorumun bittiği yerde komut devam eder, satırsal yorumda ise satırsal yorum işaretinden sonraki her şey, bir sonraki satıra kadar yorum kabul edilir.

Programlama dillerinde


Dil	Blok yorum başlatıcı	Blok yorum bitirici	Satırsal yorum
Ada			`--`
APL			`⍝`
AppleScript	`(*`	`*)`	`--`
Assembly			`;`
BASIC			`REM`,`'`
C	`/*`	`*/`	`//`
C#	`/*`	`*/`	`//`
D	`/*`	`*/`	`//`
ColdFusion	`<---`	`--->`
Fortran IV			`C`
Fortran 90	`!*`	`*`	`!`
Haskell	`{-`	`-}`	`--`
Java	`/` Javadoc: `/*`	`*/`	`//`
Javascript	`/*`	`*/`	`//`
Lua	`--[[`	`]]`	`--`
MATLAB	`%{`	`%}`	`%`
Nim	`#[`	`]#`	`#` dokümantasyon:`##`
OCaml	`(*`	`*)`
Pascal, Delphi	`(*`	`*)`
PHP	`/` PHPDoc: `/*`	`*/`	`//`
Python	`"""`	`"""`	`#`
SQL			`--`
Swift	`/*`	`*/`	`//`