动态链接库(六)--解决不同编译环境导致的名字改编问题

写在前面

前面有提过，C++编译器在生成DLL时，会对导出的函数进行名字改编，并且不同的编译器使用的改编规则不一样，因此改编后的名字是不一样的.

因此用不同的编译方式分别生成DLL和访问该DLL的程序的话，那么后者在访问该DLL的导出函数时就会出现问题.

因为此前DLL1示例和DLL_test示例都是同一个编译器，同一种调用约定，虽然发生了名字改编，但依旧可以通过原始函数名进行调用.

若用C++编写了一个DLL，那么用C语言编译的程序访问该DLL中的函数时就会出现问题. 因为后者将使用函数原始名来调用DLL中的函数，而C++编译器已经对该名称进行了改编，所以C语言编写的程序就找不到所需的DLL导出函数.

解决不同编译器导致的名字改编问题

这里使用C++编译方式编写一个DLL，在C程序中使用该DLL.

这里先取消掉DLL1项目中此前对两个全局函数的注释, 更新Dll1.h如下:

//Dll1.h
#ifdef DLL1_API
#else
#define DLL1_API __declspec(dllimport)
#endif

//int __declspec(dllimport) add(int a, int b);
int DLL1_API add(int a, int b);

//int __declspec(dllimport) subtract(int a, int b);
int DLL1_API subtract(int a, int b);

class /*DLL1_API*/ Dll1
{
public:
	DLL1_API Dll1();
	virtual DLL1_API ~Dll1();

	void DLL1_API publicFun();

public:
	int /*DLL1_API*/ m_nVal;

private:
	void DLL1_API privateFun();
	int /*DLL1_API*/ m_nVal2;
	
};

再更新Dll1.cpp文件如下:

//Dll.cpp
#define DLL1_API __declspec(dllexport)
#include "Dll1.h"

int add(int a, int b)
{
	return a + b;
}

int subtract(int a, int b)
{
	return a - b;


#include <windows.h>
#include <tchar.h>

Dll1::Dll1() : m_nVal(0), m_nVal2(0)
{
	TCHAR buf[100] = { 0 };
	_stprintf_s(buf, _T("\nDll1默认构造--m_nVal = %d\n"), m_nVal);
	OutputDebugString(buf);
}

Dll1::~Dll1()
{
	OutputDebugString(_T("\nDll1析构\n"));
}

void Dll1::publicFun()
{
	OutputDebugString(_T("\nDll1--publicFun\n"));
}

void Dll1::privateFun()
{
	OutputDebugString(_T("\nDll1--privateFun\n"));
}

重新生成DLL1项目，dumpbin查看，依旧会发生名字改编：

这里再新建一个C项目，选择Win32控制台应用程序 -》项目名为CTest –》勾选空项目：

添加新建项，选择C++文件（.cpp），但是在命名中输入main.c, 告知编译器该源文件以C方式编译：

将生成的dll，lib以及.h头文件更新到CTest项目中，在main.c中添加测试代码：

//main.c
#include <stdio.h>
#pragma comment(lib, "D:\\vs2010_application\\CTest\\CTest\\CTest\\Dll1.lib")
#include "Dll1.h"

int main()
{
	//这里没法通过Dll1.h中声明的函数名调用
	//解决方法：在Dll1导出函数的声明和实现前加extern "C" 限定符， 注意C要大写
	printf("2 + 3 = %d\n", add(2, 3));
	printf("5 - 2 = %d\n", sub(5, 2));

	system("pause");
	return;
}

编译会有以下提示：

因为C中不支持面向对象编程，不知道类是啥东西，因此这里需将DLL1中的类相关代码屏蔽掉, 修改Dll1.h如下:

//Dll1.h
#ifdef DLL1_API
#else
#define DLL1_API __declspec(dllimport)
#endif

//int __declspec(dllimport) add(int a, int b);
int DLL1_API add(int a, int b);

//int __declspec(dllimport) subtract(int a, int b);
int DLL1_API subtract(int a, int b);

修改Dll1.cpp如下:

//Dll.cpp
#define DLL1_API __declspec(dllexport)
#include "Dll1.h"

int add(int a, int b)
{
	return a + b;
}

int subtract(int a, int b)
{
	return a - b;
}

重新生成, 只有add和subtract两个导出的全局函数：

取lib, dll, .h 文件更新到CTest项目中，再次编译可以看到add和subtract两个无法解析的符号提示：

这里虽然调用约定都是默认的C调用约定_cdecl, 但编译环境发生了变化，因此无法像此前C++编译器中使用时自动解释成改编后的名字.

所以这里就可以知道，不同编译环境导致的名字改编不能直接使用.h中原函数声明名调用.

解决方法就是统一编译规则，现在C项目中已经是以C方式编译了，而且也没见到有extern “C++”这种东西，所以就使用extern “C” 限定符统一成C编译方式了, 注意C要大写.

同时注意： extern “C” 限定符表明后接代码以C方式编译，这段代码中不能有C没有的东西（比如说class类）.

修改DLL1项目，只需修改Dll.h头文件即可：

//Dll1.h
#ifdef DLL1_API
#else
#define DLL1_API __declspec(dllimport)
#endif

extern "C"
{
	//int __declspec(dllimport) add(int a, int b);
	int DLL1_API add(int a, int b);

	//int __declspec(dllimport) subtract(int a, int b);
	int DLL1_API subtract(int a, int b);
};

重新生成，使用dumpbin名称查看：

发现加了extern “C”限定符后竟然没有发生名字改编了！

更新lib, dll, .h 到CTest项目中，main.cpp无需变动，但注意更新的.h文件，在C中也是不允许extern “C” 的，所以编译会有以下报错：

这里需手动注释掉extern “C”部分，再编译运行，因为没有发生名字改编后，因此这里可以通过编译直接运行：

总结

至此，可以得知不同编译器导致的名字改编问题的方法，即使用extern “C” 限定符统一为C编译方式.

需要注意的就是extern “C” 中的C需大写，且限定的代码段中不用出现C不支持的语法.

补充

上面的方式还有个问题就是，.h头文件更新到C项目中后需手动注释extern “C” 限定符，因为C++编译环境会定义__cplusplus这个宏， 所以这里可以通过条件编译的方式判断当前编译环境是否需要extern “C” 限定符，更改DLL1项目，只需修改.h头文件即可：

//Dll1.h
#ifdef DLL1_API
#else
#define DLL1_API __declspec(dllimport)
#endif

#ifdef __cplusplus
extern "C"
{
#endif
	//int __declspec(dllimport) add(int a, int b);
	int DLL1_API add(int a, int b);

	//int __declspec(dllimport) subtract(int a, int b);
	int DLL1_API subtract(int a, int b);

#ifdef __cplusplus
};
#endif

重新生成，使用dumpbin命令查看依旧没有发生名字改编：

更新到CTest项目后，无需再手动注释.h文件中的extern “C”, 即可通过编译运行：