Komentar, Baris, dan Blok Kode Python

Dalam bahasa pemrograman Python, memahami cara menulis komentar, mengatur baris kode, serta menyusun blok kode merupakan langkah penting dalam menulis program yang rapi, efisien, dan mudah dibaca. Artikel ini akan membahas secara lengkap mengenai apa itu komentar, bagaimana penggunaan baris kode yang benar, serta cara membuat blok kode dalam Python dengan contoh penerapan yang praktis.

1. Pengertian Komentar dalam Python

Komentar adalah bagian dari kode yang tidak dieksekusi oleh program. Komentar digunakan untuk memberikan penjelasan, catatan, atau informasi tambahan yang berguna bagi programmer lain atau diri kita sendiri ketika membaca ulang kode di kemudian hari.

a. Komentar Satu Baris

Untuk membuat komentar satu baris di Python, gunakan tanda pagar # di awal kalimat komentar.

# Ini adalah komentar satu baris
print("Hello, World!")  # Ini juga komentar di akhir baris

Pada contoh di atas, teks setelah tanda # tidak akan dijalankan oleh Python. Komentar satu baris cocok untuk menjelaskan fungsi dari satu baris kode tertentu.

b. Komentar Multi Baris

Python tidak memiliki sintaks khusus untuk komentar multi baris, tetapi kita bisa menggunakan tanda kutip tiga kali (''' atau """) untuk menuliskan komentar panjang. Biasanya cara ini juga digunakan untuk membuat docstring (dokumentasi fungsi atau modul).

'''
Ini adalah komentar multi baris.
Biasanya digunakan untuk menjelaskan logika program
yang cukup panjang.
'''
print("Program berjalan dengan baik")

c. Docstring (Komentar Dokumentasi)

Docstring digunakan untuk menjelaskan fungsi, kelas, atau modul di Python. Docstring diletakkan tepat di bawah definisi fungsi menggunakan tanda kutip tiga kali.

def hitung_luas_persegi(sisi):
    """
    Fungsi ini digunakan untuk menghitung luas persegi.
    Parameter:
    sisi (int atau float): panjang sisi persegi.
    """
    return sisi * sisi

print(hitung_luas_persegi(5))

Ketika kita memanggil help(hitung_luas_persegi) di Python shell, isi docstring akan muncul sebagai dokumentasi fungsi tersebut.

2. Baris Kode dalam Python

Python membaca dan mengeksekusi program berdasarkan baris kode dari atas ke bawah. Setiap baris umumnya berisi satu perintah. Namun, kita juga dapat memecah satu perintah panjang menjadi beberapa baris dengan tanda \ (backslash) atau tanda kurung.

a. Baris Tunggal

Setiap instruksi biasanya ditulis dalam satu baris.

print("Belajar Python menyenangkan!")

b. Baris Ganda dengan Tanda Backslash

Jika perintah terlalu panjang, kamu bisa memecahnya menggunakan tanda \ agar lebih mudah dibaca.

total = 10 + 20 + 30 + 40 + \
        50 + 60 + 70

print(total)

c. Baris Ganda dalam Kurung

Alternatif lainnya, kamu dapat menggunakan tanda kurung, tanda kurung siku, atau tanda kurung kurawal. Cara ini lebih disarankan karena lebih bersih dan umum digunakan.

angka = (
    10 + 20 +
    30 + 40
)
print(angka)

3. Blok Kode dalam Python

Berbeda dengan bahasa lain seperti C atau Java yang menggunakan tanda kurung kurawal {} untuk menandai blok kode, Python menggunakan indentasi (spasi atau tab) untuk menentukan blok program.

a. Contoh Blok Kode pada Kondisi If

x = 10

if x > 5:
    print("Nilai x lebih besar dari 5")
    print("Kode ini termasuk dalam blok if")

print("Kode ini di luar blok if")

Pada contoh di atas, dua baris yang diberi indentasi (spasi) setelah pernyataan if adalah bagian dari blok if. Jika tidak diberi indentasi dengan benar, Python akan menampilkan error IndentationError.

b. Blok Kode dalam Fungsi

def salam(nama):
    print("Halo,", nama)
    print("Selamat belajar Python!")

salam("Nida")

Semua baris di dalam fungsi yang memiliki indentasi sama merupakan bagian dari satu blok kode.

c. Kesalahan Umum: Indentasi Tidak Konsisten

Pastikan kamu menggunakan jumlah spasi yang sama untuk setiap level indentasi. Biasanya 4 spasi adalah standar dalam Python.

# Contoh salah indentasi
if True:
 print("Ini salah!")  # Menggunakan 1 spasi
  print("Ini juga salah!")  # Menggunakan 2 spasi

Kode di atas akan menghasilkan error karena indentasi tidak konsisten. Pastikan kamu selalu menggunakan spasi yang seragam untuk menjaga struktur program tetap rapi.

4. Studi Kasus: Menggunakan Komentar, Baris, dan Blok Kode

Berikut contoh program sederhana untuk menghitung diskon menggunakan konsep komentar, baris kode, dan blok kode dengan benar.

# Program untuk menghitung harga setelah diskon

def hitung_diskon(harga, diskon):
    """
    Menghitung harga akhir setelah diskon.
    harga: harga asli produk
    diskon: persentase diskon (0-100)
    """
    # Hitung potongan harga
    potongan = harga * (diskon / 100)
    
    # Hitung harga akhir
    harga_akhir = harga - potongan
    
    return harga_akhir

# Contoh penggunaan fungsi
harga_asli = 200000
diskon = 15

hasil = hitung_diskon(harga_asli, diskon)

print("Harga asli:", harga_asli)
print("Diskon:", diskon, "%")
print("Harga setelah diskon:", hasil)

Dalam contoh di atas, komentar digunakan untuk menjelaskan bagian kode, setiap blok fungsi memiliki indentasi yang rapi, dan baris kode disusun dengan jelas agar mudah dipahami.

Kesimpulan

Menulis komentar, mengatur baris, dan menyusun blok kode dengan benar merupakan pondasi dasar dalam pemrograman Python. Komentar membantu dokumentasi, baris kode yang rapi mempermudah debugging, dan blok kode memastikan struktur logika berjalan sebagaimana mestinya. Dengan memahami tiga elemen ini, kamu dapat menulis program Python yang bersih, efisien, dan mudah dibaca oleh siapa pun.

Mulailah membiasakan diri menulis komentar yang jelas dan menggunakan indentasi yang konsisten sejak awal belajar Python. Dengan begitu, kualitas kodenmu akan meningkat seiring waktu.