关于头文件重复包含以及函数重定义问题

最新推荐文章于 2023-03-06 21:23:48 发布
转载 最新推荐文章于 2023-03-06 21:23:48 发布 · 717 阅读 · 0

本文探讨了C/C++编程中头文件重复包含及函数重定义的问题，解释了为何即使使用预处理指令仍会出现重复定义错误，并提出了正确的头文件与源文件分离的设计方案。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

  关于头文件重复包含以及函数重定义问题  2011-03-15 10:31:21

分类： C/C++

调试的问题出现这个问题还蛮奇怪的，a.h需包含statistic.h， main.c需包含a.h和statistic.h，导致了statistic.h重复包含，hsdm_queue_ctr重复定义。
 
关于重复包含和重复定义的问题，可根据下面的分析得到认识。
 
为什么用了宏名字定义检测头文件的重复包含可还是有重复定义的错误?

我在一个头文件中定义了一个函数F, 整个头文件用:
#ifndef _XXX
#define _XXX
...
#endif
括起来以避免重复包含. 然后有两个Cpp文件都包含了这个头文件. 编译无错,链接时却显示函数F被重复定义了(在其它文件中均没有重复定义这个F). 我把其中那个报错的Cpp文件里关于这个头文件的所有内容(对它的包含,对其中函数的调用)都注释掉以后编译, 再把注释去掉重新编译链接,就又无错了.   这到底是什么道理? 该怎样使它不被重复定义?
 回复内容
【todototry】:
在一个头文件中定义了一个函数F
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
把它放在cpp文件

【todototry】:
你放在头文件，对于使用文件而言确实未重复包含
但对整个工程而言，每个使用这个头文件的cpp文件编译生成的obj文件中均编译出了这个函数的实体，这样整个工程链接的时候，报信息

【todototry】:
所以
//name.h文件
#ifndef NAME_H
#define NAME_H

函数声明

#endif

//name.cpp文件

函数定义



【chenqiu1024】:
有点明白了. 可还不太明白, 我可能是还不懂编译器实际处理的方式:
1.  #ifndef...#define...#endif这种方式是不是仅对一个CPP文件有用,就是说可以避免一个CPP文件已经#include了一个头文件,但又#include了另一个已经#include这个头文件的头文件?
2.  为什么用了这种方法,在头文件中定义的结构体或变量不会被认为重复定义,只有函数会报错呢? //此处有误，事实上变量的的定义会出错，而声明不会出错。

【akirya】:
重复包含是编译期间的
#ifndef...#define...#endif这个只能解决重复包含,但无法解决重复定义的
重复定义是链接期间的

【chenqiu1024】:
那是不是说, 为避免重复定义, 结构体的定义和静态数据的定义也不能放在头文件里?

【ReachZh】:
加上#pragma once 试试看

【todototry】:
结构体的定义和静态数据的定义也不能放在头文件里?
================================================
这个你这么理解即可：
你办定义可以呢看成两种：类型定义，数据定义
类型定义不分配内存的，比如类的定义，结构体的定义，它是定义一个数据类型而已
数据定义分配内存，比如类对象定义，变量定义
一个原则：
不分配内存的，放在头文件
分配内存的放在cpp文件，放置重复定义
综上所述，你就可以知道结构体的定义属于类型定义放在头文件，静态数据的定义属于数据定义放在cpp文件
对于函数相同，函数声明你可以看作类型定义，函数实现看作数据定义

【chenqiu1024】:
嗯,二位这么一说我看很清楚了, 多谢多谢

【jixingzhong】:
两个cpp文件：

A.cpp: include  //定义了函数F
B.cpp: include  //定义了函数F

重复定义。

因为两个 cpp 是相对独立的，
A 包含 h 文件和 B 包含h文件没有关系，
也就是 #ifndef...#define...#endi 并没有起到效果 ...

如果是 A 包含B， B包含了 h ， 那么可能会起到效果...

【jixingzhong】:
一般 h 中都是声明，不是定义， 包括数据类型的声明以及函数原型的声明。

对于函数，
然后使用一个对应名字的 .cpp 文件完成函数的定义，
然后将这个 .cpp 添加到当前工程。
在其他文件调用这个函数时候，
include h 文件而不是 cpp 文件就可以了，
这样就不会重复定义了 ...
XU_CALLME
关注
C 语言中防止头文件重复包含的机制
m0_62599305的博客
03-20 926
例如，假设有一个函数声明在头文件中，并且该头文件在多个源文件中都被包含。如果没有防止重复包含的机制，就会出现重复定义错误。void foo();// 函数声明如果没有防止重复包含，编译器会认为foo被多次定义，导致链接错误。使用#ifndef#define和#endif：这种方法是标准的 C 语言做法，可以有效避免头文件重复包含，广泛适用于不同的编译器和平台。使用：这种方法语法简洁，适用于大多数现代编译器，但它是编译器特有的扩展，可能不兼容某些旧版编译器。
c语言中常用函数头文件,c语言中常用的函数和头文件
weixin_28691003的博客
05-19 6221
头文件ctype.h函数列表函数类别函数目的详细说明字符测试为字符和数字的isalnum是否为isalpha字符是否控制字符iscntrl是否为数字isdigit是否能够显示文字(空格除外) isgraph是否可以显示字符(包括空格) isprint非空格或数字的可显示字符ispunct有无空间isspace是否大写isupper是否为十六进制(0-9，A-F )字符isxdigit转换字符大小...
转载 关于编译器的编译过程
weixin_30827565的博客
08-18 165
调试的问题出现这个问题还蛮奇怪的，a.h需包含statistic.h， main.c需包含a.h和statistic.h，导致了statistic.h重复包含，hsdm_queue_ctr重复定义。 关于重复包含和重复定义的问题，可根据下面的分析得到认识。 为什么用了宏名字定义检测头文件的重复包含可还是有重复定义的错误? 我在一个头文件中定...
Keil头文件重复定义的问题
物联网IOT
09-20 9582
提示 头文件已经包含，并且错误指向了我的头文件定义的地方，用sourceinsight搜多了一下，整个项目也只有在当前的》h文件中有定义，最后从代码的main函数开始分析，并且查看调用文件， 如图 在文件的开头已经包含了"app_console.h"，一般习惯是包含的多一点好，全面一点，不会报找不到的错误。在这个文件的后面，定了一个宏，如图：
keil中include 头文件循环引用问题
li707414287的博客
07-17 3720
在头文件中使用#ifdef和＃ifndef是非常重要的，可以防止双重定义的错误。 有时候，在b.h中会include "a.h"，在"c.h"中会include "b.h"及include"a.h"， 这时，如果不用ifndef/endif，就会包含两次a.h,产生错误。 还是把头文件的内容都放在#ifndef和#endif中吧。不管你的头文件会不会被多个文件引用，你都要加上这个...
头文件里面实现一个函数，在两个cpp中包含，则重复定义，如果加上inline则不会报错
dengm155的专栏
06-14 4275
为什么类的定义应当写在头文件中,从而被多个源文件包含？比如myclass.h定义了一个类myclass（只定义类，不定义成员函数）， file1.cpp里#include "myclass.h"，编译得到file1.obj； file2.cpp里也#include "myclass.h"，编译得到file2.obj； 那么把file1.obj和file2.obj（和运行库）连接起来生成可执行文件的
C ++ 函数在头文件中定义，结果编译时出现重定义
sinat_41686583的博客
02-23 1452
第一次定义 ，重定义
防止变量重复定义、头文件重复包含、嵌套包含
12-03
综上所述，防止变量重复定义、头文件重复包含以及处理嵌套包含是确保程序编译正确性和提高代码质量的关键步骤。开发者应充分理解这些概念，并在实践中合理运用各种技术手段来避免这些问题的发生。
143.防止头文件重复包含.pdf
01-24
为了解决头文件重复包含的问题，通常使用条件编译的技术。具体做法是在头文件的开始处添加预处理指令，这样头文件的内容只有在没有被包含过的情况下才会编译。这种方法主要有两种实现形式： 1. 使用#ifndef, #...
C++中关于包含函数原型声明的头文件与包含函数定义的函数文件以及主程序文件之间的执行逻辑和定义规范
07-03
首先，用户的问题是关于C++中头文件、源文件和主程序文件的执行逻辑和定义规范。我需要基于系统指令和提供的引用来回答。 系统指令关键点：-所有行内数学表达式用$...$，例如 $x^2$。 -独立公式用$$...$$。- LaTeX...
【转载】c++普通函数在头文件定义报重复定义的错误。而class定义不会
Antonic_的博客
04-07 579
为什么class C在header中定义了，并且在其他两个cpp中都include了，结果，链接时不会报重复定义的错误？
实用经验 58 防止重复包含头文件
一鸣惊人的博客
08-02 1047
头文件重复包含，是每个程序员都遇到过的问题。建议在每个头文件时采用“头文件卫士”加以保护。头文件卫士有两种形式一种是#progma once，一种是#ifndef。如果你的程序需要跨平台，建议你使用#ifndef方式。因为这种方式仅与C++语言有关。
防止C语言头文件被重复包含 — ifndef & #pragma once
Half-up的博客
03-06 3365
防止C语言头文件被重复包含 — ifndef & #pragma once
C++ 中头文件重复定义的问题
yangjinkui的博客
08-17 1553
一、同一头文件中类嵌套的疑问假设我们有两个类A和B，分别定义在各自的头文件A.h和B.h中，但是在A中要用到B，B中也要用到A，像下面的写法是错误的： class B;class A { public: B b; };class B { public: A a; }; 因为在A对象中要开辟一块属于B的空间，而B中又有
C++ 中枚举变量出现定义重复
wb175208的专栏
12-11 1万+
在使用C++的枚举过程中会出现枚举变量重复的情况，特别是这两个枚举的作用域相同的情况下，如：enum HOUSE { big, small }; enum COMPUTER { big, small };编译的时候，就会报错：错误 1 error C2365: “big”: 重定义；以前的定义是“枚举数” e
C语言中重复定义的问题
热门推荐
whealther的专栏
07-26 2万+
几个基本知识： 1、头文件
知识点滴 - 关于头文件的重复包含问题
guoqx的专栏
11-06 3593
对于函数声明来说，如果一个编译单元里出现多次相同的声明没有问题，但如果是一个编译单元里对同一个对象(变量)或类型有多个定义，或者是同一个作用域里有重复定义，比如全局空间有重复定义，就会编译报错。重复包含一个头文件，可能会导致编译错误，就算头文件中都是可以重复出现的声明之类的内容，多次包含的话，也会增加预处理器或编译器的工作量，增加软件构建的时间。在一个源文件中包含此头文件my_include.h时，会检查此宏定义是否定义，如果是第一次包含，没有定义，则下一步定义这个宏，并将后面的内容包含进来。
C++中出现error:Link2005重复定义的问题
qq_38815760的博客
04-04 772
在一个头文件中定义了一个二维数组，在cpp文件中对其进行赋值。出现重复定义的错误 问题原因：在头文件中只能进行变量的声明（int a），不能进行定义(int a=1) 。但是对于数组而言，在声明的时候会自动赋初值（个人理解），就相当于只能定义，所以会出现多重定义的错误。 解决办法：将数组定义在cpp文件中，如果想定义为全局变量，则在.h文件中加上extern （如在cpp文件中int a=1...
头文件中可以定义函数吗
最新发布
08-01
<think>我们正在讨论C/C++头文件中是否允许定义函数。 根据引用[2]中的例子，在头文件中直接定义函数（非内联函数）会导致多个源文件包含该头文件时出现重复定义的链接错误。 但是，C++中允许在头文件中定义内联函数（inline）和模板函数，因为它们在每个编译单元中单独定义，链接时不会冲突。 此外，C99标准也支持内联函数，所以在C语言中也可以使用内联函数定义在头文件中。 因此，结论是： 1. 普通函数（非内联）的定义不能放在头文件中，否则多个源文件包含该头文件会导致重复定义错误。 2. 内联函数（inline）和模板函数可以定义在头文件中，因为内联函数在每个编译单元中单独处理，链接器不会报错。 另外，头文件中也可以放置函数声明（用extern关键字，但通常省略），而将定义放在源文件中。 引用[2]中的例子： test01.h中定义了一个函数test()，如果这个头文件被多个源文件包含，那么每个源文件都会有一个test()函数的定义，链接时就会报重复定义错误。 所以，正确的做法是： - 在头文件中声明函数（使用extern，但通常省略，因为函数默认是extern的） - 在源文件中定义函数 或者，使用内联函数（inline）定义在头文件中。 下面给出具体示例： 示例1：头文件中声明函数，源文件中定义函数（推荐方式） 头文件 myfunc.h: ```c #ifndef MYFUNC_H #define MYFUNC_H // 函数声明 void myFunction(); #endif ``` 源文件 myfunc.c: ```c #include "myfunc.h" // 函数定义 void myFunction() { // 函数体 } ``` 示例2：头文件中定义内联函数（C++和C99以上支持） 头文件 myinline.h: ```c #ifndef MYINLINE_H #define MYINLINE_H // 内联函数定义 inline int add(int a, int b) { return a + b; } #endif ``` 注意：在C++中，模板函数必须定义在头文件中，因为模板需要编译器在实例化时看到完整的定义。 示例3：模板函数（C++） 头文件 mytemplate.h: ```c #ifndef MYTEMPLATE_H #define MYTEMPLATE_H template <typename T> T max(T a, T b) { return (a > b) ? a : b; } #endif ``` 总结： - 避免在头文件中定义非内联函数（除非是静态函数，但静态函数在每个编译单元都有一份拷贝，可能增加代码体积） - 内联函数、模板函数、类成员函数（在类定义中实现的函数默认为内联）可以定义在头文件中 - 函数声明（非定义）放在头文件中是安全的 引用[2]中明确指出，在头文件中定义全局变量、函数等会导致重复定义，因此是不合法的（除非使用static或inline等修饰符）。 另外，在C语言中，如果使用static修饰函数，那么该函数的作用域被限制在包含该头文件的源文件中（每个源文件都有一份独立的拷贝），这样虽然可以避免链接错误，但会增大程序体积，一般不推荐用于非内联函数。而内联函数使用static修饰则可能被编译器忽略内联建议，所以通常用inline。 因此，回答用户的问题：C/C++头文件中可以定义函数，但必须满足以下条件之一： 1. 该函数是内联函数（inline） 2. 该函数是模板函数（C++） 3. 该函数是静态函数（static，但不推荐，因为每个编译单元都有一份拷贝，且内联与否由编译器决定） 否则，应该将函数声明放在头文件中，定义放在源文件中。 相关问题： 1. 在C++头文件中定义类成员函数有什么要求？ 2. 内联函数和宏定义的区别是什么？ 3. 如何避免头文件重复包含？ 4. 头文件中可以定义变量吗？需要注意什么？</think>在C/C++中，**头文件允许定义函数**，但需要遵循特定的规则以避免链接错误。以下是关键规则和使用场景： --- ### ✅ 允许定义的情况 #### 1. 内联函数（推荐方式） 使用`inline`关键字定义函数，避免链接冲突： ```cpp // math_utils.h #ifndef MATH_UTILS_H #define MATH_UTILS_H inline int square(int x) { return x * x; // ✅ 每个编译单元独立实例化 } #endif ``` **原理**：`inline`函数在每个包含它的编译单元中单独实例化，链接器不会视为重复定义[^2]。 #### 2. 模板函数（C++特有） ```cpp // vector_ops.h template<typename T> T dot_product(T a, T b) { // ✅ 模板必须全定义在头文件 return a.x*b.x + a.y*b.y; } ``` **原理**：编译器需要看到完整模板定义才能实例化。 #### 3. 类成员函数 ```cpp // circle.h class Circle { public: double area() const { // ✅ 类内定义的函数自动inline return 3.14159 * radius * radius; } private: double radius; }; ``` #### 4. `static`函数（有限场景） ```c // logger.h static void log_error(const char* msg) { // ⚠️ 每个编译单元独立副本 fprintf(stderr, "ERROR: %s\n", msg); } ``` **注意**：会造成代码膨胀，仅推荐用于极简工具函数。 --- ### ❌ 禁止定义的情况 #### 普通全局函数（导致链接错误） ```cpp // utils.h void print_hello() { // ❌ 多文件包含时链接冲突 printf("Hello"); } ``` 当多个`.cpp`文件`#include`此头文件时，链接器会报**重复定义错误**。 --- ### 🔧 正确实践方案 #### 标准做法：声明在头文件，实现在源文件 ```cpp // math.h (声明) #pragma once int factorial(int n); // 仅声明 // math.cpp (实现) #include "math.h" int factorial(int n) { // 实际定义 return (n <= 1) ? 1 : n * factorial(n-1); } ``` --- ### ⚠️ 头文件函数定义的风险 1. **链接错误**：非`inline`函数在多个编译单元定义 2. **代码膨胀**：`static`函数在每个包含文件中生成副本 3. **编译时间增加**：修改头文件会触发所有包含它的文件重新编译 > **关键原则**：优先使用声明/实现分离的方式，仅对简单工具函数使用`inline`定义[^1][^2]。 --- ### 最佳实践总结 | 场景 | 是否允许 | 修饰关键字 | 适用语言 | |----------------------|----------|------------|----------| | 内联工具函数 | ✅ | `inline` | C/C++ | | 模板函数 | ✅ | 无 | C++ | | 类成员函数 | ✅ | 无 | C++ | | 静态工具函数 | ⚠️ 谨慎 | `static` | C/C++ | | 普通全局函数 | ❌ | - | C/C++ |
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值