知识卡片
一元调用要区分查询与转换
fileExists(path)对路径询问存在事实,fileOpen(path)则把路径用于取得流对象,二者虽各一个参数,责任与返回结果不同。名称应让调用者知道是在提问、取得资源还是变换数据;转换结果宜在返回值上清楚表达。一个参数不是足够的设计标准,资源所有权和失败条件也需要说明。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第3章 函数
原书出处 · 1 处
- 第3章 函数 3.5 使用描述性的名称 · 查看原书依据
向函数传入单个参数有两种极普遍的理由
参考来源
- 位置:《代码整洁之道》全书 · 第3章 函数,spine012单元004;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0010.xhtml。
- 结论依据:原文并列存在查询与打开转换,直接支持按业务责任而非参数个数解释调用,未将两个例子当所有一元函数的穷尽分类。未在本机运行示例或改变环境。
- 原始内容:数据。 3.6.1 一元函数的普遍形式 向函数传入单个参数有两种极普遍的理由。你也许会问关于那个参数的问题,就像在boolean fileExists("MyFile")中那样。也可能是操作该参数,将其转换为其他什么东西,再输出之。例如,Inpu