可變參數宏

可變參數宏是C語言與C++語言的函數宏的參數個數可以是0個或多個。這一語言特性由C99引入。C++11也開始支持。^[1]

「可變參數宏」的各地常用名稱
中國大陸	可變參數宏
臺灣	可變參數巨集

聲明語法

聲明語法類似於可變參數函數：逗號後面三個句點"..."，表示一個或多個參數。但常見編譯器也允許傳遞0個參數。^[2][3]宏擴展時使用特殊標識符__VA_ARGS__表示所傳遞的參數的替換。

沒辦法訪問可變參數列表內的單個參數，也不能獲知多少個參數被傳遞。^[4]

實現支持

C/C++編譯器支持：

• GNU Compiler Collection 3.0,^[2]
• Clang ,^[5]
• Visual Studio 2005,^[3]
• C++Builder 2006,
• Oracle Solaris Studio (Sun Studio) Forte Developer 6 update 2 (C++ version 5.3).^[6]

尾部逗號

對於可變參數為空情形，Visual Studio^[3]直接去掉可變參數前面的逗號；GCC^[2]需要在__VA_ARGS__前面放上##以去除逗號。

# define MYLOG(FormatLiteral, ...)  fprintf (stderr, "%s(%d): " FormatLiteral "\n", __FILE__, __LINE__, __VA_ARGS__)

對於

MYLOG("Too many balloons %u", 42);

擴展為：

fprintf (stderr, "%s(%u): " "Too many balloons %u" "\n", __FILE__, __LINE__, 42);

它等價於：

fprintf (stderr, "%s(%u): Too many balloons %u\n", __FILE__, __LINE__, 42);

但對於例子：

MYLOG("Attention!");

擴展為

fprintf (stderr, "%s(%u): " "Attention!" "\n", __FILE__, __LINE__, );

GCC將會編譯報錯.

GCC支持下述不可移植的擴展:

# define MYLOG(FormatLiteral, ...)  fprintf (stderr, "%s(%u): " FormatLiteral "\n", __FILE__, __LINE__, ##__VA_ARGS__)

這將刪除空的__VA_ARGS__尾部逗號。

參見

• 可變參數函數