知识卡片
接口名应表达行为
单方法接口常用行为方法名加 er 命名,如 Reader、Writer。已有广泛约定的 Read、Write、String 等方法也应保持其熟悉的签名和含义;若语义不同,应另取名字。方法名在这里是行为契约的一部分,错误复用会让实现者与使用者产生误解。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第04章 名字
原书出处 · 1 处
- 名字 · 查看原书依据
为了避免混淆,不要为你的方法使用这些名字,除非其具有相同的签名和含义。反过来讲,如果你的类型实现了一个和众所周知的类型具有相同含义的方法,那么就使用相同的名字和签名
参考来源
- 位置:《Effective Go中文版》第04章《名字》(源文件:`_epub-src/OEBPS/名字.md.html`)
- 结论依据:原文说明单方法接口的 `er` 命名惯例,并要求常见方法名与标准签名、含义一致。
- 原始内容:按照约定,单个方法的接口使用方法名加上“er”后缀来命名……为了避免混淆,不要为你的方法使用这些名字,除非其具有相同的签名和含义。反过来讲,如果你的类型实现了一个和众所周知的类型具有相同含义的方法,那么就使用相同的名字和签名。