关于 PHP class 里面方法的命名

2016-03-21 10:55:27 +08:00
 shiji
比如说我方法的名字叫 isSubset
$a = new XClass();
$b = new XClass();
....
那么大家怎么理解这句:
$a->isSubset($b)
期望返回的结果是:我个人倾向第二个
1. a 是不是 b 的子集?
2. b 是不是 a 的子集?
是不是 isSubset 这个名字有歧义?
1191 次点击
所在节点    问与答
3 条回复
yangqi
2016-03-21 10:57:58 +08:00
正常理解当然是$a is subset of $b, 这里最好把方法名改为 isSubsetOf(), 这样就不会有歧义了。
raincious
2016-03-21 11:01:19 +08:00
如果是这个上下文的话,假定

$a->isSubset($b) 与 $b->isSubset($a) 的结果是一样的。那么其实也是无所谓的吧。

如果真的想消歧义,把名字改成 isSubsetOf 就好了。
linpf
2016-03-21 13:15:10 +08:00
在这里我想说说我的看法,关于函数与类方法的命名。

函数在我感觉是“无归属主体”,而类方法是“有归属主体”。

函数名或方法名适合作为“行为描述”
函数或方法的参数都是适合作为“被动”的一方
方法的对象适合作为“主动”的一方

文字化描述一下:

函数: 处理某目标(目标)/ 将 主动目标 根据 被动目标 处理(主动目标,被动目标)
对象方法: 我->处理某个目标(目标)

所以我觉得这么命名比较好:

函数(第三人称视角):
isSubset($sub, $super);
isSuperset($super, $sub);
方法(第一人称视角):
$super->isMySubset($sub);
$sub->isMySuperset($super);

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/265077

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX