Harap Cantumkan Satuan di Nama

atau gunakan tipe kuat

ditulis oleh Ruud van Asseldonkditerbitkan

Ada satu jebakan keterbacaan kode yang mudah dihindari begitu Anda menyadarinya, namun jebakan itu meresap: menghilangkan unit. Pertimbangkan tiga cuplikan berikut dalam Python, Java, dan Haskell:

Berapa lama program ini tidur? Program Python tidur selama lima menit, program Java tidur selama 0,3 detik, dan program Haskell tidur selama 0,3 milidetik.

Bagaimana Anda bisa mengetahuinya dari kode ? Anda tidak bisa. Anda hanya perlu hafal bahwa time.sleep

membutuhkan beberapa detik, sedangkan threadDelay

membutuhkan waktu mikrodetik. Jika Anda cukup sering mencarinya, pada akhirnya pengetahuan itu akan melekat, tetapi bagaimana kita bisa menjaga agar kode tetap dapat dibaca bahkan untuk orang yang belum pernah bertemu time.sleep sebelumnya?

Opsi 1: pasang unit dalam nama

Alih-alih ini: 

def frobnicate(batas waktu: int) -> Tidak ada:   ...  frobnicate(300)

Melakukan hal ini: 

def frobnicate(*, timeout_seconds: int) - > Tidak ada:  
 # memaksa penelepon untuk menggunakan argumen bernama  # untuk semua argumen setelah *.  ...  frobnicate(timeout_seconds=300)
Dalam kasus pertama, kami bahkan tidak dapat mengatakan di situs panggilan bahwa 300 adalah batas waktu, tetapi bahkan jika kita tahu itu, itu adalah batas waktu 300, apa?  Milidetik?  Detik?  hari di Mars?  Sebaliknya, situs panggilan kedua sepenuhnya cukup jelas.
Menggunakan argumen bernama bagus untuk bahasa yang mendukungnya, tetapi ini tidak selalu memungkinkan.  Bahkan dalam Python, di mana time.sleep didefinisikan dengan satu argumen bernama dtk
, Bagaimana F-150 Lightning tidur (dtk=300)
 karena alasan implementasi.  Dalam hal ini, kita dapat memberikan nilai sebuah nama sebagai gantinya.
Alih-alih ini: 
Melakukan hal ini: 
sleep_seconds = 300 waktu.tidur(sleep_seconds)
Sekarang kodenya tidak ambigu, dan dapat dibaca tanpa harus membaca dokumentasi.
Opsi 2: gunakan tipe kuat
Alternatif untuk menempatkan unit di name, adalah menggunakan tipe yang lebih kuat daripada integer atau float.  Misalnya, kita mungkin menggunakan tipe durasi.
Alih-alih ini: 
def frobnicate(batas waktu: int) -> Tidak ada:   ...  
frobnicate( 300)
Melakukan hal ini: 
def frobnicate(batas waktu: timedelta) -> Tidak ada:   ...   batas waktu = delta waktu(detik=300) 
frobnicate(batas waktu)
Untuk angka floating-point tertentu, Anda perlu diberi tahu di luar pita apa unit untuk dapat menafsirkannya .  Jika Anda beruntung, informasi ini ada dalam nama variabel atau argumen, tetapi jika Anda tidak beruntung, informasi ini hanya ditentukan dalam dokumentasi — atau tidak ditentukan sama sekali.  Tetapi untuk nilai timedelta, tidak ada ambiguitas tentang bagaimana menafsirkannya, ini adalah bagian dari jenisnya.  Ini juga menghilangkan ambiguitas dari kode.
Cakupan
Saran untuk menggunakan tipe kuat atau untuk menempatkan unit dalam nama tidak terbatas pada variabel dan argumen fungsi , ini berlaku untuk API s, nama metrik, format serialisasi, file konfigurasi, flag baris perintah, dll. Dan meskipun nilai durasi adalah kasus yang paling umum, saran ini tidak terbatas pada itu, tetapi juga berlaku untuk jumlah moneter, panjang, data ukuran, dll.
Misalnya, jangan kembalikan ini: 
{  "error_code" :  "E429",  "pesan eror ":  "Batas tarif terlampaui",  "coba_setelah":  100, }
Kembalikan ini sebagai gantinya: 
{  "error_code":   "E429",  "pesan eror":  "Batas tarif terlampaui",  "coba lagi_setelah_detik":  100, }
Jangan mendesain konfigurasi Anda file seperti ini: 
request_timeout=10
Terima satu dari ini sebagai gantinya: 
request_timeout=10 detik request_timeout_seconds=10
Dan jangan mendesain CLI Anda aplikasi akuntansi seperti ini: 
tampilkan transaksi --jumlah minimum 32
Terima salah satu dari ini sebagai gantinya: 
 show-transactions --minimum-amount-eur 32 show-transactions --minimum-amount "32 EUR"
Baca selengkapnya

Rekomendasi:

  • Rahasia Menurunkan Berat Badan 5kg dalam 1 Minggu:… Ketahui Rahasia: Tips Menurunkan Berat Badan 5Kg dalam 1 Minggu yang Aman dan Efektif Apakah Anda sedang berjuang dengan berat badan yang berlebih dan ingin mendapatkan hasil yang cepat? Tenang,…
  • Apa itu perceraian saat tidur? Tentu, senang memiliki tubuh yang hangat untuk tertidur di sampingnya. Tapi apa yang terjadi ketika tubuh hangat itu mulai mendengkur seperti dengungan?Ini mungkin membuat Anda bertanya-tanya apakah sebaiknya Anda tidur…
  • Ilmu tidur dan kinerja - pelajari cara tidur lebih nyenyak Semua orang berbicara tentang fakta bahwa tidur sangat penting untuk menjaga kesejahteraan dan kesehatan Anda secara keseluruhan, tetapi hanya sedikit yang berbicara tentang fakta bahwa kualitas tidur dapat memengaruhi performa…
  • Rahasia Menambah Berat Badan Cepat dan Sehat: Tips… Bagaimana Cara Menambah Berat Tubuh dengan Cepat dan Aman? Bagi sebagian orang, memiliki berat badan yang kurang ideal merupakan masalah yang cukup mengganggu. Berbagai cara pun dilakukan untuk bisa mendapatkan…
  • Rahasia Sehat: Metode Hidup Sehat yang Terbukti… Hidup Sehat: Kunci Kebahagiaan dan Produktivitas Di dunia yang serba cepat ini, menjaga kesehatan sering kali menjadi hal yang terabaikan. Padahal, hidup sehat sangat penting untuk menjaga kesejahteraan fisik, mental,…
  • Turunkan Berat Badan Sehat dan Tetap Produktif di… Menurunkan berat badan di usia lanjut memang bukan perkara mudah. Namun, bukan berarti mustahil. Format Cuti Pegawai dan cara yang tepat, Anda bisa menurunkan berat badan dan hidup lebih sehat.…
  • Insomnia bukan hanya ketidaknyamanan. Ini dapat… Erica pertama kali menemui dokter tentang ketidakmampuannya untuk tidur atau insomnia, dia berusia 9 tahun. "Saya sering ingat dia menanyakan pertanyaan tentang berapa banyak soda yang saya minum," katanya. Sayangnya,…
  • Rahasia Berat Badan Ideal Tanpa Keluar Keringat dan… Tahukah Anda bahwa menurunkan berat badan tanpa olahraga itu mungkin? Ya, itu benar! Tidak perlu lagi menyiksa diri dengan olahraga yang berat dan melelahkan. Anda bisa mendapatkan tubuh langsing dan…
  • Rahasia Jitu Menjaga Kesehatan di Musim Hujan! Saat musim hujan, berbagai penyakit mudah menyerang. Agar tetap sehat, ikuti tips berikut ini. Musim hujan seringkali membuat kita merasa tidak nyaman. Bagaimana tidak, selain udara yang dingin dan lembap,…
  • Cara Aman Menurunkan Berat Badan Bagi Ibu Hamil Cara Menurunkan Berat Badan ketika Hamil yang Aman dan Sehat Menjaga berat badan yang sehat selama kehamilan sangat penting bagi kesehatan ibu dan bayi. Namun, banyak ibu hamil yang mengalami…
  • Rahasia Menurunkan Berat Badan Tanpa Menyiksa:… Apakah Anda merasa bosan dengan diet ketat dan olahraga berat yang tidak kunjung berhasil menurunkan berat badan? Tenang, Anda tidak sendirian. Banyak orang yang mengalami hal yang sama. Namun, jangan…
  • Obral Valentine: Pelajari cara membuat kode dengan… StackCommerce Pemrogram profesional mendapatkan upah yang layak. Gaji bervariasi dari satu negara bagian ke negara bagian lainnya dan bergantung pada faktor lain, tetapi mungkin saja seorang pembuat kode yang berbakat…
  • Pencarian saya untuk tidur tanpa gangguan Biasanya terjadi secara perlahan. Seperti sudut bayangan yang diangkat ke dalam ruangan hitam, membiarkan secercah cahaya masuk, pikiran tentang apa yang harus saya lakukan dan anak-anak saya menyelinap pergi di…
  • Insomnia? 10 Tips Mendapatkan Kunci Morpheus Secara… Tahukah Anda bahwa kualitas tidur yang baik dapat meningkatkan kesehatan fisik dan mental Anda secara keseluruhan? Namun, bagi sebagian orang, mendapatkan tidur yang cukup dan berkualitas mungkin merupakan perjuangan nyata.…
  • Rahasia Diet Sehat dan Aman untuk Ibu Menyusui:… Bagaimana Cara Diet Sehat untuk Ibu Menyusui Tanpa Membuat ASI Hilang? Menjadi ibu menyusui merupakan momen yang membahagiakan sekaligus menantang. Di satu sisi, Anda ingin memberikan ASI terbaik untuk buah…
  • Masalah tahun 2038 masih hidup dan sehat Masalah tahun 2038? Bukankah itu seharusnya diselesaikan sekali dan untuk semua tahun yang lalu? Tidak cukup. Apa itu masalah Tahun 2038 ? Wikipedia menjelaskannya dengan baik, tetapi TL;DR bermuara pada,…
  • Insomnia? 10 Tips Mendapatkan Kunci Morpheus Secara… Tahukah Anda bahwa kualitas tidur yang baik dapat meningkatkan kesehatan fisik dan mental Anda secara keseluruhan? Namun, bagi sebagian orang, mendapatkan tidur yang cukup dan berkualitas mungkin merupakan perjuangan nyata.…
  • Strategi Kode Rendah Pratt & Whitney untuk Menghemat… Produsen mesin kedirgantaraan Pratt & Whitney memperluas penggunaan sumber daya berkode rendah untuk merampingkan proses operasional tertentu dan membuat penggunaan memori institusional veterannya secara lebih efisien. Dengan hampir satu abad…
  • Teknologi Tenang Saat mendesain produk, kami bertujuan untuk memilih posisi terbaik untuk komponen antarmuka pengguna, menempatkan yang paling penting di tempat yang paling mudah diakses di layar. Yang tak kalah penting adalah…
  • Rahasia Diet Sehat dan Tidur Nyenyak untuk Hidup… Tips Diet Sehat Sebelum Tidur Agar Tidur Lebih Berkualitas Pernahkah Anda merasa kesulitan tidur di malam hari? Atau Anda sering terbangun di tengah malam dan sulit untuk tidur kembali? Jika…
  • Bagaimana hot flash mempengaruhi tidur? Apa itu hot flashes? Hot flashes (juga disebut keringat malam saat terjadi di malam hari) melibatkan peningkatan suhu tubuh secara tiba-tiba dan dapat terjadi dengan: Aliran air - drainase berkeringat…
  • Menungkap Rahasia Menambah Berat Badan untuk… Pernahkah Anda merasa kurus dan sulit menaikkan berat badan? Jika ya, Anda mungkin termasuk dalam tipe tubuh ectomorph. Ectomorph adalah tipe tubuh yang cenderung kurus dan sulit menambah berat badan.…
  • Rahasia Malam Tenang: Tips Agar Ibu Hamil Cepat Terlelap Ibu Hamil Susah Tidur? Ini dia tips agar ibu hamil cepat tidur Susah tidur saat hamil adalah masalah umum yang dialami banyak ibu hamil. Perubahan hormon, perubahan fisik, dan stres…
  • Rahasia Hidup Sehat Tanpa Kurang Tidur: Raih Hidup… Kurang Tidur, Awas! Bahayanya Mengintai Kesehatan Anda Kurang tidur merupakan salah satu masalah kesehatan yang umum terjadi dan dapat dialami oleh siapa saja. Kondisi ini dapat disebabkan oleh berbagai faktor,…
  • Rahasia Diet Sehat dan Aman untuk Ibu Menyusui:… Bagaimana Cara Diet Sehat untuk Ibu Menyusui Tanpa Membuat ASI Hilang? Menjadi ibu menyusui merupakan momen yang membahagiakan sekaligus menantang. Di satu sisi, Anda ingin memberikan ASI terbaik untuk buah…
  • Rahasia Cepat Langsing Tanpa Olahraga: Tips Alami… Cara Menurunkan Berat Badan Cepat dan Alami Tanpa Olahraga Apakah Anda merasa frustasi dengan berat badan yang terus bertambah dan tidak tahu bagaimana cara menguranginya tanpa harus berolahraga? Tenang, Anda…
  • AS, Israel Mencari Persatuan dalam Membendung… Penasihat keamanan nasional Biden melakukan perjalanan ke Israel, di mana para pejabat mendorong pendekatan yang lebih kuat ke Teheran jika pembicaraan nuklir gagal Baca selengkapnya
  • Rahasia Menurunkan Berat Badan Secara Cepat dan… Bagaimana Cara Menurunkan Berat Badan dengan Cepat dan Sehat? Menurunkan berat badan dengan cepat merupakan keinginan banyak orang, terutama bagi mereka yang ingin terlihat lebih langsing dan sehat. Namun, menurunkan…
  • Rahasia Cepat Langsing: Tips Praktis untuk… Mau Cepat Langsing? Ikuti 5 Tips Ampuh Ini! Bagi sebagian orang, memiliki berat badan ideal merupakan sebuah dambaan. Namun, menurunkan berat badan bukanlah perkara mudah. Dibutuhkan kedisiplinan dan usaha yang…
  • Paket pelatihan Microsoft PowerShell yang berharga… StackCommerce Setiap orang yang bekerja di bidang TI harus memiliki setidaknya pengetahuan tentang Microsoft PowerShell. Apakah Anda perlu sedikit penyegaran? Kemudian Bundel Sertifikasi Windows PowerShell 2022 adalah pilihan yang ideal.…
Designed by SuaraSekitar Terkini
© Copyright 2026, All Rights Reserved