Qt 的 QList 类提供了几种获取列表中项目数量的方法——计数、长度和大小。众所周知,一致性很重要,那么哪一个应该是使用这 3 个的规范/首选方法?
4 回答
我同意@Cogwheel 所说的一切,但老实说,我只会选择一个并坚持下去。我认为好的风格会规定,如果“大小”对你来说听起来最好,那么在任何地方都使用“大小”……不要随意在“计数”、“长度”和“大小”之间交替。这将导致潜在的混乱或大量不必要的文档页面访问。
您可以尝试提出其他一些基本原理,但语言本身甚至不一致。所有 STL 容器(例如list
, vector
)只提供“大小”,string
类提供“大小”和“长度”等。
选择你最喜欢的(或者如果你有多个开发人员,你应该都同意一个最喜欢的)并坚持下去。
您应该努力实现的一致性在您的项目中。试图与其他人保持一致并不会真正获得任何好处,除非他们有某种不相容的方式。
话虽如此,函数名称之间存在细微的语义差异(用英语,而不是 C++)。如果您可以通过利用差异使代码更清晰,那么一致性实际上可能对您不利。
恕我直言,其中任何一个。由于即使是不同的开发人员在您的项目中遵循不同的功能,功能名称也完全是自我记录的,从某种意义上说,其他开发人员可以很容易地理解该功能的含义。
我通常选择“尺寸”。归根结底,这有点随意,但 Qt 容器和 STL 容器通常都有大小,因此很容易在两种类型之间保持一致。也是最短的。每当几个解决方案基本相同时,我总是选择输入最少的那个。这是一个简单的经验法则,因此项目中的每个人通常都能记住它。