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:

  • 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,…
  • Rajakan Berat Badan Ideal Tanpa Diet Ketat: Cara… Tips Menurunkan Berat Badan Tanpa Diet yang Dapat Anda Coba Menurunkan berat badan tanpa diet mungkin terasa mustahil, tetapi sebenarnya ada banyak cara yang dapat Anda lakukan untuk mencapai tujuan…
  • 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…
  • 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…
  • 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…
  • Rajakan Berat Badan Ideal Tanpa Diet Ketat: Cara… Tips Menurunkan Berat Badan Tanpa Diet yang Dapat Anda Coba Menurunkan berat badan tanpa diet mungkin terasa mustahil, tetapi sebenarnya ada banyak cara yang dapat Anda lakukan untuk mencapai tujuan…
  • 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 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…
  • 5 Rahasia Lolos Ujian PPMM: Jaminan Anti Gagal! Pernahkah kamu merasa bingung dengan jalur karier yang akan kamu ambil setelah lulus kuliah? Atau, kamu merasa tidak puas dengan pekerjaanmu saat ini dan ingin mencari peluang yang lebih baik?…
  • 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 Diet Sehat: Langkah Praktis Meraih Tubuh… Pendahuluan Program tips diet sehat semakin populer di kalangan masyarakat yang peduli dengan kesehatan dan menginginkan gaya hidup sehat. Dengan mengikuti program ini, Anda dapat menjaga berat badan ideal, mengurangi…
  • Bagaimana Mengkritik, dan Bukan Mengasingkan,… Memuji kinerja yang baik itu mudah karena semua orang suka menerima pujian. Tapi apa yang Anda lakukan ketika tendangan di pantat lebih tepat daripada tepukan di punggung? Berikut cara melakukannya…
  • Melatonin untuk tidur - kesehatan wanita Apakah Anda satu dari tiga orang Amerika yang berjuang untuk mendapatkan jumlah tidur yang disarankan? Karena masalah tidur diperburuk oleh stres pandemi, banyak yang beralih ke alat bantu tidur yang…
  • 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 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 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 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…
  • 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…
  • Turunkan Berat Badan Seminggu? Ini Trik Jitu yang… Ingin Cepat Langsing? Simak Tips Menurunkan Berat Badan Selama Seminggu Ini Menurunkan berat badan memang tidak mudah, namun bukan berarti tidak mungkin. Dengan tips yang tepat, Anda bisa menurunkan berat…
  • 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,…
  • 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 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…
  • [Cara Cepat Langsing dengan Metode Alami (100% Berhasil)] Bagaimana Menurunkan Berat Badan dengan Cepat dan Alami dalam 7 Hari? Apakah Anda merasa tidak percaya diri dengan berat badan Anda? Apakah Anda sudah mencoba berbagai cara namun berat badan…
  • 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.…
  • Kiat Sukses Hidup Sehat Mahasiswa: Panduan Praktis… Hidup Sehat dengan Kocek Mahasiswa, Bisa Kok! Hidup di perantauan sebagai anak kost memang penuh tantangan. Mulai dari mengatur keuangan, mengurus rumah tangga hingga menjaga kesehatan. Apalagi dengan budget yang…
  • 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.…
  • 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…
  • Diet yang Tepat: Kunci Kehamilan Bagi yang Berjuang… Menurunkan Berat Badan untuk Kehamilan: Tips dan Trik yang Harus Anda Ketahui Menurunkan berat badan sebelum hamil memang bukan perkara mudah, tetapi sangat penting untuk mempersiapkan tubuh Anda untuk kehamilan…
  • 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?…
Designed by SuaraSekitar Terkini
© Copyright 2025, All Rights Reserved