#define directive

预处理器支持文本宏替换和类似功能的文本宏替换。

句法

说明

#define 指令

#define指令定义的标识符作为一个宏，即它们指示编译器替换替换列表标识符的所有连续出现，其可以额外地任选地进行处理。如果标识符已经被定义为任何类型的宏，那么该程序是格式不正确的，除非定义相同。

类似于对象的宏

类似于对象的宏将每个定义的标识符替换为替换列表。#define指令的版本（1）的行为完全如此。

函数式的宏

类似功能的宏将替换列表中的每个出现的已定义标识符替换为另外的一些参数，然后替换替换列表中任何参数的相应出现。

函数式宏调用的语法类似于函数调用的语法：宏名称的每个实例后跟一个（作为下一个预处理标记引入由替换列表替换的标记序列）序列由匹配）令牌终止，跳过中间匹配的左右括号对。

参数的数量必须与宏定义（参数）中参数的数量相同或程序不合格。如果标识符不是功能符号，也就是说本身没有括号，它根本不会被替换。

#define指令的版本（2）定义了一个简单的函数式宏。

#define指令的版本（3）定义了一个具有可变数量参数的函数式宏。可以使用__VA_ARGS__标识符访问附加参数，然后使用标识符来替换标识符，然后使用标识符替换它们。

#define指令的版本（4）定义了一个类似函数的宏，其中包含可变数量的参数，但没有常规参数。只能使用__VA_ARGS__标识符访问参数，然后使用标识符替换标识符，并将标识符替换。

注意：如果类似函数的宏的参数包含未被左右括号（如macro(array[x = y, x + 1])）的匹配对保护的逗号，则逗号将被解释为宏参数分隔符，导致由于参数计数不匹配导致的编译失败。

# and ## operators

在函数式宏中，#替换列表中的标识符之前的运算符通过参数替换运行标识符，并将结果封装在引号中，从而有效地创建字符串文字。另外，预处理器会添加反斜杠以避免嵌入的字符串文字（如果有的话）引用，并在必要时将字符串中的反斜杠加倍。所有前导空白和尾随空白都被删除，并且文本中间的任何空白序列（但不在嵌入的字符串文字内）被折叠为单个空格。这个操作被称为“串化”。如果字符串化的结果不是有效的字符串，则行为是未定义的。

##在替换列表中的任何两个连续标识符之间的运算符运行两个标识符上的参数替换，然后连接结果。这个操作被称为“连接”或“令牌粘贴”。只有形成一个有效令牌的令牌可以被粘贴：形成一个更长的标识符的标识符，形成一个数字的数字，或运算符，+并=形成一个+=。评论不能通过粘贴来创建，/并且*因为在考虑宏替换之前从文本中删除评论。如果连接的结果不是有效的标记，则行为是未定义的。

注意：有些编译器提供了一个允许##出现在逗号之后和__VA_ARGS__之前的扩展，在这种情况下，当__VA_ARGS__非空时，##什么也不做，但当__VA_ARGS__为空时删除逗号：这使得可以定义宏等fprintf (stderr, format, ##__VA_ARGS__)。

#undef directive

#undef指令取消定义标识符，即它通过#define指令取消标识符的先前定义。如果标识符没有关联的宏，则该指令被忽略。

预定义的宏

任何翻译单元中都预先定义了以下宏名称：

• 199409L (C95)
• 199901L (C99)
• 201112L (C11) (macro constant)

 \_\_STDC\_HOSTED\_\_

(C99)

1如果实施托管（在 OS 下运行），​0​则 扩展为整数常量，如果是独立的（无 OS 的情况下运行）

(macro constant) __FILE__

扩展为当前文件的名称，作为字符串文字，可以通过#line 指令进行更改

(macro constant) __LINE__

展开为源文件行号，一个整数常量，可以通过#line 指令进行更改

(macro constant) __DATE__

扩展到翻译日期，形式为 “Mmm dd yyyy” 的字符串文字。月份的名称如同生成的一样，如果asctime月份的日期小于10，则“dd”的第一个字符是空格

(macro constant) __TIME__

扩展到翻译时，形式为 “hh：mm：ss” 形式的字符串文字，如在 asctime()

(macro constant)

以下附加宏名称可能由实现预定义：

这些宏的值（除了__FILE__和__LINE__）在整个翻译单元中保持不变。尝试重新定义或取消定义这些宏会导致未定义的行为。

例

#include <stdio.h>
 
//make function factory and use it
#define FUNCTION(name, a) int fun_##name(int x) { return (a)*x;}
 
FUNCTION(quadruple, 4)
FUNCTION(double, 2)
 
#undef FUNCTION
#define FUNCTION 34
#define OUTPUT(a) puts( #a )
 
int main(void)
{
    printf("quadruple(13): %d\n", fun_quadruple(13) );
    printf("double(21): %d\n", fun_double(21) );
    printf("%d\n", FUNCTION);
    OUTPUT(million);               //note the lack of quotes
}

输出：

quadruple(13): 52
double(21): 42
34
million

参考

• C11标准（ISO / IEC 9899：2011）：
  • 6.10.3宏替换（p：166-173）
  • 6.10.8预定义的宏名称（p：175-176）
• C99标准（ISO / IEC 9899：1999）：
  • 6.10.3宏替换（p：151-158）
  • 6.10.8预定义的宏名称（p：160-161）
• C89 / C90 标准（ISO / IEC 9899：1990）：
  • 3.8.3宏替换
  • 3.8.8预定义的宏名称