#ifndef 在头文件中的作用

在一个大的软件工程里面,可能会有多个文件同时包含一个头文件,当这些文件编译链接成一个可执行文件时

,就会出现大量“重定义”的错误。在头文件中实用#ifndef #define #endif能避免头文件的重定义。

方法:例如要编写头文件test.h

在头文件开头写上两行:

#ifndef _TEST_H

#define _TEST_H//一般是文件名的大写

头文件结尾写上一行:

#endif

这样一个工程文件里同时包含两个test.h时,就不会出现重定义的错误了。

分析:当第一次包含test.h时,由于没有定义_TEST_H,条件为真,这样就会包含(执行)#ifndef _TEST_H和

#endif之间的代码,当第二次包含test.h时前面一次已经定义了_TEST_H,条件为假,#ifndef _TEST_H和

#endif之间的代码也就不会再次被包含,这样就避免了重定义了。

#ifndef __74HC595_H__
#define __74HC595_H__



#endif

#ifndef _optimizedvector_h // if not define _optimizedvector_h
#define _optimizedvector_h // then define _optimizedvector_h

通俗点就是如果没定义_optimizedvector_h,那就定义_optimizedvector_h,防止重复编译

头文件中的#ifndef,这是一个很关键的东西。比如你有两个C文件,这两个C文件都include了同一个头文件。而编

译时,这两个C文件要一同编译成一个可运行文件,于是问题来了,大量的声明冲突。

还是把头文件的内容都放在#ifndef和#endif中吧。不管你的头文件会不会被多个文件引用,你都要加上这个。一般

格式是这样的:


#ifndef <标识> 
#define <标识> 
...... 
#endif


<标识>在理论上来说可以是自由命名的,但每个头文件的这个“标识”都应该是唯一的。标识的命名规则一般是头

文件名全大写,前后加下划线,并把文件名中的“.”也变成下划线,

如:stdio.h 
#ifndef _STDIO_H_ 
#define _STDIO_H_ 
...... 
#endif 
2.在#ifndef中定义变量出现的问题(一般不定义在#ifndef中)。
#ifndef AAA
#define AAA
...
int i;
...
#endif
里面有一个变量定义
在vc中链接时就出现了i重复定义的错误,而在c中成功编译。

结论:
(1).当你第一个使用这个头的.cpp文件生成.obj的时候,int 在里面定义了当另外一个使用这个的.cpp再次[单独

]生成.obj的时候,int 又被定义然后两个obj被另外一个.cpp也include 这个头的,连接在一起,就会出现重复

定义.
(2).把源程序文件扩展名改成.c后,VC按照C语言的语法对源程序进行编译,而不是C++。在C语言中,若是遇到多个

int i,则自动认为其中一个是定义,其他的是声明。
(3).C语言和C++语言连接结果不同,可能(猜测)时在进行编译的时候,C++语言将全局变量默认为强符号,所以连

接出错。C语言则依照是否初始化进行强弱的判断的。(参考)
解决方法:
(1).把源程序文件扩展名改成.c。
(2).推荐解决方案:
.h中只声明 extern int i;在.cpp中定义
<x.h>
#ifndef __X_H__
#define __X_H__
extern int i;
#endif //__X_H__
x.c>
int i;


注意问题:
(1).变量一般不要定义在.h文件中。
一般情况下,源程序中所有的行都参加编译。但是有时希望对其中一部分内容只在满足一定条件才进行编译,也就

是对一部分内容指定编译的条件,这就是“条件编译”。有时,希望当满足某条件时对一组语句进行编译,而当条

件不满足时则编译另一组语句。 
条件编译命令最常见的形式为:
#ifdef 标识符 
程序段1 
#else 
程序段2
#endif

它的作用是:当标识符已经被定义过(一般是用#define命令定义),则对程序段1进行编译,否则编译程序段2。其中

#else部分也可以没有,即:

#ifdef 
程序段1 
#denif

这里的“程序段”可以是语句组,也可以是命令行。这种条件编译可以提高C源程序的通用性。如果一个C源程序在

不同计算机系统上系统上运行,而不同的计算机又有一定的差异。例如,我们有一个数据类型,在Windows平台中,

应该使用long类型表示,而在其他平台应该使用float表示,这样往往需要对源程序作必要的修改,这就降低了程序

的通用性。可以用以下的条件编译:

#ifdef WINDOWS 
#define MYTYPE long 
#else 
#define MYTYPE float 
#endif 

如果在Windows上编译程序,则可以在程序的开始加上 
#define WINDOWS

这样则编译下面的命令行:

#define MYTYPE long

如果在这组条件编译命令之前曾出现以下命令行: #define WINDOWS 

则预编译后程序中的MYTYPE都用float代替。这样,源程序可以不必作任何修改就可以用于不同类型的计算机系统。

当然以上介绍的只是一种简单的情况,可以根据此思路

?a href="javascript:;" onClick="tagshow(event, '����');return false;">其它的条件编译?

例如,在调试程序时,常常希望输出一些所需的信息,而在调试完成后不再输出这些信息。可以在源程序中插入以

下的条件编译段:

#ifdef DEBUG 
print ("device_open(%p) ", file); 
#endif

如果在它的前面有以下命令行: #define DEBUG

则在程序运行时输出file指针的值,以便调试分析。调试完成后只需将这个define命令行删除即可。有人可能

觉得不用条件编译也可达此目的,即在调试时加一批printf语句,调试后一一将printf语句删除去。的确,这是可

以的。但是,当调试时加的printf语句比较多时,修改的工作量是很大的。用条件编译,则不必一一删改printf语

句,只需删除前面的一条“#define DEBUG”命令即可,这时所有的用DEBUG作标识符的条件编译段都使其中的

printf语句不起作用,即起统一控制的作用,如同一个“开关”一样。

有时也采用下面的形式: 
#ifndef 标识符 
程序段1 
#else 
程序段2 
#endif 

只是第一行与第一种形式不同:将“ifdef”改为“ifndef”。它的作用是:若标识符未被定义则编译程序段1

,否则编译程序段2。这种形式与第一种形式的作用相反。


以上两种形式用法差不多,根据需要任选一种,视方便而定。 
还有一种形式,就是#if后面的是一个表达式,而不是一个简单的标识符:

#if 表达式 
程序段1 
#else 
程序段2 
#endif 

它的作用是:当指定的表达式值为真(非零)时就编译程序段1,否则编译程序段2。可以事先给定一定条件,

使程序在不同的条件下执行不同的功能。
作用范围就是当前文件啊。因为编译是以cpp或c文件位单位的嘛。还以这个为例:

//正常代码 
#ifdef _DEBUG
TRACE("Some infomation"); 
#else 
//Now is release version,so do nothing
#endif 
//正常代码

编译时是先把所有的预编译处理展开(比如宏)再编译,所以Debug模式下,编译时的代码是: 
//正常代码 
TRACE("Some infomation");
//正常代码
Release模式下的代码是: 
//正常代码 
//正常代码

<think>好的,我现在需要回答用户关于C/C++中#ifndef头文件中的用法的问题。首先,我得回顾一下自己之前学过的相关知识,确保理解正确。 用户提到了几个引用内容,其中引用[2]、[4]和[5]都直接涉及#ifndef的用法。根据这些引用,头文件保护机制主要是为了防止重复包含同一个头文件,避免编译错误。比如,当多个源文件包含同一个头文件,或者头文件之间互相包含时,可能会导致头文件的内容被多次定义,从而引发重定义错误。 接下来,我需要解释#ifndef作用机制。通常,头文件保护使用预处理器指令,格式是#ifndef后跟一个唯一的标识符,如果该标识符未被定义,则定义它,并包含头文件的内容,直到#endif结束。这样,在第一次包含头文件时,标识符未被定义,所以预处理器会处理其中的内容;后续再次包含时,因为标识符已经定义过,所以内容会被跳过。 用户可能还关心具体的写法。例如,引用[3]中的头文件A.h使用了#pragma once,但用户的问题是关于#ifndef的,所以需要强调传统的#ifndef方式。引用[5]提到不管头文件是否被多次引用,都应该上这种保护,这是一种良好的编程习惯。 然后,我需要举一个例子,比如常见的写法: #ifndef MYHEADER_H #define MYHEADER_H // 头文件内容 #endif 这里的MYHEADER_H需要唯一,通常用文件名的大写和下划线代替点,比如MY_HEADER_H。同时要提醒用户不要与现有标识符冲突,避免使用常见的关键词。 另外,可能需要比较#ifndef和#pragma once的区别。虽然两者都能防止重复包含,但#pragma once是编译器特定的,可能不被所有编译器支持,而#ifndef是标准方法,兼容性更好。 用户的问题还可能涉及到实际应用中的注意事项,比如确保每个头文件都有唯一的标识符,否则保护机制可能失效。比如,如果两个不同的头文件使用了相同的标识符,其中一个可能被错误地排除,导致编译错误或遗漏内容。 最后,生成相关问题时要围绕头文件保护机制,可能涉及其他预处理器指令、最佳实践、常见错误等。例如,如何选择标识符,头文件保护与#pragma once的优缺点比较,或者如何处理嵌套包含的情况。 需要确保回答结构清晰,分点说明,并且符合用户提供的格式要求,比如行内公式用$...$,代码块用正确语法,引用正确的引用标记。同时,生成的三个问题要相关且有深度,帮助用户进一步学习。</think>### C/C++头文件中的`#ifndef`保护机制详解 #### 1. `#ifndef`的作用 `#ifndef`(即 *if not defined*)是C/C++中的**预处理指令**,主要用于防止头文件被多次包含(重复包含)。当多个源文件或嵌套包含同一头文件时,可能导致**重复定义错误**(如变量、函数、类等)。`#ifndef`通过条件编译,确保头文件内容仅被编译一次[^2][^4]。 #### 2. 基本语法 典型的头文件保护格式如下: ```cpp #ifndef UNIQUE_IDENTIFIER // 检查是否未定义唯一标识符 #define UNIQUE_IDENTIFIER // 定义该标识符 // 头文件内容(函数声明、类定义等) #endif // 结束条件编译 ``` - **唯一标识符命名规则**:通常以头文件名的大写形式命名,例如`MY_HEADER_H`(对应`my_header.h`)[^5]。 - **作用范围**:`#ifndef`和`#endif`之间的内容仅在首次包含时生效。 #### 3. 示例说明 假设头文件`utils.h`: ```cpp #ifndef UTILS_H #define UTILS_H int add(int a, int b); #endif ``` - 第一次包含`utils.h`时,`UTILS_H`未定义,代码被编译。 - 后续包含时,`UTILS_H`已定义,跳过代码块,避免重复编译。 #### 4. 与`#pragma once`的对比 - **`#ifndef`**:标准化方法,兼容所有编译器,但需手动确保标识符唯一性。 - **`#pragma once`**:编译器扩展(如GCC、MSVC),依赖文件路径自动去重,但可移植性稍差[^3]。 - **最佳实践**:大型项目可结合两者以增强可靠性: ```cpp #pragma once #ifndef UTILS_H #define UTILS_H // 内容 #endif ``` #### 5. 常见错误 - **标识符冲突**:不同头文件使用相同的标识符(如`HEADER_H`),导致保护失效。 - **遗漏`#endif`**:条件编译未正确闭合,引发语法错误。 - **嵌套包含问题**:若头文件A包含B,B又包含A,需确保两者均有保护机制。 #### 6. 最佳实践 1. **强制使用头文件保护**:即使当前无重复包含风险,未来扩展时可能产生问题[^5]。 2. **命名规范化**:使用项目前缀或路径信息(如`PROJECT_MODULE_UTILS_H`)。 3. **结合现代工具**:IDE和构建系统(如CMake)可辅助管理头文件依赖。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值