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:

  • 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…
  • 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,…
  • Rahasia Langsing dengan Fitness Tanpa Gagal Demi… Langkah Sederhana untuk Menurunkan Berat Badan yang Efektif dan Sehat Memulai perjalanan penurunan berat badan bukanlah hal yang mudah, bukan? Anda mungkin merasa kewalahan dan tidak yakin harus mulai dari…
  • 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…
  • 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…
  • 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?…
  • 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,…
  • 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,…
  • 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 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 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…
  • 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…
  • 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…
  • 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 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 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 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…
  • Bagaimana program Cashback dan loyalitas bekerja di… Kasino online modern memiliki banyak hal untuk itu. Dari permainan hingga undian dan promosi, mereka memiliki banyak hal untuk ditawarkan. Bahkan, mereka semua menawarkan jenis produk atau layanan yang hampir…
  • 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 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…
  • 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,…
  • 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…
  • Yuk, Cek BLT El Nino Anda Bantuan Langsung Tunai (BLT) diberikan kepada masyarakat melalui Kementerian Sosial, sedangkan bantuan beras diberikan oleh Badan Pangan Nasional. Di bulan Desember ini, pemerintah telah mengucurkan bantuan langsung tunai (BLT) kepada…
  • Rahasia Menurunkan Berat Badan Tanpa Keringat:… Cara Menurunkan Berat Badan Tanpa Berolahraga: Tips dan Trik untuk Mencapai Berat Badan Ideal Ingin menurunkan berat badan tapi tidak punya waktu atau energi untuk berolahraga? Jangan khawatir, ada banyak…
  • 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…
  • Black Friday Sale: Kesempatan terakhir untuk… Musim pemberian hadiah itu sulit. Di atas stresor biasa dalam hidup Anda, Anda masih harus menemukan waktu untuk berbelanja untuk semua orang di daftar Anda. Tetapi dengan cadangan rantai pasokan…
  • Rahasia Langsing dengan Fitness Tanpa Gagal Demi… Langkah Sederhana untuk Menurunkan Berat Badan yang Efektif dan Sehat Memulai perjalanan penurunan berat badan bukanlah hal yang mudah, bukan? Anda mungkin merasa kewalahan dan tidak yakin harus mulai dari…
  • 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 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 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…
Designed by SuaraSekitar Terkini
© Copyright 2026, All Rights Reserved