依習慣, Swift 的變數 (variable) 命名會採用英文單字或英文單字組合
包括全小寫的英文單字、首字母大寫的英文單字、第一個英文單字首字母小寫的小寫駝峰型 (lower camel case) 與第一個英文單字首字母大寫的大寫駝峰型 (upper camel case) 。
由於 Swift 直接支援 Unicode 編碼,因此除了用為運算子 (operator) 的半形字元或特殊字元外,其他的字元 (character) 都可以拿來當變數名稱,像是中文
var 變數 = 22 |
或是直接用希臘字母 π 當常數 (constant)
let π = 3.14 |
雖說用任何 Unicode 字元當變數或識別字 (identifier) 是可行的,不過要跟既有開發團隊整合或是銜接到程式庫 (library) 及 Cocoa 框架 (framework) ,仍是依習慣比較理想。基本上 Cocoa 裡命名識別字的字元以二十六個英文大小寫字母與數字為主
a | b | c | d | e | f |
g | h | i | j | k | l |
m | n | o | p | q | r |
s | t | u | v | w | x |
y | z | ||||
A | B | C | D | E | F |
G | H | I | J | K | L |
M | N | O | P | Q | R |
S | T | U | V | W | X |
Y | Z | ||||
0 | 1 | 2 | 3 | 4 | 5 |
6 | 7 | 8 | 9 |
我們從 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 |
沒有留言:
張貼留言