Dari beberapa proyek open source, saya mengumpulkan gaya pengkodean berikut
void someFunction(bool forget);
void ourFunction() {
someFunction(false /* forget */);
}
Saya selalu ragu tentang apa false
artinya di sini. Apakah ini berarti "lupa", atau "lupa" merujuk pada parameter yang sesuai (seperti dalam kasus di atas), dan "salah" dimaksudkan untuk meniadakannya?
Gaya apa yang paling sering digunakan dan apa cara terbaik (atau beberapa cara yang lebih baik) untuk menghindari ambiguitas?
someFunction(forget: true);
true
menjadi false
dan tidak memperbarui komentar. Jika Anda tidak dapat mengubah API, maka cara terbaik untuk berkomentar adalahsomeFunction( false /* true=forget, false=remember */)
sortAscending
dan sortDescending
, atau serupa). Sekarang, di dalam , keduanya dapat memanggil metode pribadi yang sama, yang mungkin memiliki parameter semacam ini. Sebenarnya, jika bahasa itu mendukungnya, mungkin yang akan saya sampaikan adalah fungsi lambda yang berisi arah penyortiran ...