Komentar Python

Perkenalan

Panduan ini bukan tentang pemrograman. Faktanya, tidak ada kode baru yang terlibat sama sekali. Namun, itu ada hubungannya dengan memastikan bahwa kode yang Anda tulis dapat dimengerti oleh diri Anda sendiri dan siapa pun yang mungkin melihatnya di telepon.

Jika Anda telah melihat proyek open source, Anda mungkin memperhatikan catatan yang ditempatkan oleh programmer. Catatan itu hanyalah teks biasa. Bahasa pemrograman tidak menyusun atau menafsirkannya dengan cara apa pun. Itu hanya mengabaikan mereka. Ia tahu bahwa komentar itu untuk manusia, bukan komputer.

Komentar sangat penting. Bahkan jika Anda tidak membagikan kode Anda dengan orang lain, Anda akan mengalami contoh di mana Anda melihat kembali sesuatu yang Anda tulis sejak lama dan bertanya -tanya, “Apa yang saya lakukan di sini?"Jika Anda tertarik untuk mengerjakan proyek open source, yaitu, kemungkinan besar Anda, karena Anda membaca ini di situs web Linux, berkomentar bahkan lebih penting. Hal terakhir yang Anda inginkan adalah agar komit Anda ditolak karena tidak dikomentari dan pemelihara tidak ingin membuang waktu untuk mencari tahu apa yang dilakukannya. Komentar juga penting dalam skrip sistem. Ada sangat sedikit departemen TI satu orang di luar sana, dan rekan kerja Anda tidak akan senang jika mereka tidak tahu apa yang terjadi dalam skrip Anda.

Mengomentari Python

Seperti banyak bahasa lainnya, Python memiliki dua jenis komentar yang berbeda, tunggal dan multi line. Komentar baris tunggal sangat baik untuk menambahkan komentar singkat sebelum blok kode atau tepat setelah baris kode yang menjelaskan apa yang dilakukannya. Komentar multi-line berguna untuk menambahkan header atau deskripsi yang lebih rinci ke sepotong kode. Mereka juga bagus untuk mengomentari blok kode sehingga tidak berjalan, yang bagus untuk debugging.

Komentar Single Line

Di Python, satu komentar baris dimulai dengan a #. Ini adalah simbol yang cukup umum untuk digunakan dalam bahasa skrip. Berikut adalah contoh bagaimana Anda akan menggunakan komentar satu baris sebagai deskripsi.

A = 10 b = 15 A = B # Set A Equal to B Print (A + B) 

Kode akan berjalan persis seperti itu jika komentar tidak ada. Komentarnya hanya ada untuk Anda.

Anda juga dapat menggunakan komentar satu baris untuk mengatakan apa yang akan dilakukan oleh beberapa baris kode berikutnya.

# Impor Perpustakaan Matematika Impor Matematika # Jalankan Teorema Pythagoras A = 3 B = 4 C = Matematika.sqrt (a ** 2 + b ** 2) 

Meskipun itu adalah contoh sederhana yang mungkin bisa Anda ketahui dengan melihatnya, komentar membuat melihatnya lebih cepat. Bayangkan waktu yang akan disimpan pada proyek yang lebih kompleks.

Sekarang, lihatlah bagaimana Anda dapat menggunakan komentar satu baris untuk menghentikan baris kode dari berjalan.

a = 10 b = 15 # a = b Apa yang terjadi jika a tidak disetel sama dengan b cetak (a + b) 

Garis yang ditetapkan A sama dengan B tidak berjalan, memberikan hasil yang berbeda dari contoh sebelumnya

Komentar multi-line

Di Python, Anda dapat menunjukkan komentar multi-line dengan menggunakan "" " sebelum dan sesudah kode yang ingin Anda komentari. Tentu saja, Anda juga dapat menggunakan ini untuk komentar teks yang lebih panjang seperti informasi header.

"" "Python Test Author = nama Anda terakhir diperbarui = 1 November, 2016 Versi Python - 3.4.3 Versi Nomor = 1.0.0 "" " 

Tidak ada yang berarti apa pun bagi komputer, tetapi sangat baik untuk mendokumentasikan kemajuan suatu proyek. Menjaga informasi seperti itu dalam file proyek tidak memengaruhi program yang sebenarnya, tetapi memungkinkan Anda dan siapa pun yang bekerja pada proyek untuk memiliki akses cepat dan mudah ke informasi vital. Ini bagus untuk mendokumentasikan proyek kolaboratif dengan banyak file dan banyak penulis. Ingatlah bahwa sebagian besar proyek dunia nyata akan menjadi rumit, jadi mendokumentasikan kode Anda dengan cara ini adalah kebiasaan yang baik untuk masuk.

Komentar multi-line juga penting untuk debugging. Katakanlah Anda baru saja menerapkan fitur baru untuk proyek Anda, tetapi kode baru itu menyebabkan kesalahan. Anda dapat mengomentari seluruh bagiannya untuk menguji fungsionalitas fitur baru demi sepotong, sampai Anda akhirnya mencari tahu di mana masalahnya berada. Katakanlah contoh "Teorema Pythagoras" dari atas adalah bagian dari fitur yang gagal. Anda bisa melakukan sesuatu seperti kode di bawah ini.

# Impor Perpustakaan Matematika Impor Matematika "" "Gagal - Harap Debug # Jalankan Teorema Pythagoras A = 3 B = 4 C = SQRT (A ** 2 + B ** 2)" "" 

Anda juga dapat menggunakan komentar multi-line untuk menghentikan sepotong kode lama saat Anda menggantinya. Hanya menghapus kode biasanya bukan praktik terbaik. Lagipula, begitu Anda menghapusnya, itu hilang. Mengomentari bahwa kode menghentikannya dari berjalan, tetapi juga melestarikannya sebagai referensi atau jatuh kembali untuk berjaga-jaga jika Anda perlu melihatnya lagi.

Kesimpulan

Kode berkomentar penting. Itu tidak bisa dilebih -lebihkan. Itu mungkin tampak membosankan dan membosankan. Itu tidak memiliki kilasan menulis garis pembunuh baru yang mengimplementasikan fitur, tetapi dalam jangka panjang, Anda akan senang bahwa komentar itu ada di sana. Komentar juga merupakan alat debugging yang sangat berharga yang dapat memberi Anda prosedur yang solid untuk menguji sepotong kode yang gagal. Terus berlatih menggunakan komentar dan melihat bagaimana mereka dapat memengaruhi aliran kode saat menghilangkan baris atau blok kode.

Daftar isi

1. Panduan Pendahuluan dan Pemasangan Python
2. File python dan penerjemah
3. Bereksperimen dengan angka dan teks dalam python
4. Variabel Python
5. Bekerja dengan variabel angka dalam python
6. Dasar -dasar string Python
7. String Python tingkat lanjut
8. Komentar Python
9. Daftar Python
10. Metode Daftar Python
11. Daftar Multidimensi Python
12. Python Tuples
13. Operator Python Boolean
14. Pernyataan Python If
15. Python saat loop
16. Python untuk loop
17. Kamus Python
18. Kamus Lanjutan Python
19. Fungsi Python

Tutorial Linux Terkait:

• Ekspresi reguler Python dengan contoh
• Instal Arch Linux di VMware Workstation
• Bagaimana bekerja dengan WooCommerce Rest API dengan Python
• Cara Membangun Aplikasi Tkinter Menggunakan Objek Berorientasi…
• Cara mengelola repositori git dengan python
• Tutorial debugging GDB untuk pemula
• Lanjutan regex bash canggih dengan contoh
• Hal -hal yang harus diinstal pada ubuntu 20.04
• Loop bash dengan contoh
• Sistem Linux Hung? Cara melarikan diri ke baris perintah dan…