#ifndef、 #define、 #endif 是配合使用的。这些条件编译指令用于确保头文件只被包含一次,以避免重复定义。例如:
#ifndef xxx_H
#define xxx_H
// 这里放头文件的内容
#endif //xxx_H
在这段代码中,#ifndef xxx_H 检查是否没有定义 xxx_H,如果没有定义,那么就执行 #define xxx_H 定义它。然后,在头文件的内容之后,#endif //xxx_H 表示条件编译块的结束。
这种做法确保了在同一个编译单元中(一个源文件)头文件只会被包含一次,防止重复定义问题的发生。这在大型项目中特别有用,可以避免多次包含同一个头文件而导致的编译错误。
三者的关系
#ifndef xxx_H、#endif //xxx_H 和 #define xxx_H 三者之间是一种条件编译的结构,用于确保头文件只被编译一次,避免重复定义和编译错误。
-
#ifndef xxx_H:这是条件编译的开始,意思是“如果 xxx_H 还没有被定义”(通常 xxx_H 是头文件的名称,用大写字母和下划线表示),则执行下面的代码块。这样就防止了头文件的内容被多次编译。
-
#define xxx_H:如果进入了条件编译块,这一行会定义 xxx_H 这个标识符。这就表示这个头文件已经被包含过了,以后在其他地方再包含这个头文件时,编译器就会跳过它的内容。
-
#endif //xxx_H:条件编译块的结束,标志着这个头文件的内容结束。这个指令的注释 //xxx_H 只是为了说明这个 endif 是和开始的 ifndef 配对的,保持代码的清晰。
如果没有 #define xxx_H,则条件编译块的功能就会失效,头文件的内容可能会被多次编译。这样会引发重复定义的错误,导致编译失败。也就是说,如果没有这个定义,那么多次包含同一个头文件时,其中的内容会被多次插入到源文件中,造成重复编译,这是编译器不希望看到的。
因此,#define xxx_H 的作用在于定义一个标识符,用来标记这个头文件已经被包含过,避免重复编译。