Swift枚举的文档约定

时间:2016-09-15 07:06:05

标签: swift

Apple API docs上,枚举列为deleteSelf但在我的Xcode中,实际的枚举似乎是DeleteSelf - 请注意开头的大小写差异。没什么大不了的,但浪费了一些时间试图弄清楚为什么它不会识别枚举。

是否有一些文件惯例或Apple网站上的错误?

3 个答案:

答案 0 :(得分:1)

这与Swift 3中更新的API指南有关。在Swift 3枚举之前,枚举案例应该用UpperCamelCase编写,而现在标准已经改为lowerCamelCase。 您遇到的不一致可能是因为您尚未使用Swift 3.0。

答案 1 :(得分:0)

我猜你正在使用Xcode 7.x,对吗? 在Xcode 8上,每个枚举案例都遵循camelCase规则。

此处有更多详情: https://github.com/apple/swift-evolution/blob/master/proposals/0006-apply-api-guidelines-to-the-standard-library.md

答案 2 :(得分:0)

在最新版本的swift,swift 3中,枚举的命名惯例已经改变。

Apple网站上显示的名称是最新版本,因此枚举都在camelCase中。另一方面,你还没有更新Xcode,所以你只能看到PascalCase中的枚举值,这是它的旧命名约定。

您根本不需要担心 。当您决定更新到Swift 3时,Xcode可以为您迁移所有这些内容!