知识卡片

普通读书笔记卡 · 1915.a.1.d

方法名应符合调用成本预期

理解等级:高级

接口名字会使调用者形成成本预期。get通常让人想到轻量读取,若每次都遍历全部样本重新计算,用compute等表达计算行为会更清楚,或者把实现改为真正轻量的查询。命名不是复杂度保证;重要路径仍应核对实际契约,不能只凭其他容器或相似函数的名字推断成本。

旧list.size案例在每轮删除中重新线性计数,合计形成二次工作;本书已注明较新标准改变了size复杂度,不能套用到任意现代实现。功能测试通过不表示大输入成本符合调用预期。

计数查询的实际代价可能随实现变化,名字不应轻率暗示廉价字段读取;不过避免Get本身不能替代复杂度说明。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 3 处

    • · 查看原书依据

      getMean()的实现是要遍历所有经过的数据并同时计算中值。如果有大量的数据的话,这样的一步可能会有很大的代价!但一个容易轻信的程序员可能会随意地调用getMean(),还以为这是个没什么代价的调用。 相反,这个方法应当重命名为像computeMean()这样的名字,

    • · 查看原书依据

      O(n2)操作。 这段代码从技术上来讲“正确”,事实上它也通过了所有的单元测试。但当把ShrinkList()应用于有100万个元素的列表上时,要花超过一个小时来完成! 可能你在想:“这是调用者的错,他应该更仔细地读文档。”有道理,但在本例中,list.size()不是

    • · 查看原书依据

      轻量级的访问器”。你将会看到,其他的实现并不会是轻量级的,所以最好不要"get"这个词。 然而方法名Count()是有问题的。我们问同事他们认为Count()会做什么,其中一些人认为它的意思是“返回所有时间里的总的计数”。这个名字有点违反直觉。问题是Count既是个名词

    参考来源

    - 位置:《编写可读代码的艺术》名字与调用成本预期(spine 2781;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2705.html`;来源键`s2781-ch03-005`)。 - 结论依据:本项正文与图53..76完整实读;区分名称约定、真实实现契约及旧版本性能例,不复制原文已识别的均值/中值笔误。 - 原始内容:getMean()的实现是要遍历所有经过的数据并同时计算中值。如果有大量的数据的话,这样的一步可能会有很大的代价!但一个容易轻信的程序员可能会随意地调用getMean(),还以为这是个没什么代价的调用。 相反,这个方法应当重命名为像computeMean()这样的名字, - 位置:《编写可读代码的艺术》隐藏成本与旧容器接口案例(spine 2782;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2706.html`;来源键`s2782-ch03-005`)。 - 结论依据:本项正文与图53..76完整实读;区分名称约定、真实实现契约及旧版本性能例,不复制原文已识别的均值/中值笔误。 - 原始内容:O(n2)操作。 这段代码从技术上来讲“正确”,事实上它也通过了所有的单元测试。但当把ShrinkList()应用于有100万个元素的列表上时,要花超过一个小时来完成! 可能你在想:“这是调用者的错,他应该更仔细地读文档。”有道理,但在本例中,list.size()不是 - 位置:《编写可读代码的艺术》让方法名明确是添加还是查询(spine 2888;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2809.html`;来源键`s2888-ch03-005`)。 - 结论依据:本项正文与图370..400逐幅完整实读,计数器实现作为教学演进,明确时间精度、状态初始化与复杂度前提,不冒称生产实现或已执行验证。 - 原始内容:轻量级的访问器”。你将会看到,其他的实现并不会是轻量级的,所以最好不要"get"这个词。 然而方法名Count()是有问题的。我们问同事他们认为Count()会做什么,其中一些人认为它的意思是“返回所有时间里的总的计数”。这个名字有点违反直觉。问题是Count既是个名词