Swift 入門指南 V1.00 - 單元 3 - 變數命名規則




依習慣, Swift 的變數 (variable) 命名會採用英文單字或英文單字組合



包括全小寫的英文單字、首字母大寫的英文單字、第一個英文單字首字母小寫的小寫駝峰型 (lower camel case) 與第一個英文單字首字母大寫的大寫駝峰型 (upper camel case) 。


由於 Swift 直接支援 Unicode 編碼,因此除了用為運算子 (operator) 的半形字元或特殊字元外,其他的字元 (character) 都可以拿來當變數名稱,像是中文


var 變數 = 22

或是直接用希臘字母 π 當常數 (constant)


let π = 3.14

雖說用任何 Unicode 字元當變數或識別字 (identifier) 是可行的,不過要跟既有開發團隊整合或是銜接到程式庫 (library) 及 Cocoa 框架 (framework) ,仍是依習慣比較理想。基本上 Cocoa 裡命名識別字的字元以二十六個英文大小寫字母與數字為主


abcdef
ghijkl
mnopqr
stuvwx
yz
ABCDEF
GHIJKL
MNOPQR
STUVWX
YZ
012345
6789

我們從 The Swift Programming Language: Language Guide 擷取識別字命名的例子以資說明,首先採小寫駝峰型的識別字有變數、常數、函數 (function) 、屬性 (property) 及方法 (method) ,下面是變數與常數的例子


one
integerPi
http404Error
serverResponseCode

函數命名通常會以動詞開頭,例如


sayHello()
printAndCount()
join()
containsCharacter()

屬性命名跟變數雷同,偏向以名詞或形容詞開頭,例如


firstValue
length
fileName
totalSteps

方法也跟函數雷同,也多以動詞開頭,例如


increment()
incrementBy()
isToTheRightOfX()
moveByX()

至於列舉 (enumeration) 、結構 (structure) 、類別 (class) 、協定 (protocol) 等識別字會採大寫駝峰型,以下是列舉命名的例子


CompassPoint
Planet
Barcode
ASCIIControlCharacter

類別與結構的命名會以名詞或複合名詞為主,例如


FixedLengthRange
DataImporter
Resolution
VideoMode

協定比較彈性,可能是形容詞或名詞


FullyNamed
RandomNumberGenerator
Togglable
DiceGame

我們在後續的單元才會慢慢介紹如何定義函數、類別等項目,下個單元先來介紹運算式 (expression) 與陳述 (statement) 。


中英文術語對照


變數variable
小寫駝峰型lower camel case
大寫駝峰型upper camel case
運算子operator
字元character
常數constant
識別字identifier
程式庫library
框架framework
函數function
屬性property
方法method
列舉enumeration
結構structure
類別class
協定protocol
運算式expression
陳述statement

沒有留言: