知识卡片
名称同时说明对象与单位
elapsedTimeInDays不仅表示一个整数,还说明量的是经过时间、单位是天。好的名称让调用处看出对象为何存在、记录什么或执行什么,减少依赖外部注释猜含义。单位也可由明确类型和接口统一表达,不必在每个名字重复全部背景;名称仍应与实际计算和存储约定相符。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第2章 有意义的命名 第2章 有意义的命名 · 查看原书依据
指明了计量对象和计量单位的名称
参考来源
- 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元001;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。
- 结论依据:原文以d和多个天数名对照,直接支持计量对象与单位入名,未由名称本身推出实现已经正确。未在本机运行示例或改变环境。
- 原始内容:消逝的感觉,更别说以日计了。我们应该选择指明了计量对象和计量单位的名称: int elapsedTimeInDays; int daysSinceCreation; int daysSinceModification; int fileAg