知识卡片
名字要指出具体行为
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()