Delphi 參數修飾字 out、var 差異與使用場景

快速對照

核心差異：var vs out

procedure TestVar(var X: Integer);  // 呼叫端 X 需有初始值
begin
  ShowMessage(IntToStr(X)); // 可讀取初始值
  X := 20;
end;

procedure TestOut(out X: Integer);  // 呼叫端 X 無需初始化
begin
  // ShowMessage(IntToStr(X)); // 錯誤：out 參數進入時值未定義
  X := 20; // 必須指派值
end;

使用場景

• var：需**讀取舊值並更新** (如 Swap、TryParse 模式需回傳多值)。
• out：僅**回傳結果**，呼叫端不關心舊值 (如 GetUser(out Name, out Age)、COM 介面方法)。
• const：大型 record、array、interface 輸入，**效能優化** (避免複製)，語意明確不可變。

編譯器強制規則

1. out 參數在程序內**必須被指派值** (所有路徑)，否則編譯警告/錯誤。
2. out 參數**不可在指派前讀取**。
3. var 參數呼叫端**必須是變數**，不可為常數/運算式。

COM/Windows API 互通

Windows API (如 GetWindowRect) 多用 out 對應 LPRECT (輸出緩衝區)。Delphi 導入標頭檔時自動映射為 out 或 var。

最佳實務

• **輸入參數優先用 const** (大型類型) 或 value (簡單類型)。
• **需修改呼叫端變數用 var**。
• **純輸出用 out**，語意最清晰，編譯器協助檢查未指派路徑。
• 避免濫用 var 當輸出專用，降低可讀性。

掌握 var (輸入輸出) 與 out (純輸出) 語意差異，能寫出更安全、自文檔化的 Delphi 程式碼。