我们有很多 Coding Style 或 代码规范。 但这一条可能会经常被我们所遗忘,就是我们经常会在函数的参数里使用bool参数,这会大大地降低代码的可读性。 不信?我们先来看看下面的代码。
当你读到下面的代码,你会觉得这个代码是什么意思?
widget->repaint(false);
是不要 repaint 吗?还是别的什么意思?
看了文档后,我们才知道这个参数是 immediate,也就是说,false 代表不立即重画,true 代码立即重画。
Windows API 中也有这样一个函数:InvalidateRect,当你看到下面的代码,你会觉得是什么意思?
InvalidateRect(hwnd, lpRect, false);
我们先不说 InvalidateRect 这个函数名取得有多糟糕,我们先说一下那个 false 参数? invalidate 意为 “让XXX无效”,false 是什么意思? 双重否定? 是肯定的意思?
如果你看到这样的代码,你会相当的费解的。 于是,你要去看一下文档,或是 InvalidateRect 的函数定义, 你会看到那个参数是 BOOL bErase,意思是:“是否要重画背景”。
这样的事情有很多,再看下面的代码,想把 str 中的 ”%USER%” 替换成真实的用户名:
str.replace("%USER%", user, false); // Qt 3
TNND,那个 false 是什么意思?不替换吗?还是别的什么意思?
看了文档才知道,false 代表: “大小写不敏感的替换”。
其实,如果你使用枚举变量/常量,而不是 bool 变量,你会让你的代码更易读,如:
widget->repaint(PAINT::immediate);
widget->repaint(PAINT::deffer);
InvalidateRect(hwnd, lpRect, !RepantBackground);
str.replace("%USER%", user, Qt::CaseInsensitive); // Qt 4
如果对这个事不以为然的话,我们再来看一些别的示例,你不妨猜猜看看下面的代码:
component.setCentered(true, false);
这什么玩意儿啊?
看了文档你才知道,这原来是 setCentered(centered, autoUpdate);
new Textbox(300, 100, false, true);
这又是什么啊?
看了文档才知道,这是创建一个文本框,第三个参数是:“是否要滚动条”,第四个是:“是否要自动换行”。TNND!
这种情况还不算最差,看看下面的双重否定。
component.setDisabled(false);
filter.setCaseInsensitive(false)
再来一个,如果你读到下面的代码,相信你会和我一样,要么石化了,要么凌乱了。
event.initKeyEvent("keypress", true, true, null, null,
false, false, false, false, 9, 0);
看完这篇文章,我希望你再也不要把bool为作为函数参数了。除非两个原因:
- 你 100% 确认不会带来阅读上的问题,比如 Java 的
setVisible (bool)
.
- 你 100% 确认你想去写出迷一样的代码。
如果你想设计一个好的 API,强烈推荐你读一下 Nokia 的 Qt 的《API Design Principles》,本文就是其中的 “Boolean Trap”。
原文链接:http://coolshell.cn/articles/5444.html
分享到:
相关推荐
经常会在函数的参数里使用bool参数,这会大大地降低代码的可读性
bool函数只有一个参数,并根据这个参数的值返回真或者假。 1.当对数字使用bool函数时,0返回假(False),任何其他值都返回真。 >>> bool(0) False >>> bool(1) True >>> bool(-1) True >>> bool(21334) True 2.当对...
python里面的bool函数应用
bool函数只有一个参数,并根据这个参数的值返回真或者假。 1.当对数字使用bool函数时,0返回假(False),任何其他值都返回真。 >>> bool(0) False >>> bool(1) True >>> bool(-1) True >>> bool(21334) True 2.当对...
1. 不返回值的参数 C++ 原型: bool SendNewSms(char *szTel, char *szMessage); C#引用; [DllImport( CdmaCard.dll,EntryPoint=SendNewSms)] public static extern bool SendNewSms(string ...
OptArgs:Rust 函数的可选参数为任何函数启用可选参数:#[optargs::optfn]pubfnplot ( x:Vec , y:Option <Vec>>, title:Option <&str >, xlabel:Option <&str >, ylabel:Option <&str >, ...
WPF的bool2Visibility转换器使用
对string作了一些扩展,包括string转化为int、string转化为double、string转化为bool、打印系统当前时间。但没有解决数据溢出的问题,请大神帮忙解决!
GNU Bool is a utility for finding files that match a boolean expression.
bool类型
* @brief 检测函数必传参数是否存在 * @param $params array 关联数组 要检查的参数 * @param array $mod array 索引数组 要检查的字段 * @param array $fields array 索引数组 额外要检查参数的字段 * @return...
bool、byte转换功能块,scl语言
bool2.py
ThinkPHP5.0的助手函数汇总,url:Url生成 1. /** 2. * Url生成 3. * @param string $url 路由地址 4. * @param string|array $vars 变量 5. * @param bool|string $suffix 生成的URL后缀 6. * @param bool|string $...
写了一个公共的工具脚本可能设置了好多变量,但是实际使用时可能只使用了一部分,有好多变量都是空的...那我们就想办法把不需要的变量隐藏起来 测试demo写了使用枚举或者bool值控制,控制的变量多的话建议使用枚举
[bool]hook:params{ realFunc[String|must]:用于保存原始函数的函数名称,用于unHook; hookFunc[Function|must]:替换的hook函数; context[Object|opt]:目标函数所在对象,用于hook非window对象下的函数,如String....
写代码过程中经常用到的布尔型bool与BOOL,仔细用好它们很关键
pl0 bool 增添 短路处理,编译原理的爱好者
功能:判断字符串是否是一个标题类型用法注意:该函数只能用于英文isupper与islower功能:isupper判断字符串中的字母是否都是大写islower判断