Pengantar Komentar dan Keterbacaan Kode

Komentar digunakan untuk menjelaskan kode dan membuatnya lebih mudah dibaca. Komentar diabaikan oleh penerjemah Python dan tidak memengaruhi eksekusi program.

Dalam pelajaran ini, Anda akan mempelajari cara menggunakan komentar dan menulis kode yang rapi serta mudah dibaca.

Komentar Satu Baris

Komentar satu baris dimulai dengan #. Segala sesuatu setelah # pada baris tersebut diabaikan oleh Python. Sebagai contoh:

# This is a single-line comment
print("Hello, World!")

Komentar Multibaris

Komentar multibaris dapat ditulis menggunakan tanda kutip tiga (''' atau """). Sebagai contoh:

"""
This is a multi-line comment.
It spans multiple lines.
"""
print("Hello, World!")

Mengapa Menggunakan Komentar?

Komentar membantu dalam:

• Menjelaskan kode yang rumit.
• Membuat kode lebih mudah dipahami oleh orang lain dan diri Anda di masa mendatang.
• Menelusuri dan memperbaiki kesalahan.

Ingat, komentar ditujukan untuk manusia, bukan mesin!

Praktik Menulis Komentar yang Baik

Berikut beberapa kiat untuk menulis komentar yang baik:

• Buat komentar tetap singkat dan bermakna.
• Hindari komentar yang sudah jelas, seperti # Increment x by 1 untuk x = x + 1.
• Gunakan komentar untuk menjelaskan alasan kode ditulis dengan cara tertentu.

Meningkatkan Keterbacaan Kode

Kode yang mudah dibaca lebih mudah dipelihara dan diperiksa kesalahannya. Berikut beberapa kiat:

• Gunakan nama variabel dan fungsi yang bermakna.
• Jaga agar baris kode tetap pendek.
• Atur kode ke dalam beberapa bagian menggunakan komentar.

Menonaktifkan Kode dengan Komentar

Anda dapat menggunakan komentar untuk menonaktifkan kode sementara saat menelusuri kesalahan. Sebagai contoh:

# print("This line is commented out and won’t run.")
print("This line will run.")

Contoh: Mendokumentasikan Fungsi

Anda dapat menggunakan komentar untuk mendokumentasikan fungsi dan menjelaskan tujuannya:

def greet(name):
    # This function greets the user by their name.
    print("Hello,", name)

greet("Alice")

Apa yang Kita Pelajari?

Dalam pelajaran ini, Anda telah mempelajari:

• Cara menulis komentar satu baris dan beberapa baris dalam Python.
• Pentingnya komentar bagi keterbacaan dan kemudahan pemeliharaan kode.
• Praktik terbaik untuk menulis komentar dan meningkatkan keterbacaan kode.

Bagus sekali! Mari lanjut ke topik berikutnya.