文章来源于网络收集而来,版权归原创者所有,如有侵权请及时联系!
例子:Clip(text,length)
假设你有个函数用来剪切一个段落的内容:
你可能会想象到Clip()的两种行为方式:
·从尾部删除length的长度
·截掉最大长度为length的一段
第二种方式(截掉)的可能性最大,但还是不能肯定。与其让读者乱猜代码,还不如把函数的名字改成Truncate(text,length)。
然而,参数名length也不太好。如果叫max_length的话可能会更清楚。
这样也还没有完。就算是max_length这个名字也还是会有多种解读:
·字节数
·字符数
·字数
如你在前一章中所见,这属于应当把单位附加在名字后面的那种情况。在本例中,我们是指“字符数”,所以不应该用max_length,而要用max_chars。
推荐用min和max来表示(包含)极限
假设你的购物车应用程序最多不能超过10件物品:
这段代码有个经典的“大小差一”缺陷。我们可以简单地通过把>=变成>来改正它:
(或者通过把CART_TOO_BIG_LIMIT变成11)。但问题的根源在于CART_TOO_BIG_LIMIT是个二义性名字,它的含义到底是“少于”还是“少于/且包括”。
建议
命名极限最清楚的方式是在要限制的东西前加上max_或者min_。
在本例中,名字应当是MAX_ITEMS_IN_CART,新代码现在变得简单又清楚:
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论