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
, kami tidak bisa menelepon 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:

  • Transformasi Tubuh: Tips Menambah Berat Badan Cepat… Tahukah Anda bahwa berat badan yang kurang dapat menyebabkan berbagai masalah kesehatan? Jika Anda ingin menambah berat badan dengan cepat, ada beberapa tips yang bisa Anda lakukan. Banyak orang yang…
  • Rahasia Berat BB dengan 7 Hari, 100 Persen Dietmu! Bagaimana Menambah Berat Badan Secara Alami? Inilah 5 Tips Mudah Pernahkah Anda merasa kesulitan untuk menambah berat badan? Apakah Anda merasa sudah makan banyak namun berat badan tidak kunjung naik?…
  • Tips Ampuh Tolak Rasa Ngantuk: Solusi Cerdas untuk… Tahukah Anda bahwa rasa kantuk yang berlebihan dapat mengganggu aktivitas sehari-hari? Jika Anda sering merasa mengantuk, mungkin Anda perlu mencoba beberapa tips untuk mengatasinya. Mengantuk merupakan kondisi di mana seseorang…
  • Tips Cepat Mendapatkan Tidur Nyenyak untuk Hidup Sehat Sulit Tidur? Berikut Beberapa Tips Agar Bisa Cepat Tidur Tak sedikit orang yang mengeluhkan susah tidur. Susah tidur membuat tubuh menjadi lelah dan letih, serta membuat aktivitas di hari berikutnya…
  • Rahasia Langsing: Tips Turunkan Berat Badan Mudah dan Cepat Tips Menurunkan Berat Badan dengan Cepat dan Sehat Apakah Anda pernah merasa kesulitan untuk menurunkan berat badan? Apakah Anda sudah mencoba berbagai macam diet dan olahraga, tetapi hasilnya tidak sesuai…
  • 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.…
  • Tips Menurunkan Berat Badan Sim Anda di The Sims 4:… Cara Menurunkan Berat Badan The Sims 4: Tips dan Trik yang Wajib Kamu Ketahui Kamu ingin Sims-mu memiliki tubuh yang ramping dan ideal? Namun, kamu tidak tahu bagaimana cara melakukannya?…
  • 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…
  • 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…
  • Rahasia Menjaga Kesehatan yang Mudah Diterapkan… Cara Hidup Sehat: Rahasia Panjang Umur dan Bahagia Tahukah Anda bahwa hidup sehat dapat menambah kebahagiaan dan umur panjang? Ya, gaya hidup sehat dapat mengurangi risiko penyakit kronis, meningkatkan kualitas…
  • 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…
  • Rahasia Langsing: Rahasia Diet Sehat & Alami untuk… Tahukah Anda bahwa menurunkan berat badan itu mudah? Tidak perlu diet ketat atau olahraga berat, ada cara sederhana yang bisa Anda lakukan untuk mencapai berat badan ideal. Penasaran? Ingin menurunkan…
  • Rahasia Menurunkan Berat Badan Ibu Menyusui Tanpa… Menurunkan Berat Badan Setelah Melahirkan? Bisa Dong, Ini Tipsnya! Bagi seorang ibu menyusui, menurunkan berat badan setelah melahirkan merupakan salah satu tantangan tersendiri. Selain karena perubahan hormonal, menyusui juga dapat…
  • 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…
  • 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 Diet Sehat dan Olahraga: Raih Tubuh Ideal… Cara Diet Sehat dan Olahraga: Kunci Hidup Sehat dan Bahagia Di zaman sekarang, banyak orang yang menyadari pentingnya menjaga kesehatan tubuh. Namun, sayangnya, tidak semua orang tahu cara diet sehat…
  • * Pola Hidup Sehat untuk Hidup yang Lebih Panjang… Memulai Hidup Sehat dengan Tips-Tips Berikut Ini Apakah Anda merasa lelah, tidak berenergi, dan mudah sakit? Jika ya, mungkin Anda perlu mengubah pola hidup Anda menjadi lebih sehat. Pola hidup…
  • Rahasia Diet Sehat Pemula: Raih Tubuh Ideal tanpa… Diet Sehat Pemula, Langkah Awal untuk Hidup Sehat Di era modern ini, menjaga kesehatan menjadi hal yang sangat penting. Salah satu cara untuk menjaga kesehatan adalah dengan menerapkan pola makan…
  • **Rahasia Menurunkan Berat Badan 7 Hari Tanpa Olahraga** Awali: Cara Mudah Menurunkan Berat Badan Tanpa Olahraga dalam 1 Minggu Ingin menurunkan berat badan tanpa harus olahraga? Ternyata, ada cara jitu yang bisa Anda tempuh. Tanpa perlu repot-repot ke…
  • 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 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 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…
  • Insomnia bukan hanya gangguan. Ini dapat memiliki… Erica pertama kali mengunjungi dokter karena ketidakmampuannya untuk tidur atau insomnia, dia berusia 9 tahun. "Saya terutama ingat dia bertanya kepada saya berapa banyak soda yang saya minum," katanya. Sayangnya,…
  • 7 cara sederhana dan realistis untuk menurunkan… usia hanyalah angka. Namun ketika ingin menurunkan berat badan, angka tersebut adalah bagian dari persamaan. Anda mungkin memperhatikan bahwa berat badan Anda bertambah dengan lebih mudah - dan menjadi lebih…
  • 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…
  • Rahasia Terbukti Melangsingkan Tubuh Tanpa… Tahukah Anda bahwa menurunkan berat badan tanpa obat itu mungkin? Ya, Anda tidak salah dengar! Dengan menerapkan beberapa strategi sederhana, Anda bisa mencapai berat badan ideal tanpa harus mengonsumsi obat-obatan.…
  • 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…
  • 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.…
  • 9 Rahasia Tidur Nyenyak yang Wajib Diketahui Pendahuluan Sulit tidur? Anda tidak sendirian. Jutaan orang berjuang untuk mendapatkan tidur yang nyenyak di malam hari. Tapi jangan khawatir, ada banyak hal yang dapat Anda lakukan untuk meningkatkan kualitas…
Designed by SuaraSekitar Terkini
© Copyright 2024, All Rights Reserved