知识卡片

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

名字要指出具体行为

理解等级:中级

Get、Size、Stop等词可能遮住调用者真正要知道的差别:获取来源、度量维度、暂停还是不可恢复终止。选择Fetch/Download、Height/NumNodes/MemoryBytes等具体名字,能让用途及结果更可预测。词语应贴合真实行为;更生动的同义词若不能让人区分操作,反而没有增加有用信息。

ServerCanStart若只检查端口监听,CanListenOnPort更贴合职责;旧宏把拷贝构造和赋值一并称作“邪恶构造”,既带评价又遗漏操作类别,改为CopyAndAssign才描述了实际作用。这里不把旧私有声明宏当现代完整用法。

计数器的Count可能被误读为查询或记录,Add可以更直接表示加入贡献。参数泛化也应符合真实职责,但名字暗示非负不等于实现已验证非负。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 3 处

    • · 查看原书依据

      从本地的缓存中得到一个页面,还是从数据库中,或者从互联网中?如果是从互联网中,更专业的名字可以是FetchPage()或者DownloadPage()。 下面是一个BinaryTree类的例子: 你期望Size()方法返回什么呢?树的高度,节点数,还是树在内存中所占的空

    • · 查看原书依据

      CanListenOnPort()就更具体一些。这个名字直接地描述了这个方法要做什么事情。 下面的两个例子更深入地描绘了这个概念。 例子:DISALLOW_EVIL_CONSTRUCTORS 这个例子来自Google的代码库。在C++里,如果你不为类定义拷贝构造函数或者

    • · 查看原书依据

      Count既是个名词又是个动词,既可以是“我想要得到你所见过的所有样本的计数”的意思也可以是“我想要你对样本进行计数”的意思。 下面几个名字可供代替Count(): ·Increment() ·Observe() ·Record() ·Add() Increment()

    参考来源

    - 位置:《编写可读代码的艺术》第2章:把信息装到名字里(spine 2762;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2686_split_001.html`;来源键`s2762-ch02-002`)。 - 结论依据:本项正文及图11..52已完整读取;命名效果由具体案例说明,未执行或改写示例。 - 原始内容:从本地的缓存中得到一个页面,还是从数据库中,或者从互联网中?如果是从互联网中,更专业的名字可以是FetchPage()或者DownloadPage()。 下面是一个BinaryTree类的例子: 你期望Size()方法返回什么呢?树的高度,节点数,还是树在内存中所占的空 - 位置:《编写可读代码的艺术》用具体名字代替抽象评价(spine 2766;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2690.html`;来源键`s2766-ch02-002`)。 - 结论依据:本项正文及图11..52已完整读取;命名效果由具体案例说明,未执行或改写示例。 - 原始内容:CanListenOnPort()就更具体一些。这个名字直接地描述了这个方法要做什么事情。 下面的两个例子更深入地描绘了这个概念。 例子:DISALLOW_EVIL_CONSTRUCTORS 这个例子来自Google的代码库。在C++里,如果你不为类定义拷贝构造函数或者 - 位置:《编写可读代码的艺术》让方法名明确是添加还是查询(spine 2888;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2809.html`;来源键`s2888-ch02-002`)。 - 结论依据:本项正文与图370..400逐幅完整实读,计数器实现作为教学演进,明确时间精度、状态初始化与复杂度前提,不冒称生产实现或已执行验证。 - 原始内容:Count既是个名词又是个动词,既可以是“我想要得到你所见过的所有样本的计数”的意思也可以是“我想要你对样本进行计数”的意思。 下面几个名字可供代替Count(): ·Increment() ·Observe() ·Record() ·Add() Increment()