array.remove(at: index)
这样子的设计是合理的
原因是这个
x.removeBoxes(havingLength: 12).
这样子的设计也是合理
原因是这个
如果代码 2
是合理的,那么代码 1
也应该符合When the first argument forms part of a prepositional phrase, give it an argument label.
这个原则,所以代码 1 应该改成
array.remove(atIndex: index)
Swift API GuideLines 的地址在这里
1
kingcos 2019-08-02 09:09:39 +08:00 via iPhone 2
Guidelines 只是指导,没有太大约束力,不要为了参考标准而参考,苹果也在不同版本改了很多次这里的东西 API,最早是 removeAt(_ index: Int) 类似这样的
说回这两个,第一处代码对于 Array 的插入是比较让人清晰的,因为我们知道要插入数组的动作,且介词不要跟在函数名后面,放在外部参数名暗示我们该参数是下标,语义化更好。 而第二个 removeBox,读这段代码的人很难知道相应的数据结构,因此带上 havingLength 更符合语义化。 |