知识卡片

普通读书笔记卡 · 6991.r.5.a.10 · 生成模型:未记录

相同词不应掩盖不同操作

理解等级:中级

若某处add计算两个值的新结果,另一处却把元素放入已有容器,应让调用者看清结果和副作用的不同。可用append、insert等更具体词,或遵守既有API中清楚定义的add契约。书中例子是命名建议,不意味着Java集合等现有协议中的add应一律改名;要比较实际责任,而非单按拼写认定等价。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元005;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。 - 结论依据:原文由计算新值与向集合插入对照支持语义区别,补充现有协议边界避免将作者偏好误写成所有add都错误。未在本机运行示例或改变环境。 - 原始内容:直就是天降福音。 2.13 别用双关语 避免将同一单词用于不同目的。同一术语用于不同概念,基本上就是双关语了。如果遵循“一词一义”规则,可能在好多个类里面都会有add方法。只要这些add方法的参数列表和返回值在语义上等价,就一切顺利。