C++ Builder 中輕鬆獲取命令列參數完整指南

在傳統的 C 語言 DOS 程式設計中，開發者習慣透過 main(int argc, char *argv[]) 來接收命令列參數，其中 argc 為參數個數，argv[0] 為程式完整路徑，其餘為實際參數。但轉入 Windows 視窗程式開發後，入口點變為 WinMain，其參數 lpszCmdLine 僅為一長串完整命令列字串，解析極為不便。若您使用 C++ Builder，則可大鬆一口氣——它內建三個全域工具，讓命令列參數處理變得異常簡單。

核心三大工具介紹

C++ Builder 在 System.hpp 中宣告了以下全域變數與函式：

extern PACKAGE char *CmdLine;
extern PACKAGE AnsiString __fastcall ParamStr(int Index);
extern PACKAGE int __fastcall ParamCount(void);

• CmdLine：相當於 WinMain 的 lpszCmdLine，為完整命令列字串（含程式路徑）。
• ParamCount()：傳回實際參數個數（不含程式名稱），對應 DOS 下的 argc - 1。
• ParamStr(Index)：取得指定索引的參數字串。ParamStr(0) 為程式完整路徑，實際參數從 ParamStr(1) 到 ParamStr(ParamCount())。

實作範例：視窗化參數顯示器

以下示範如何在表單建立時自動列出所有參數：

1. 在表單放置一個 Label（顯示完整命令列）與一個 ListBox（逐行列出參數）。
2. 在表單的 OnCreate 事件撰寫：

void __fastcall TForm1::FormCreate(TObject *Sender)
{
    Label1->Caption = CmdLine;                 // 顯示完整命令列
    for (int i = 0; i <= ParamCount(); ++i)    // 0 為程式路徑，1..n 為參數
        ListBox1->Items->Add(ParamStr(i));
}

3. 選單 Run → Parameters… 輸入測試參數（如 arg1 "second arg" 3），執行程式即可看到結果。

進階應用提示

• 參數字串若含空白，請在 IDE 參數設定或捷徑屬性中用雙引號括住。
• 搭配 Trim() 或 ParamStr(i).Trim() 可移除前後空白。
• 若需跨平台相容，可自行封裝為 std::vector<AnsiString> 供標準 C++ 邏輯使用。

善用這三個工具，即可在 C++ Builder 中像 DOS 時代一樣輕鬆處理命令列參數，大幅簡化視窗程式的啟動邏輯。