getopt() 是 POSIX 標準 C 庫函數,用於**解析命令列選項 (Options/Flags)**。支援短選項 (-a, -b value) 與選項合併 (-abc),不支援長選項 (--help) (需 getopt_long())。
#include
#include
int getopt(int argc, char * const argv[], const char *optstring);
// 全域變數
extern char *optarg; // 選項參數指針 (如 -o filename → optarg="filename")
extern int optind; // 下一個待解析 argv 索引 (初始 1)
extern int opterr; // 非 0 時打印錯誤訊息 (預設 1)
extern int optopt; // 發生錯誤時的選項字元
"ab:c::d"
# a: 無參數選項
# b: : 單冒號 → 必須有參數 (-b value 或 -bvalue)
# c: :: 雙冒號 → 可選參數 (-c[value],參數緊貼無空格)
# d: 無參數選項
# 開頭加 : (如 ":ab:c::") → 抑制預設錯誤輸出 (opterr=0 效果),自行處理錯誤
| 返回值 | 含義 |
|---|---|
'a'..'z', 'A'..'Z', '0'..'9' | 成功識別的選項字元 |
: | 選項缺少必要參數 (optstring 以 : 開頭時) |
? | 未識別選項 / 缺少參數 (optstring 不以 : 開頭時) |
-1 (EOF) | 解析結束 (遇到非選項參數、--、或 argv 耗盡) |
#include
#include
#include
#include
#include
void usage(const char *prog) {
fprintf(stderr, "Usage: %s [-v] [-s size] [-E num] [-b num] [-t tracefile]\n", prog);
exit(EXIT_FAILURE);
}
int main(int argc, char *argv[]) {
int opt;
int vflag = 0;
int s_val = 0, E_val = 0, b_val = 0;
char *trace_file = NULL;
int count_arg = 0;
opterr = 0; // 關閉預設錯誤輸出,自行處理
// optstring: v (無參), s: E: b: t: (皆必須有參數)
while ((opt = getopt(argc, argv, "vs:E:b:t:")) != -1) {
switch (opt) {
case 'v':
vflag = 1;
break;
case 's':
s_val = atoi(optarg);
count_arg++;
break;
case 'E':
E_val = atoi(optarg);
count_arg++;
break;
case 'b':
b_val = atoi(optarg);
count_arg++;
break;
case 't':
trace_file = optarg; // 直接指向 argv 中字串,若需持久請 strdup
count_arg++;
break;
case '?': // 未知選項
case ':': // 缺少參數 (optstring 以 : 開頭時觸發)
fprintf(stderr, "Invalid option or missing argument: -%c\n", optopt);
usage(argv[0]);
default:
usage(argv[0]);
}
}
// 檢查必要參數完整性
if (count_arg < 4) {
fprintf(stderr, "Missing required arguments.\n");
usage(argv[0]);
}
// optind 現在指向第一個非選項參數 (positional arguments)
if (optind < argc) {
printf("Non-option arguments: ");
for (int i = optind; i < argc; i++) printf("%s ", argv[i]);
printf("\n");
}
printf("Parsed: v=%d s=%d E=%d b=%d trace=%s\n", vflag, s_val, E_val, b_val, trace_file);
return 0;
}
| 命令列 | 解析結果 | 關鍵行為 |
|---|---|---|
./test -x -y | opt='?', optopt='x' → 'y' → 結束 | 無效選項觸發 '?',optind 逐步推進 |
./test -n -b xzz -t | n, b(optarg=xzz), t | -bxzz 緊貼寫法等同 -b xzz |
./test -b -t | b(optarg="-t"), '?' (缺參) | 陷阱: -t 被當作 -b 的參數,而非選項 |
./test -t a -b xzz | t, b(optarg=xzz) | 非選項 a 被跳過 (optind 推過),因 -t 無參數 |
./test -ntb xzz | n, t, b(optarg=xzz) | 選項合併 -ntb 依序解析 |
./test -t -o 10 -b xzz (optstring "to::b:") | t, o(optarg=NULL), b(optarg=xzz) | :: 可選參數:-o 後無緊貼參數 → optarg=NULL,-o10 → optarg="10" |
struct option {
const char *name; // 長選項名 (不含 --)
int has_arg; // no_argument(0), required_argument(1), optional_argument(2)
int *flag; // NULL: 返回 val; 非 NULL: *flag=val, 返回 0
int val; // 返回值 / 設定 flag 的值
};
static struct option long_options[] = {
{"verbose", no_argument, 0, 'v'},
{"size", required_argument, 0, 's'},
{"trace", required_argument, 0, 't'},
{"help", no_argument, 0, 'h'},
{0, 0, 0, 0}
};
int long_index = 0;
opt = getopt_long(argc, argv, "vs:t:h", long_options, &long_index);
// long_index 記錄匹配的 long_options 索引
while ((opt = getopt(argc, argv, "optstring")) != -1) switch(opt) ...opterr=0,捕獲 ? 和 : 統一報錯並 usage()。count_arg,解析後檢查 optind 處理 positional arguments。argv 內部字串,**解析結束前有效**,需長期保存請 strdup(optarg)。getopt_long() + struct option 陣列,映射到短選項值統一處理。optind = 1; optarg = NULL; (非標準,部分實現支援) 可再次解析,建議設計避免重複解析。getopt() 是 C/C++ 命令列工具的**標準解析器**。掌握 optstring 語法、四大全域變數、返回值語義、getopt_long() 長選項擴展、opterr=0 自定義錯誤處理、optind 非選項參數分界,即可編寫健壯、符合 POSIX 慣例的命令列介面。現代專案亦可考慮 argparse (C++), CLI11, cxxopts 等更高階庫。