Komentar pada pemrograman digunakan untuk memberikan deskripsi terhadap kode. Untuk kode program yang sederhana mungkin komentar tidak diperlukan tapi saat program yang dibuat terdiri dari puluhan file dan ratusan baris tentu akan sangat merepotkan bagi programmer untuk memahami kembali kode yang telah dia buat
Jadi komentar itu penting. sangat penting. Biasanya ketika orang membuat kode program dia paham betul apa yang sedang dikerjakannya tapi dalam beberapa hari / minggu dia tidak melakukan coding akan terasa susah melanjutkan pekerjaannya kembali karena terlebih dahulu harus memahami kode. Pemahaman terhadap kode akan semakin cepat jika terdapat komentar / dokumentasi kode yang baik
Bukan itu saja komentar sangat penting apabila proyek yang dikerjakan dalam satu tim. Dengan komentar yang baik dan benar seluruh anggota tim proyek akan dengan mudah memahami makna kode yang orang lain tulis
Ada beberapa cara untuk menulis komentar di python
#1 Dengan tanda pagar (#)
Tanda pagar (#) sangat umum digunakan dalam memberikan komentar pada kode.
Contoh penulisan komentar di python
# Latihan komentar # Belajar python dengan ngodingdata.com
Misal kita ingin membuat rumus segitiga kita bisa menyisipkan komentar seperti ini
# buat variabel alas dan tinggi dan isi nilainya alas = 10 tinggi = 5 # rumus menghitung luas segitiga luas = 0.5 * alas * tinggi print(luas)
Mudah bukan? Saat orang lain membaca kode di atas akan cepat memahami bahwa kode di atas adalah untuk menghitung luas segitiga
#2 Dengan triple quotes (”’)
Tanda pagar (#) hanya mampu memberi komentar terhadap 1 baris. Jika kita mempuyai n baris maka akan ada n komentar
Misal, jika kita mempunyai komentar 4 baris maka dapat ditulis sebagai berikut
#buat variabel alas #buat variabel tinggi #masukkan kedalam rumus segitiga #cetak luas segitiga
Tetapi ada alternatif penulisan komentar untuk multiline seperti di atas
Untuk komentar multiline dapat menggunakan triple quotes (”’)
''' buat variabel alas buat variabel tinggi masukkan kedalam rumus segitiga cetak luas segitiga '''
Sebenarnya triple quotes bukanlah komentar tetapi sebuah string yang tidak tersimpan di variabel sehingga tidak dieksekusi oleh program
Pada artikel selanjutnya saat membuat penggalan kode maka komentar akan menjadi salah satu bagian untuk mempermudah pemahaman contoh kode
Berikut daftar tutorial Python dasar:
Pengenalan python dan mengapa harus belajar
Instalasi Python dengan Anaconda di Windows
Instalasi Python dengan Anaconda di Linux
Eksekusi file Python
Pengenalan Variabel dan Tipe Data di Python
Penulisan komentar di python
Teknik Print di Python
Mengenal Jenis Operator di Python
User Input di Python
Memahami Percabangan di Python
Memahami Perulangan di Python
Menggunakan Fungsi di Python
Lambda expression
Struktur List di Python
Struktur Tuple di Python
Struktur Dictionary di Python
File Handling di Python
Memahami Argumen *args **kwargs
Cara Install Library Python
Memahami Jupyter notebook dan cara menggunakannya