enum 陳述式
宣告列舉資料型別的名稱和列舉型別的成員名稱。
[modifiers] enum enumName [ : typeAnnotation]{
enumValue1 [ = initializer1]
[,enumValue2 [ = initializer2]
[, ... [,enumValueN [ = initializerN ] ]]]
}
引數
修飾詞
選擇項。 修飾詞，控制列舉型別的可視性和行為。enumName
必要項。 列舉型別的名稱。typeAnnotation
選擇項。 列舉型別的基礎資料型別。 必須是整數類資料型別。 預設為 int。enumValue1, enumValue2, ..., enumValueN
選擇項。 列舉型別成員。initializer1, initializer2, ..., initializerN
選擇項。 常數運算式，會覆寫列舉型別成員的預設數值。
備註
enum 宣告將新的列舉資料型別引入程式。 enum 宣告只能出現在類別宣告可以出現的內容中，也就是全域範圍、套件範圍或類別範圍，但是不能出現在函式或方法中。
您可以將列舉型別的基礎型別宣告為任何整數類資料型別 (int、short、long、byte、uint、ushort、ulong 或 sbyte)。 列舉成員隱含強制轉換成基礎資料型別或從基礎資料型強制轉換，允許數值資料可以直接設定給 enum 型別變數。 根據預設，列舉型別的基礎資料型別是 int。
每個列舉型別成員都有一個名稱和選擇性 (Optional) 初始設定式。 初始設定式必須是編譯時期常數運算式，此運算式與指定列舉型別有相同型別，或是可以轉換成此型別。 第一個列舉型別成員的值是零或初始設定式的值 (如果有提供)。 接下來的每個列舉型別成員的值會比先前的成員或初始設定式的值 (如果有提供) 多一。
存取 enum 值的方式類似於存取靜態類別成員。 成員的名稱必須以列舉型別的名稱來限定，例如 Color.Red。 將值指派給 enum 型別的變數時，要使用下列其中一項：完整正確的名稱 (例如 Color.Red)、名稱的字串 (String) 表示 (例如 "Red") 或數值。
如果 enum 是設定給在編譯時期就已知的字串，編譯器會執行需要的轉換。 例如，會以 Color.Red 取代 "Red"。 如果字串在編譯時期為未知，則會在執行階段進行轉換。 如果字串不是列舉型別的有效成員，轉換會失敗。 因為轉換會耗費時間而且可能會產生執行階段錯誤，因此請避免將 enum 指定給變數字串。
列舉型別的變數可以儲存宣告值的範圍外部的值。 這項功能的其中一種用法是允許使用成員的結合來當成位元旗標，如下列範例中所示。 將 enum 變數轉換成字串會產生成員名稱的字串表示。
範例 1
下列範例顯示列舉型別的行為。 它會宣告一個名為 CarType 的簡單列舉型別，具有成員 Honda、Toyota 和 Nissan。
enum CarType {
Honda, // Value of zero, since it is first.
Toyota, // Value of 1, the successor of zero.
Nissan // Value of 2.
}
// Declare a variable of type CarType, and give it the value Honda.
var myCar : CarType = CarType.Honda;
print(int(myCar) + ": " + myCar);
myCar = "Nissan"; // Change the value to "Nissan".
print(int(myCar) + ": " + myCar);
myCar = 1; // 1 is the value of the Toyota member.
print(int(myCar) + ": " + myCar);
本程式碼的輸出為：
0: Honda
2: Nissan
1: Toyota
範例 2
下列範例說明如何使用列舉型別來儲存位元旗標，同時也說明該 enum 變數必須能夠儲存沒有明確列於成員清單的值。 它定義一個 FormatFlags 列舉型別，用來修改 Format 函式的行為。
// Explicitly set the type to byte, as there are only a few flags.
enum FormatFlags : byte {
// Can't use the default values, since we need explicit bits
ToUpperCase = 1, // Should not combine ToUpper and ToLower.
ToLowerCase = 2,
TrimLeft = 4, // Trim leading spaces.
TrimRight = 8, // Trim trailing spaces.
UriEncode = 16 // Encode string as a URI.
}
function Format(s : String, flags : FormatFlags) : String {
var ret : String = s;
if(flags & FormatFlags.ToUpperCase) ret = ret.toUpperCase();
if(flags & FormatFlags.ToLowerCase) ret = ret.toLowerCase();
if(flags & FormatFlags.TrimLeft) ret = ret.replace(/^\s+/g, "");
if(flags & FormatFlags.TrimRight) ret = ret.replace(/\s+$/g, "");
if(flags & FormatFlags.UriEncode) ret = encodeURI(ret);
return ret;
}
// Combine two enumeration values and store in a FormatFlags variable.
var trim : FormatFlags = FormatFlags.TrimLeft | FormatFlags.TrimRight;
// Combine two enumeration values and store in a byte variable.
var lowerURI : byte = FormatFlags.UriEncode | FormatFlags.ToLowerCase;
var str : String = " hello, WORLD ";
print(trim + ": " + Format(str, trim));
print(FormatFlags.ToUpperCase + ": " + Format(str, FormatFlags.ToUpperCase));
print(lowerURI + ": " + Format(str, lowerURI));
本程式碼的輸出為：
12: hello, WORLD
ToUpperCase: HELLO, WORLD
18: %20%20hello,%20world%20%20