C/C++预处理指令

预处理指令 Preprocessor Directives

define
undef
ifdef ifndef if endif else and elif
line
error
include
预定义标识符
pragma

预处理指令 (Preprocessor Directives)

预处理指令是我们写在程序代码中的给预处理器(preprocessor)的命令，而不是程序本身的语句。预处理器在我们编译一个C++程序时由编译器自动执行，它负责控制对程序代码的第一次验证和消化。

所有这些指令必须写在单独的一行中，它们不需要加结尾的(;)分号。

#define

在这个教程的开头我们已经提到了一种预处理指令： #define ，可以被用来生成宏定义常量(defined constantants 或 macros)，它的形式是：

#define name value

它的作用是定义一个叫做name 的宏定义，然后每当在程序中遇到这个名字的时候，它就会被value代替，例如：

#define MAX_WIDTH 100
char str1[MAX_WIDTH];
char str2[MAX_WIDTH];

它定义了两个最多可以存储100个字符的字符串。

#define 也可以被用来定义宏函数：

#define getmax(a,b) ((a)>(b)?(a):(b))
int x=5, y;
y = getmax(x,2);

这段代码执行后y 的值为5 。

#undef

#undef 完成与 #define相反的工作，它取消对传入的参数的宏定义：

#define MAX_WIDTH 100
char str1[MAX_WIDTH];
#undef MAX_WIDTH
如果在这段代码之后,使用MAX_WIDTH编译器就会报错。

#ifdef, #ifndef, #if, #endif, #else and #elif

这些指令可以使程序的一部分在某种条件下被忽略。

#ifdef 可以使一段程序只有在某个指定常量已经被定义了的情况下才被编译，无论被定义的值是什么。它的操作是：

#ifdef name
// code here
#endif

例如：

#ifdef MAX_WIDTH
char str[MAX_WIDTH];
#endif

在这个例子中，语句char str[MAX_WIDTH]; 只有在宏定义常量MAX_WIDTH 已经被定义的情况下才被编译器考虑，不管它的值是什么。如果它还没有被定义，这一行代码则不会被包括在程序中。

#ifndef 起相反的作用：在指令#ifndef 和 #endif 之间的代码只有在某个常量没有被定义的情况下才被编译，例如：

#ifndef MAX_WIDTH
#define MAX_WIDTH 100
#endif
char str[MAX_WIDTH];

这个例子中，如果当处理到这段代码的时候MAX_WIDTH 还没有被定义，则它会被定义为值100。而如果它已经被定义了，那么它会保持原值 (因为#define 语句这一行不会被执行) 。

指令#if, #else 和 #elif (elif = else if) 用来使得其后面所跟的程序部分只有在特定条件下才被编译。这些条件只能够是常量表达式，例如：

const int VALUE_JUDGE = 150;

#if VALUE_JUDGE >200
#define MAX_WIDTH 200

#elif VALUE_JUDGE <50
#define MAX_WIDTH 50

#else
#define MAX_WIDTH 100
#endif

char str[MAX_WIDTH];

注意看这一连串的指令 #if, #elif 和 #else 是怎样以 #endif 结尾的。

#line

当我们编译一段程序的时候，如果有错误发生，编译器会在错误前面显示出错文件的名称以及文件中的第几行发生的错误。

指令#line 可以使我们对这两点进行控制，也就是说当出错时显示文件中的行数以及我们希望显示的文件名。它的格式是：

#line number "filename"

这里number 是将会赋给下一行的新行数。它后面的行数从这一点逐个递增。

filename 是一个可选参数，用来替换自此行以后出错时显示的文件名，直到有另外一个#line指令替换它或直到文件的末尾。例如：

#line 1 "assigning variable"
int a?;

这段代码将会产生一个错误，显示为在文件"assigning variable", line 1 。

#error

这个指令将中断编译过程并返回一个参数中定义的出错信息，例如：

#ifndef __cplusplus
#error A C++ compiler is required
#endif

这个例子中如果 __cplusplus 没有被定义就会中断编译过程。

#include

这个指令我们已经见到很多次。当预处理器找到一个#include 指令时，它用指定文件的全部内容替换这条语句。声明包含一个文件有两种方式：

#include "file"
#include <file>

两种表达的唯一区别是编译器应该在什么路经下寻找指定的文件。第一种情况下，文件名被写在双引号中，编译器首先在包含这条指令的文件所在的目录下进行寻找，如果找不到指定文件，编译器再到被配置的默认路径下（也就是标准头文件路径下）进行寻找。

如果文件名是在尖括号 <> 中，编译器会直接到默认标准头文件路径下寻找。

预定义标识符

为了处理一些有用的信息，预处理定义了一些预处理标识符，虽然各种编译器的预处理标识符不尽相同，但是他们都会处理下面的4种：

__FILE__ 正在编译的文件的名字

__LINE__ 正在编译的文件的行号

__DATE__ 编译时刻的日期字符串，例如： "25 Dec 2000"

__TIME__ 编译时刻的时间字符串，例如： "12：30：55"

例如：cout<<"The file is ："<<__FILE__"<<"！ The lines is："<<__LINE__<<endl；

#pragma

这个指令是用来对编译器进行配置的，针对你所使用的平台和编译器而有所不同。要了解更多信息，请参考你的编译器手册。