基于C++类型重定义的使用详解
更新时间：2020年4月25日 17:47 点击：1916
这几天工作时碰到一个C++的编译错误(我使用的是Visual C++ 7.0)，说是有一个类重复定义，仔细想想我们的这个项目也是做了好几个Release了， 内部代码应该不会有这样的低级错误， 真把类型给重复定义了，检查结果正如我预料的一样。 就这样， 我左右没找到原因，被一个编译错误给卡在那里了。（在我的概念中， 程序错误的等级为：编译错误－>链接错误－>逻辑错误， 此错误属于最低级 ）。这时我仔细看了一下错误提示， 发现重复定义是由于从两个不同的路径包含了同一个头文件而引起的，同事也建议从另外一个路径打开工程试试， 这才慢慢发现了原因。这个原因可能有些拗口，而事实上要出现这种错误也有些"曲折"， 让我从不同情况下的类型重定义来解释一下吧。
我总结的类型重定义情况有三。
一、没有在文件头加#pragma once指示符。
Type1.h:
//#pragma once
class Type
{
};
Main.cpp:
#include "Type1.h"
#include "Type1.h"
int main(int argc, char *argv[])
{
return 1;
}
#pragma once的作用是保证本文件只被编译一次，如果没有在Type1.h中加这句话，那么在main.cpp里面包含了两次Type1.h， 就相当于在main.cpp里面定义了两次Type类， 自然就是类型重定义了。
二、两个不同的头文件中定义了相同的类型（均有#pragma once）
Type1.h:
#pragma once
class Type
{
};
Type2.h:
#pragma once
class Type
{
};
Main.cpp:
#include "Type1.h"
#include "Type2.h"
int main(int argc, char *argv[])
{
return 1;
}
这里main.cpp中同时包含了Type1.h, Type2.h两个头文件， 虽然其文件头都有#pragma once，但因为是不同的文件， 预编译器还是会两次把Type类的定义放在Main.cpp中， 所以也会出现了重定义。
三、从两个不同的路径包含了同一个头文件
前面两种是比较常见， 也是比较容易解决的情况， 而这里要讲的第三种情况， 比较少见， 而且一般出现在有虚拟映射盘的时候。（这样才能做到从两个不同的路径包含同一个头文件）， 其他会在什么时候出现， 我还没想到， 知道的朋友顶一下：）。下面我来分析一下：
1） 有VC工程在D:\Test目录下。
2） 映射虚拟盘X为D:\Test.
不熟悉的网友可以按此操作: 开始->运行->在运行窗口输入：cmd->在cmd窗口输入：
Subst X: D:\Test
3） 该工程有文件Type1.h, main.cpp
Type1.h:
#pragma once
class Type{};
Main.cpp:
#include "Type1.h"
#include "X:\Type1.h"
int main(int argc, char *argv[])
{
return 1;
}
这里我们在main.cpp这样包含了两个头文件， 从本质上来讲， 它们都对应于物理盘D:\Test下的文件Type1.h, 是同一个文件。但在不同的操作下， VC对其有不同的解释。#include "X:\Type1.h"用的是绝对路径， 自然没有什么异议， 但#include "Type1.h"却有些变化:
•假如我从D:\Test\下打开工程， 那么#include "Type1.h"其实就是#include "D:\Test\Type1.h"
•假如从X:\下打开工程，那么#include "Type1.h"就解释为#include "X:\Type1.h"
4） 在D:\Test下打开工程， 编译， 出现类型Type重复定义错误
这种情况下，main.cpp预编译为:
Main.cpp:
#include "D:\Test\Type1.h"
#include "X:\Type1.h"
int main(int argc, char *argv[])
{
return 1;
}
#pragma once只保证本文件被编译一次， 这里VC将其认为是两个不同的文件， 所以都要编译， 出现编译错误自然也就不奇怪了。
当然， 这里如果从X:\ 下打开工程的话，VC就会认为都是从X:\Type1.h下包含这个文件，#pragma once起到了作用， 也就不会出现类型重定义了
四、总结
我在VC7, VC8,和Dev C++中都测试了第三种情况， 发现只有Dev C++是可以通过编译的。这可能是微软VC的#pragma once还不够智能吧，轻易的被Windows的虚拟盘给蒙蔽了双眼， 看不到其本质（只是猜测， 或许VC这么处理是有其他用意的）。
因为在稍大一点的工程开发中， 我们一般都会用虚拟盘来方便工作， 一是访问快捷，简化了路径， 二是因为多人协同开发，我们一般希望大家源代码路径相同，但我们不应强制要求大家都把源代码放死在某一目录下， 这时把你放源代码的路径映射为一个虚拟盘（比如说统一为X:）就能把大家的代码路径统一起来了。但是另一方面，有了虚拟盘， 就为出现类型重定义提供了条件， 以下是我得出的两个解决方法：
1） 抛弃#pragma once使用古老但集稳定性与移植性于一身的
#ifndef _XXX_H
#define _XXX_H
//...#endif
来保证头文件只被编译一次。这样不管是包含两个相同的文件，还是包含两个不同的文件，或是包含两个文件相同但路径不同的文件， 只要_XXX_H被定义过， 就不会再编译那个编译(但这里我们要保证_XXX_H的唯一性， 如果两个不同的头文件里用了同一_XXX_H,是会出问题的)
2） 在包含头文件时，不要使用绝对路径， 哪怕那是虚拟盘的绝对路径。
我总结的类型重定义情况有三。
一、没有在文件头加#pragma once指示符。
复制代码 代码如下:
Type1.h:
//#pragma once
class Type
{
};
Main.cpp:
#include "Type1.h"
#include "Type1.h"
int main(int argc, char *argv[])
{
return 1;
}
#pragma once的作用是保证本文件只被编译一次，如果没有在Type1.h中加这句话，那么在main.cpp里面包含了两次Type1.h， 就相当于在main.cpp里面定义了两次Type类， 自然就是类型重定义了。
二、两个不同的头文件中定义了相同的类型（均有#pragma once）
复制代码 代码如下:
Type1.h:
#pragma once
class Type
{
};
Type2.h:
#pragma once
class Type
{
};
Main.cpp:
#include "Type1.h"
#include "Type2.h"
int main(int argc, char *argv[])
{
return 1;
}
这里main.cpp中同时包含了Type1.h, Type2.h两个头文件， 虽然其文件头都有#pragma once，但因为是不同的文件， 预编译器还是会两次把Type类的定义放在Main.cpp中， 所以也会出现了重定义。
三、从两个不同的路径包含了同一个头文件
前面两种是比较常见， 也是比较容易解决的情况， 而这里要讲的第三种情况， 比较少见， 而且一般出现在有虚拟映射盘的时候。（这样才能做到从两个不同的路径包含同一个头文件）， 其他会在什么时候出现， 我还没想到， 知道的朋友顶一下：）。下面我来分析一下：
1） 有VC工程在D:\Test目录下。
2） 映射虚拟盘X为D:\Test.
不熟悉的网友可以按此操作: 开始->运行->在运行窗口输入：cmd->在cmd窗口输入：
Subst X: D:\Test
3） 该工程有文件Type1.h, main.cpp
复制代码 代码如下:
Type1.h:
#pragma once
class Type{};
Main.cpp:
#include "Type1.h"
#include "X:\Type1.h"
int main(int argc, char *argv[])
{
return 1;
}
这里我们在main.cpp这样包含了两个头文件， 从本质上来讲， 它们都对应于物理盘D:\Test下的文件Type1.h, 是同一个文件。但在不同的操作下， VC对其有不同的解释。#include "X:\Type1.h"用的是绝对路径， 自然没有什么异议， 但#include "Type1.h"却有些变化:
•假如我从D:\Test\下打开工程， 那么#include "Type1.h"其实就是#include "D:\Test\Type1.h"
•假如从X:\下打开工程，那么#include "Type1.h"就解释为#include "X:\Type1.h"
4） 在D:\Test下打开工程， 编译， 出现类型Type重复定义错误
这种情况下，main.cpp预编译为:
复制代码 代码如下:
Main.cpp:
#include "D:\Test\Type1.h"
#include "X:\Type1.h"
int main(int argc, char *argv[])
{
return 1;
}
#pragma once只保证本文件被编译一次， 这里VC将其认为是两个不同的文件， 所以都要编译， 出现编译错误自然也就不奇怪了。
当然， 这里如果从X:\ 下打开工程的话，VC就会认为都是从X:\Type1.h下包含这个文件，#pragma once起到了作用， 也就不会出现类型重定义了
四、总结
我在VC7, VC8,和Dev C++中都测试了第三种情况， 发现只有Dev C++是可以通过编译的。这可能是微软VC的#pragma once还不够智能吧，轻易的被Windows的虚拟盘给蒙蔽了双眼， 看不到其本质（只是猜测， 或许VC这么处理是有其他用意的）。
因为在稍大一点的工程开发中， 我们一般都会用虚拟盘来方便工作， 一是访问快捷，简化了路径， 二是因为多人协同开发，我们一般希望大家源代码路径相同，但我们不应强制要求大家都把源代码放死在某一目录下， 这时把你放源代码的路径映射为一个虚拟盘（比如说统一为X:）就能把大家的代码路径统一起来了。但是另一方面，有了虚拟盘， 就为出现类型重定义提供了条件， 以下是我得出的两个解决方法：
1） 抛弃#pragma once使用古老但集稳定性与移植性于一身的
复制代码 代码如下:
#ifndef _XXX_H
#define _XXX_H
//...#endif
来保证头文件只被编译一次。这样不管是包含两个相同的文件，还是包含两个不同的文件，或是包含两个文件相同但路径不同的文件， 只要_XXX_H被定义过， 就不会再编译那个编译(但这里我们要保证_XXX_H的唯一性， 如果两个不同的头文件里用了同一_XXX_H,是会出问题的)
2） 在包含头文件时，不要使用绝对路径， 哪怕那是虚拟盘的绝对路径。
上一篇: 基于C++中常见编译错误的总结详解
下一篇: 基于结构体与指针的详解
相关文章
- vector是表示可以改变大小的数组的序列容器，本文主要介绍了C++STL标准库std::vector的使用详解，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下...2022-03-06
- 这篇文章主要介绍了C++中取余运算的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2021-02-23
- 这篇文章主要介绍了C++ string常用截取字符串方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2020-04-25
- 本文通过例子，讲述了C++调用C#的DLL程序的方法，作出了以下总结，下面就让我们一起来学习吧。...2020-06-25
php中浮点型(float)和整型(integer)数据类型详解
文章分析了关于php中浮点型(float)和整型(integer)数据类型的用法区别以及在那种情况下会出现数据长度不够。 取值只能为True或者False，当其他类型转化为boolean类...2016-11-25- 本篇文章主要介绍了C++中四种加密算法之AES源代码，小编觉得挺不错的，现在分享给大家，也给大家做个参考。...2020-04-25
- 本篇文章主要是对c#中数据类型占用的字节数进行了详细的介绍。需要的朋友可以过来参考下，希望对大家有所帮助...2020-06-25
- 这篇文章主要介绍了Javascript类型转换的规则实例解析，涉及到javascript类型转换相关知识，对本文感兴趣的朋友一起学习吧...2016-02-27
- 整数拆分，指把一个整数分解成若干个整数的和。本文重点给大家介绍C++ 整数拆分方法详解，非常不错，感兴趣的朋友一起学习吧...2020-04-25
- 这篇文章主要介绍了C++中Sort函数详细解析，sort函数是algorithm库下的一个函数，sort函数是不稳定的，即大小相同的元素在排序后相对顺序可能发生改变...2022-08-18
- 这篇文章主要介绍了C++万能库头文件在vs中的安装步骤(图文)，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2021-02-23
- 在PHP中，大部分变量类型，如字符串，整型，浮点，数组等都是值类型的，而类和对象是引用类型，在使用的时候，需要注意这一点。看到网友在讨论PHP的&符号，要彻底理解它的用法，就有必要讨论一下变量的两种形式。PHP的变量在内存中是这样...2015-10-23
- 假如现在有这样一个表单，是添加元素用的。<form id='addForm' action='UserAdd.action' type='post'> <label for='uname'>用户名</label>：<input type='text' name='uname' id='uname'><br>...2015-11-24
- 这篇文章主要介绍了C++ bitset用法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2020-04-25
- 虽然Javascript是弱类型语言，但是，它也有自己的几种数据类型，分别是：Number、String、Boolean、Object、Udefined、Null。其中，Object属于复杂数据类型，Object 由无序的键值对组成。其余几种都属于简单数据类型。注意：变量...2015-10-21
- 本篇文章小编并不是为大家讲解string类型的用法，而是讲解我个人比较好奇的问题，就是string 类型占几个字节...2020-04-25
- 这篇文章主要介绍了C#泛型类型知识，文中代码非常详细，帮助大家更好的理解和学习，感兴趣的朋友可以了解下...2020-06-25
- 这篇文章主要为大家详细介绍了C++ Eigen库计算矩阵特征值及特征向量，具有一定的参考价值，感兴趣的小伙伴们可以参考一下...2020-04-25
- 下面小编就为大家带来一篇java中String类型变量的赋值问题介绍。小编觉得挺不错的。现在分享给大家，给大家一个参考。...2016-03-28
- 这篇文章主要介绍了vue:el-input输入时限制输入的类型操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧...2020-08-05