HOWTO · C
如何在 C 語言中使用 typedef enum
本文介紹如何在 C 語言中使用 typedef enum,解釋其優點並提供清晰的範例。學習如何使用 typedef enum 提高程式碼的可讀性和可維護性,並瞭解如何在結構體中使用它。無論您是初學者還是希望提升技能,本指南都將幫助您輕鬆掌握 C 語言中的列舉。
本頁內容
在 C 語言中,enum 宣告具名整數常數,typedef 可以為列舉類型提供一個更短的名稱。使用這些名稱可以使狀態值和選項值更易於閱讀,然後在輸入或儲存的資料可能來自程式外部的任何地方明確處理這些值。列舉提高了清晰度,但它不會自動驗證指派給變數的每個值。
定義列舉並指派值
沒有明確值的列舉成員從 0 開始;每個後續的列舉成員比前一個值大一。例如,enum { MONDAY, TUESDAY, WEDNESDAY }; 指派 0、1 和 2。當值需要與現有的格式、協定或穩定的程式碼集相符時,您可以明確指派值:enum Status { STATUS_READY = 1, STATUS_RUNNING = 4, STATUS_DONE = 8 };。在明確值之後,下一個隱含值比該值大一。
諸如 STATUS_READY 之類的名稱是整數常數。它們不是變數。列舉變數稍後可以被指派不同的值,並且 C 通常不會將其限制為其宣告中列出的列舉成員。請將來自輸入、檔案或其他外部來源的值視為在使用前需要檢查的資料。
為列舉建立 typedef 別名
列舉標籤和 typedef 別名是相關但不同的名稱。使用 enum State { ... }; 時,宣告使用 enum State。typedef 可以引入更短的別名 State,從而允許像 State current; 這樣的宣告。別名指的是同一類型;typedef 不會建立不同的類型。組合寫法 typedef enum State { ... } State; 同時宣告標籤和別名。
此範例提示輸入一個整數,檢查讀取是否成功,並在將該值轉換為 State 並儲存到 Job 欄位之前對其進行驗證。輸入 2 以查看成功路徑。程式在同一行列印提示和回顯的值,然後 switch 列印 Running。如果讀取失敗或數字不在支援的三種狀態範圍內,程式會列印一則訊息並在轉換之前停止。
#include <stdio.h>
typedef enum State {
STATE_READY = 1,
STATE_RUNNING = 2,
STATE_DONE = 3
} State;
typedef struct Job {
State state;
} Job;
int main(void) {
int input;
printf("Input: ");
if (scanf("%d", &input) != 1) {
puts("Could not read an integer.");
return 0;
}
printf("%d\n", input);
if (input != STATE_READY && input != STATE_RUNNING && input != STATE_DONE) {
puts("Unsupported state.");
return 0;
}
Job job = { (State)input };
switch (job.state) {
case STATE_READY:
puts("Ready");
break;
case STATE_RUNNING:
puts("Running");
break;
case STATE_DONE:
puts("Done");
break;
default:
puts("Unsupported state.");
break;
}
return 0;
}
Input: Could not read an integer.
在結構體中使用列舉類型
上面的 Job 結構體將其狀態儲存在 State 欄位中。這使狀態與描述工作的其他資料放在一起,同時列舉常數使指派和 switch 分支易於閱讀。如果您選擇不定義 typedef 別名,也可以使用標籤將該欄位宣告為 enum State state;。
結構體不會為該欄位新增驗證。如果該值來自可能提供不受支援的數字的來源,請在使用之前對其進行檢查。default 分支使程式在儲存的值與任何具名狀態都不相符時具有明確的回應。如果某個特定的應用程式需要更嚴格的保證,請在值進入程式的邊界處進行驗證,並使該檢查靠近指派位置。
選擇列舉值並安全地使用它們
當常數是內部標籤且其數值表示形式無關緊要時,請使用隱含值。當其他介面需要特定的數字時,請明確指派值,並且如果資料被保存或交換,請保持這些指派穩定。在任何一種情況下,具名常數都比未解釋的整數文字更好地傳達意圖,並為維護者提供一個可以查看可用標籤的地方。
這些優點並不會使列舉變數成為唯讀變數,也不能保證它們僅包含具名的列舉成員。變數在執行期間可能會發生變化,強制轉換或外部輸入可能會產生沒有相應名稱的值。使用帶有 default 分支的 switch,或在處理該值之前根據已接受的列舉成員進行驗證。這樣可以防止意外資料悄悄地走上為已知狀態預設的路徑。
總之,為具名常數宣告列舉,在能使宣告更清晰時新增 typedef 別名,並在狀態所屬的任何地方使用結果類型,包括結構體欄位和函數參數。僅當數字是需求的一部分時才選擇明確數值,並使驗證與列舉提供的命名便利保持分離。