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:

  • 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 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…
  • 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,…
  • Cara Membuat Orang Berbicara di Rapat Virtual Bagaimana Anda meminta ide atau umpan balik selama pertemuan virtual dengan cara yang mengembalikan jawaban yang berharga (dan bukan hanya dari ekstrovert biasa)? Untungnya, rapat virtual memberi Anda lebih banyak…
  • Cara Mudah Menurunkan Berat Badan dalam 1 Bulan:… Ingin Turunkan Berat Badan dalam 1 Bulan? Berikut Tips Ampuh Wujudkan Impianmu! Berat badan berlebih bukan hanya mengganggu penampilan, tetapi juga kesehatan. Obesitas dapat menyebabkan berbagai penyakit kronis seperti jantung,…
  • Orang dalam sepak bola perguruan tinggi percaya USC… Lincoln Riley, Oklahoma Sooners. (Kredit Wajib: Alonzo Adams-USA TODAY Sports) Satu orang dalam sepak bola perguruan tinggi tidak akan terkejut jika program sepak bola USC mengambil cut home-run dalam upaya…
  • DOS pada Dope 06 September 2010 html, , blog, keamanan, [code], sysadmin, produktivitas, sql, css, baris perintah, fungsional Tahun Baru, Penjualan On Rails.... Ketika Anda sudah mencapai batas Haskell di atas Kuda... Jika…
  • 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…
  • Rajakan Berat Badan Ideal Tanpa Diet Ketat: Cara… Rekrutmen CPNS: Jenjang Menurunkan berat badan tanpa diet mungkin terasa mustahil, tetapi sebenarnya ada banyak cara yang dapat Anda lakukan untuk mencapai tujuan ini. Berikut beberapa tips menurunkan berat badan…
  • 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…
  • 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…
  • 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…
  • 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 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 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…
  • 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…
  • Mengapa Anda Membutuhkan Jadwal Kerja Jarak Jauh Bekerja dari rumah masih merupakan gagasan baru bagi sebagian besar individu, dan menemukan jadwal kerja jarak jauh yang sesuai mungkin menuntut. Kalender - KalenderBagaimanapun, produktivitas bukanlah bawaan, tetapi menjadi produktif…
  • Transformasi Tubuh: Tips Menambah Berat Badan Cepat… Tahukah Anda bahwa berat badan yang kurang dapat menyebabkan berbagai masalah kesehatan? Tips Anti Mainstream, ada beberapa tips yang bisa Anda lakukan. Banyak orang yang menginginkan berat badan yang ideal,…
  • 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 Pria: Turunkan Berat Badan dengan Cepat dan Aman Bagaimana Menghilangkan Lemak Perut yang Membandel pada Pria? Simak Tips Diet dan Olahraga Ini! Apakah Anda seorang pria yang sedang berjuang dengan lemak perut yang membandel? Jangan khawatir, Anda tidak…
  • 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 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.…
  • Daftar periksa tidur: 8 kebiasaan tidur sehat terbaik Maret adalah Bulan Kesadaran Tidur.Apakah Anda bolak-balik sepanjang malam? Apakah Anda bangun sebelum fajar dan tidak bisa kembali tidur? Apakah Anda merasa sulit untuk melayang? Seiring bertambahnya usia seorang wanita…
  • 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…
  • 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…
  • 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…
  • 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…
  • Metode Diet Sehat yang Efektif: Kunci Tubuh Langsing… Diet Sehat: Rahasia Menurunkan Berat Badan dan Meraih Tubuh Ideal Pernahkah Anda merasa frustrasi dengan pola diet yang tidak membuahkan hasil? Apakah Anda ingin menurunkan berat badan dan mencapai tubuh…
  • 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…
  • Berat Badan Pasca Caesar: Turunkan dengan Aman dan Efektif Bagaimana Menurunkan Berat Badan Pasca Caesar dengan Aman dan Efektif Menurunkan berat badan setelah melahirkan caesar bisa jadi tantangan tersendiri. Pasalnya, ibu baru biasanya merasa lelah dan tidak punya banyak…
Designed by SuaraSekitar Terkini
© Copyright 2025, All Rights Reserved