千万不要把 bool 设计成函数参数
来源:互联网 发布:知乎诈骗案公益 编辑:程序博客网 时间:2024/05/01 02:02
我们有很多 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 设计成函数参数
- 千万不要把 bool 设计成函数参数
- 千万不要把 bool 设计成函数参数
- 千万不要把 bool 设计成函数参数
- 编程规范---千万不要把 bool 设计成函数参数
- 千万不要把 bool 设计成函数参数(酷壳)
- 千万不要把 bool 当成函数参数
- 千万不要把 bool 当成函数参数
- 千万不要把 bool 当成函数参数
- 千万不要把bool类型当成函数参数(转自CoolShell.cn)
- 千万不要把 bool 当成函数参数 (转自CoolShell.cn)
- 千万不要这样设计网页
- 千万不要这样设计网页
- 千万不要把灯泡放进嘴里
- 千万不要把事情100%做完
- strtok函数真是个蹩脚而又恶心的设计(千万不要嵌套使用strtok函数)
- 定义宏时千万不要把宏的“参数名”和宏中用到的结构体成员名相同!
- 成员变量的初始化顺序与变量在类型中的申明顺序相同,而与它们在构造函数的初始化列表中的顺序无关
- android开发-wifi连接eclipse开发调试环境
- 数据库连接池技术
- 赚钱的旁门左道--站群
- Query Cache 原理
- 千万不要把 bool 设计成函数参数
- 合并两个有序数组
- /etc/sysconfig/i18n文件是什么作用?
- hdu 2604 DP+矩阵二分
- iphone No architectures to compile for (ARCHS=i386, VALID_ARCHS=armv6 armv7)错误解决办法
- css 问题和经验列表 http://www.phpstudy.net/css3/
- C#中定义一个事件和对其的调用
- 关于C51的中断函数要注意的几个问题
- 无线AP——失败中的成功 rt3070的ad-hoc上网