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:

  • 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…
  • Rahasia Tidur Cepat: Meraih Malam Tenang dalam… Tahukah Anda bahwa tidur yang nyenyak dapat membantu Anda menjalani hari yang lebih produktif? Namun, bagi sebagian orang, mendapatkan tidur yang nyenyak bukanlah hal yang mudah. Jika Anda termasuk salah…
  • 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…
  • Rahasia Menambah Berat Badan Sehat Melalui Olahraga Bagaimana Menambah Berat Badan dengan Workout: Tips dan Strategi yang Mudah Diterapkan Apakah Anda kesulitan menambah berat badan meskipun sudah makan banyak dan berolahraga teratur? Jika ya, Anda tidak sendirian.…
  • 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,…
  • 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.…
  • 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…
  • Pencari Kelompok Pendukung HIV/AIDS - HealthyWomen Diaz Thailand Koordinator Program Wanita Sehat Thaïs Diaz memiliki latar belakang kesehatan masyarakat, nutrisi dan Apa yang perlu dan menjabat sebagai Koordinator Program Wanita Sehat. Pengalaman sebelumnya meliputi penelitian dan…
  • 10 Tips Hidup Sehat yang Wajib Dicoba untuk Hidup Lebih Baik Tips Jitu Menulis Di era yang serba cepat ini, menjaga kesehatan tubuh menjadi tantangan tersendiri. Banyaknya aktivitas dan tuntutan membuat kita sering mengabaikan kesehatan dan akhirnya jatuh sakit. Padahal, hidup…
  • Bagaimana cara meminta perlindungan asuransi… Jika Anda mengalami obesitas, mendapatkan perawatan medis dan dukungan lain yang layak Anda dapatkan bisa jadi sulit. Asuransi mungkin tidak mencakup semua perawatan modern atau program khusus. Dan biaya Anda…
  • Ini otakmu yang tidak pernah tidur Sehari setelah tidak tidur nyenyak, Anda mungkin merasa sedikit kabur, sedikit lebih lapar dari biasanya, lebih lambat merespons, mudah tersinggung, dan bahkan mungkin sedikit sedih. Atau Anda mungkin merasa baik-baik…
  • Rahasia Anti Ngantuk: Tips Ampuh Agar Tetap Fokus… Pernahkah Anda merasa ingin tidur di saat yang tidak tepat? Seperti saat bekerja, belajar, atau bahkan saat sedang menyetir? Jika ya, Anda tidak sendirian. Banyak orang yang mengalami masalah ini.…
  • Rahasia Tidur Cepat: Meraih Malam Tenang dalam… Tahukah Anda bahwa tidur yang nyenyak dapat membantu Anda menjalani hari yang lebih produktif? Namun, bagi sebagian orang, mendapatkan tidur yang nyenyak bukanlah hal yang mudah. Jika Anda termasuk salah…
  • Menjadi master Python pada tahun 2022 StackCommerce Python adalah salah satu bahasa pengkodean paling berguna di dunia. Bahkan jika Anda belum pernah melihat sekilas satu baris kode pun, Anda dapat mempelajari Python dengan Bundel Bootcamp Sertifikasi…
  • Rahasia Sukses Turunkan Berat Badan dengan Cepat:… Pengen Tahu Rahasia Cepat Langsing? Yuk, Intip Cara-cara Berikut Ini! Siapa sangka, menurunkan berat badan dengan cepat ternyata bukan mustahil, lho! Ada banyak cara yang bisa dilakukan jika Anda bertekad…
  • 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 Tidur Cepat: Meraih Malam Tenang dalam… Tahukah Anda bahwa tidur yang nyenyak dapat membantu Anda menjalani hari yang lebih produktif? Namun, bagi sebagian orang, mendapatkan tidur yang nyenyak bukanlah hal yang mudah. Jika Anda termasuk salah…
  • Aktivitas 30 Detik Ini Secara Dramatis Dapat… Terkadang, hal-hal kecillah yang paling membantu.Jika Anda seperti saya, pagi hari kerja bisa menjadi pekerjaan yang berat. Anda bersandar pada kopi untuk dorongan buatan dan Anda membajak email kerja dan…
  • Rahasia Kesehatan yang Terabaikan: Tips Menjaga… Hidup Sehat dan Panjang Umur dengan 7 Tips Jaga Kesehatan Praktis Ini! Memiliki tubuh yang sehat dan umur yang panjang merupakan dambaan setiap orang. Namun, seringkali kita lalai menjaga kesehatan…
  • Cara Ampuh dan Mengejutkan: Turunkan Berat Badan… Mendambakan berat badan ideal namun kesulitan mencapainya? Jangan khawatir, Anda tidak sendirian. Sejarah Indonesia Intan. Tapi, tenang saja, ada beberapa cara turun berat badan mendadak yang bisa Anda coba. Yuk,…
  • 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.…
  • Rahasia Jitu: Cegah Kantuk saat Belajar, Raih… Tips Agar Tidak Ngantuk Saat Berkendara, Kerja, atau Belajar Pernahkah Anda merasa ngantuk saat sedang berkendara, bekerja, atau belajar? Jika ya, Anda tidak sendirian. Rasa kantuk merupakan masalah umum yang…
  • (7 Hari) Tips Cepat Turunkan Berat Badan: Terbukti… 1 Minggu Bisa Turun Berat Badan, Ini Caranya! Apakah Anda sedang mencari tips cara menurunkan berat badan dalam waktu 1 minggu? Jika ya, maka Anda berada di tempat yang tepat.…
  • 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…
  • Tips Ampuh Turun Berat Badan Cepat dan Sehat:… Cara Menurunkan Berat Badan Cepat: Panduan Lengkap untuk Mencapai Tujuan Berat Badan Ideal Ingin tahu cara menurunkan berat badan cepat? Anda tidak sendirian! Banyak orang berjuang dengan berat badan, dan…
  • Makan Lebih Baik untuk Tidur Lebih Baik: Hubungan… Sebagai Inc. kolega Jessica Stillman menunjukkan dalam artikel viral-nya tentang mengapa Anda harus mengadopsi kebiasaan tidur balita, mendapatkan tidur malam yang baik cukup sulit sebelum pandemi . "Coronasomnia"? Ini adalah…
  • Langkah-Langkah Pendaftaran Kartu Prakerja Gelombang 12 2021 PMO sedang bersiap untuk membuka gelombang ke-12 pendaftaran program Kartu Prakerja. Tetapi bagi yang sudah mendaftar di tahun 2020 tidak bisa untuk mendaftarkan dirinya kembali. Namun, terkait pembukaan pendaftaran…
  • 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…
  • 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.…
  • Intro ramah pemula untuk pemrograman Java ini hanya… StackCommerce Kami mengunduh lebih banyak aplikasi pada tahun 2021 daripada sebelumnya. Dan tren menunjukkan bahwa kami akan mengunduh lebih banyak lagi tahun ini. Inti nya? Jika Anda mencari karier yang…
Designed by SuaraSekitar Terkini
© Copyright 2025, All Rights Reserved