知识卡片
度量名应标明单位
时间、大小、速率或角度若不标单位,调用者容易把相同数字按不同量纲解释。给start_ms、elapsed_ms等名字标出毫秒,能提示显示秒之前需要换算;参数名也可表达MB、每秒速率或旋转方向。名字提供可见契约,实际值和换算仍须与接口一致,不能只改名而不改错误计算。
网络模拟器例的文字列表把丢包率标成ms,但图中参数说明是percent,不能把时间单位误配给比例;命名、注释和实际量值必须一致。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 度量名应标明单位
- · 让相似代码具有一致外形
原书出处 · 2 处
- · 查看原书依据
返回毫秒而非秒。 通过给变量结尾追加_ms,我们可以让所有的地方更明确: 除了时间,还有很多在编程时会遇到的单位。下表列出一些没有单位的函数参数以及带单位的版本:
- · 查看原书依据
丢包率(ms) 你的代码需要3个不同的TcpConnectionSimulator实例: 这段示例代码需要有很多额外的换行来满足每行80个字符的限制(这是你们公司的编码规范)。遗憾的是,这使得t3_fiber的定义看上去和它的邻居不一样。这段代码的“剪影”看上去很怪,它
参考来源
- 位置:《编写可读代码的艺术》把单位与必要格式写进名字(spine 2768;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2692.html`;来源键`s2768-ch02-008`)。
- 结论依据:本项正文及图11..52已完整读取;命名效果由具体案例说明,未执行或改写示例。
- 原始内容:返回毫秒而非秒。 通过给变量结尾追加_ms,我们可以让所有的地方更明确: 除了时间,还有很多在编程时会遇到的单位。下表列出一些没有单位的函数参数以及带单位的版本:
- 位置:《编写可读代码的艺术》让相似代码具有一致外形(spine 2786;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2710.html`;来源键`s2786-ch02-008`)。
- 结论依据:本项正文及图77..102完整实读;按既有语义前提理解版式改进,不把外观或布局约定当正确性保证。
- 原始内容:丢包率(ms) 你的代码需要3个不同的TcpConnectionSimulator实例: 这段示例代码需要有很多额外的换行来满足每行80个字符的限制(这是你们公司的编码规范)。遗憾的是,这使得t3_fiber的定义看上去和它的邻居不一样。这段代码的“剪影”看上去很怪,它