返回列表的方法中的复数/单数命名

时间:2009-12-14 08:25:06

标签: coding-style naming-conventions

这似乎是一个微不足道的观点,直到你意识到你需要一致性。我不是英语母语人士,我更喜欢问语法和风格。在这些方法名称中哪一个必须首选,返回一个URI列表,每个URI与一个对象相关联?

objectUriList()
objectsUriList()
objectUrisList()
objectsUrisList()

另外,您是否认为好的样式可以明确表示返回的对象是方法名称中的列表。在任何情况下,objectUris()(或其正确的形式)都可以是直观的。

7 个答案:

答案 0 :(得分:5)

我也不是母语为英语的人。正确的表单是objectUriList或objectUris。无论物体和uris的数量如何。

停车场=停车场。
PC存储= PC的存储 橡树林

答案 1 :(得分:2)

objectUriList应该是正确的答案。 (除非函数在多个对象上运行,然后最好使用objectsUriList)。

我喜欢在函数名中指定返回的对象,但因为这是我一生工作的方式(从那时起,编程语言更加疯狂)。如今,我认为没有必要。

答案 2 :(得分:1)

我会调用objectUriList(),它更容易说出来并且基本上是正确的。很明显它返回一个列表,它是一组Uris,所以你真的不需要复数。

但是,你对objectUris()的最终建议也很好,这取决于它在IDE中返回List的容易程度。

答案 3 :(得分:1)

我肯定会使用objectUris()替代方案,省略“List”后缀。正如你所说,整洁而直观。

答案 4 :(得分:0)

最好使用ObjectUriList

建议在某些圈子中不要在成员/参数名称中包含类型名称,因此您应该删除List部分,但我发现“ObjectUriList”比“ObjectUris”更明确和有意义,特别是当你是也可能附近有“ObjectUri”这个名字。

答案 5 :(得分:0)

我认为要区分数组和列表,最好将数据附加到数组'并列出'列表'。

答案 6 :(得分:0)

我通常尝试使用单数命名空间,但有时也尝试使用上下文复数命名空间。例如如果你的返回总是复数,比如一些关键字,我会用复数,但如果它经常是单数,我会坚持单数命名约定。

相关问题