知识卡片

普通读书笔记卡 · 1915.a.4

结果名应描述计算出的值

理解等级:中级

retval之类的名字只表达返回位置,通常没有说明结果含义。用sum_squares描述平方和,读者就能把累加逻辑与意图对照,发现漏平方的可疑操作。结果名应描述业务值或计算目标,而不是调用方恰好怎样使用它;这种冗余线索帮助检查,不能替代正确性验证。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      sum_squares。这样就提前声明了这个变量的目的,并且可能会帮忙找到缺陷。 例如,想象如果循环的内部被意外写成: 如果名字换成sum_squares这个缺陷就会更明显: 建议 retval这个名字没有包含很多信息。用一个描述该变量的值的名字来代替它。 然而,有些情

    参考来源

    - 位置:《编写可读代码的艺术》泛名、返回值与临时变量(spine 2763;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2687.html`;来源键`s2763-ch02-003`)。 - 结论依据:本项正文及图11..52已完整读取;命名效果由具体案例说明,未执行或改写示例。 - 原始内容:sum_squares。这样就提前声明了这个变量的目的,并且可能会帮忙找到缺陷。 例如,想象如果循环的内部被意外写成: 如果名字换成sum_squares这个缺陷就会更明显: 建议 retval这个名字没有包含很多信息。用一个描述该变量的值的名字来代替它。 然而,有些情