Pambuka

Minangka pangembang, kita asring didhawuhi njaga komentar ing saindenging kode kita. Nanging apa sejatine komentar lan kenapa penting banget kanggo digunakake. Ing artikel iki, kita bakal ngerti logika konco nggunakake komentar.

Komentar minangka baris ing kode kita sing ora digatekake dening kompiler lan juru basa. Iki ditulis kanthi tujuan kanggo nyedhiyakake informasi babagan logika sing digunakake ing kode sumber kanggo programer liyane lan dadi cathetan pangeling kanggo awake dhewe. Tanpa komentar, samubarang bisa dadi tantangan. Ora melu ing output program nanging nambah maca kode.

Ana rong jinis komentar sing digunakake ing Python:

• Komentar baris siji
• Komentar multi-line

Python Single Line Komentar

Kita bisa nyimpulake definisi jinis komentar saka jeneng kasebut. Komentar siji baris dhewe nyatakake yen komentar ing basa pamrograman sing nduweni spasi siji baris. Diwiwiti kanthi simbol hashtag (#) lan tahan nganti pungkasan baris. Lan yen komentar ngluwihi baris, terus komentar ing baris sabanjure sadurunge hashtag (#).

Umume, komentar baris siji digunakake kanggo panjelasan singkat babagan ekspresi utawa variabel.

Conto:

# Iki minangka conto komentar siji-baris. print("Hello India!")

Python Multi-line Komentar

Kanthi jeneng komentar multi-line kita mangertos babagan komentar sing ditulis ing luwih saka siji baris. Teks komentar dilampirake ing watesan (""" …….. """") utawa hashtags (#) digunakake ing wiwitan saben baris. Disaranake nggunakake # komentar siji tinimbang string kutipan triple (""") amarga komentar kasebut bisa dadi docstrings sing ora disengaja.

Komentar multi-line digunakake kanggo katrangan rinci utawa panjelasan babagan program utawa kode supaya gampang diwaca.

Conto:

""" Iki minangka conto komentar multi-baris. Kita bakal nyithak Hello India ing program kita. Ing kene, kita bakal sinau babagan statement print. …. """ print("Hello India!")

Pentinge Komentar ing Python

Upaminipun sampeyan nggarap proyek lan ora digatekake kanggo menehi komentar. Ing ngisor iki, proyek kasebut rampung ing 25,000 baris kode, banjur ana pangembang anyar menyang proyek sampeyan kanggo njaga. Pangembang anyar bakal angel mangertos lan nganalisa kode sampeyan, lan ing wektu kasebut sampeyan uga butuh sawetara wektu kanggo ngerti logika lan mula bakal tundha wektu kanggo miwiti kerja.

Nggunakake komentar ing kode sampeyan mbantu sampeyan ing skenario iki. Komentar mbantu para pangembang ngerti kode kasebut kanthi cepet lan nambah keterbacaan kode.

Sintaks Komentar sing apik / komentar sing ramah pangembang

Ing ngisor iki ana sawetara aturan sing kudu ditindakake nalika nulis komentar ing kode sampeyan.

• Tetep komentar cekak lan prasaja: Sing kurang, luwih apik.

Kode sing cocog lan ringkes gampang dingerteni lan nambah keterbacaan kode.

• Aja komentar WET:

Kode sampeyan kudu GARING yaiku "aja mbaleni dhewe". Nulis komentar kanggo potongan kode sing jelas yaiku kesalahan sing gampang ing kode. Iki nggawe kode WET yaiku "nulis kabeh kaping pindho". Mesthine ora ana redundansi ing kode.

Contone,

print("Iki conto komentar!") #Prints Iki conto komentar!

• Kalebu riwayat revisi:

Ing jangka panjang, bisa migunani kanggo njaga riwayat revisi ing program kasebut. Bisa migunani kanggo pangembang mbesuk nalika njaga kode sampeyan. Nalika kita ndeleng maneh kode apa wae, penting kanggo ngerti sapa sing nggawe owah-owahan lan ngapa iku digawe.