Pernyataan, Indentasi, dan Komentar Python: Panduan Jelas
Pernyataan, Indentasi, dan Komentar Python
Panduan ini menjelaskan pernyataan Python, pentingnya indentasi yang konsisten, dan cara menggunakan komentar dan docstring secara efektif.
Pernyataan Python
Instruksi Python yang dieksekusi oleh interpreter disebut pernyataan. Contoh umum termasuk pernyataan penugasan seperti a = 1, pernyataan aliran kontrol seperti if, for, dan while. Dasar-dasar ini membentuk blok konstruksi setiap program Python.
Pernyataan Multi-baris
Secara default, baris baru mengakhiri pernyataan. Untuk membagi pernyataan panjang di beberapa baris, Anda dapat menggunakan karakter lanjutan baris backslash (\):
a = 1 + 2 + 3 + \ 4 + 5 + 6 + \ 7 + 8 + 9
Lebih idio matis, Python memungkinkan lanjutan implisit di dalam tanda kurung, kurung siku, atau kurung kurawal:
a = (1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9)
Demikian pula, literal list dapat mencakup beberapa baris:
colors = ['red', 'blue', 'green']
Anda juga dapat menempatkan beberapa pernyataan sederhana pada satu baris menggunakan titik koma:
a = 1; b = 2; c = 3
Indentasi Python
Berbeda dengan bahasa yang bergantung pada kurung kurawal, Python mendefinisikan blok kode secara murni melalui indentasi. Blok dimulai setelah titik dua dan berakhir pada baris pertama yang tidak diindentasi relatif terhadap awal blok.
Sementara bahasa mengizinkan tingkat indentasi konsisten apa pun, standar komunitas adalah empat spasi. Tab harus dihindari untuk mencegah kebingungan.
for i in range(1, 11): print(i) if i == 5: break
Indentasi yang tepat tidak hanya melaksanakan sintaks tetapi juga membuat kode segera dapat dibaca dan dirawat. Contohnya:
if True: print('Hello') a = 5
berbentuk dengan bentuk satu baris yang kurang dapat dibaca:
if True: print('Hello'); a = 5
Indentasi yang salah memicu IndentationError dan menghentikan eksekusi.
Komentar penting untuk mendokumentasikan maksud dan logika, terutama ketika kembali ke kode beberapa bulan kemudian. Dalam Python, komentar dimulai dengan tanda pagar (#) dan berakhir di akhir baris. Interpreter mengabaikan baris-baris ini sepenuhnya.
# Ini adalah komentar # Cetak sapaan print('Hello')
Untuk mencakup beberapa baris, Anda dapat menambahkan awalan # pada setiap baris:
# Ini adalah komentar panjang # yang melanjutkan selama beberapa # baris
Atau, string triple-quoted dapat berfungsi sebagai komentar blok. Ketika tidak ditugaskan atau digunakan sebagai docstring, mereka diabaikan oleh interpreter, tanpa menimbulkan biaya runtime:
"""Ini adalah komentar multi-baris yang mencakup beberapa baris."""
Docstring dalam Python
Sebuah docstring adalah literal string yang mengikuti definisi fungsi, kelas, atau modul. Ini mendokumentasikan tujuan elemen dan disimpan dalam atribut __doc__ miliknya. Triple quotes secara konvensional digunakan:
def double(num): """Kembalikan dua kali nilai input.""" return 2 * num
Anda dapat mengaksesnya secara terprogram:
print(double.__doc__)
Output:
Kembalikan dua kali nilai input.
Untuk pedoman lebih detail, konsultasikan dokumentasi resmi Python tentang komentar dan docstrings.
