VC++ 前置處理器指令與巨集定義深度解析

經典應用：防止標頭檔重複包含

問題情境

headerfile.h 定義全域變數 int iglobal;，被 headerfile1.h 與 headerfile2.h 同時包含，implement.cpp 再包含這兩個檔案 → 編譯器重複編譯 headerfile.h → 變數重複定義錯誤。

傳統解法：Include Guard

#ifndef SMARTNOSE_2002_06_21_HEADERFILE_H
#define SMARTNOSE_2002_06_21_HEADERFILE_H

int iglobal;

#endif

命名建議：包含作者、檔名、建立時間等資訊，避免衝突並具備文檔價值。

現代解法：#pragma once

#pragma once

int iglobal;

• VC6 即支援，VC.NET 後廣泛採用
• 編譯器保證檔案僅被編譯一次
• 無需手動維護唯一巨集名稱
• 跨平台相容性略低 (GCC/Clang 早期版本不支援)，現代編譯器皆已支援

原始碼版本控制：跨平台編譯

同一原始碼支援 Windows/Linux 不同 API：

void AllocateMemory() {
#ifdef _WINDOWS_PLATFORM
    HeapAlloc(GetProcessHeap(), 0, 1024);  // Windows API
#else
    malloc(1024);                           // 標準 C
#endif
}

編譯時定義 _WINDOWS_PLATFORM 即可切換實作。MFC 專案常見 #ifdef _DEBUG 區隔除錯程式碼。

#pragma 指令進階應用

#pragma message - 編譯期訊息輸出

#pragma message("正在編譯模組: " __FILE__)

編譯輸出視窗顯示自訂訊息，適用：

• 確認巨集是否定義：#ifdef _X86 #pragma message("_X86 已啟用") #endif
• 標記待辦事項：#pragma message("TODO: 優化演算法")
• 版本資訊嵌入

#pragma code_seg - 程式碼區段控制

#pragma code_seg("MY_SECTION")
void MyFunction() { ... }
#pragma code_seg()

指定函數編譯至特定程式碼區段，驅動程式開發常用。

#pragma comment - 連結器指示

#pragma comment(lib, "ws2_32.lib")  // 自動連結 Winsock 庫
#pragma comment(linker, "/subsystem:windows /entry:WinMainCRTStartup")

VC 預定義巨集

自訂斷言巨集

#define MyAssert(x) \
    if (!(x)) \
        MessageBox(NULL, __FILE__, __LINE__, MB_OK);

無法使用 MFC ASSERT 的專案 (如主控台程式、DLL) 可用此替代，彈出對話框顯示錯誤檔案與行號。

巨集定義最佳實務

1. 全大寫命名：區分巨集與變數/函數
2. 參數加括號：#define SQR(x) ((x)*(x)) 避免運算子優先級問題
3. 多行巨集用 do-while(0)：#define MACRO() do { ... } while(0) 確保語句行為
4. 避免副作用：參數勿含 ++/--/函數呼叫
5. 善用 #undef：避免污染後續編譯單元
6. 文件化巨集用途：註解說明目的、參數、副作用

結語

翻閱 MFC、Linux 核心原始碼，巨集佔據半壁江山：訊息對應、佇列操作、平台移植、版本管理、核心模組載入卸載。精通巨集是掌握 C/C++ 進階開發的關鍵鑰匙。