知识卡片
先用自然语言描述
遇到难读逻辑时,先像向同事解释一样,用自然语言说清目标、允许的情形和结束条件,再找出关键词与短语,使代码结构与它们对应。描述能帮助发现不必要细节和可独立的子问题。它是澄清设计的方法,不能替代精确契约或测试,也不要求代码逐字模仿句子。
抽出子函数后还可再次描述它的职责与停止条件;先前被业务字段遮住的统一规则,可能因此显露,命名也可变得更贴合该职责。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 先用自然语言描述
- · 递归应用描述法简化子函数
原书出处 · 2 处
- · 查看原书依据
关键词和短语。 3.写出与描述所匹配的代码。 清楚地描述逻辑 下面是来自一个网页的一段PHP代码。这段代码在一段安全代码的顶部。它检查是否授权用户看到这个页面,如果没有,马上返回一个页面来告诉用户他没有授权: 这段代码中有相当多的逻辑。像你在本书第二部分所读到的,这种大
- · 查看原书依据
同样应用于AdvanceToMatchingTime()来进改这段代码。下面是对于这个函数所要做的事情的描述: 看一下每个当前行:如果它们匹配,那么就完成了。 否则,向前移动任何"落后"的行。 一直这样做直到所有行匹配(或者其中一个迭代器结束) 这个描述清晰得多,并且比
参考来源
- 位置:《编写可读代码的艺术》第12章:用自然语言检验解决思路(spine 2860;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2782.html`;来源键`s2860-ch12-001`)。
- 结论依据:本项正文与图284..318完整实读;依据实际输入前提说明方法,不把示例重构当作已验证的通用实现。
- 原始内容:关键词和短语。 3.写出与描述所匹配的代码。 清楚地描述逻辑 下面是来自一个网页的一段PHP代码。这段代码在一段安全代码的顶部。它检查是否授权用户看到这个页面,如果没有,马上返回一个页面来告诉用户他没有授权: 这段代码中有相当多的逻辑。像你在本书第二部分所读到的,这种大
- 位置:《编写可读代码的艺术》递归应用描述法简化子函数(spine 2863;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2785.html`;来源键`s2863-ch12-001`)。
- 结论依据:本项正文与图284..318完整实读;依据实际输入前提说明方法,不把示例重构当作已验证的通用实现。
- 原始内容:同样应用于AdvanceToMatchingTime()来进改这段代码。下面是对于这个函数所要做的事情的描述: 看一下每个当前行:如果它们匹配,那么就完成了。 否则,向前移动任何"落后"的行。 一直这样做直到所有行匹配(或者其中一个迭代器结束) 这个描述清晰得多,并且比