c/c++名称修饰

1、修饰名（Decoration name）

C或者C++函数在内部（编译和链接）通过修饰名识别。修饰名是编译器在编译函数定义或者原型时生成的字符串。有些情况下使用函数的修饰名是必要的，如在模块定义文件里头指定输出C++重载函数、构造函数、析构函数，又如在汇编代码里调用C或C++函数等。

修饰名由函数名、类名、调用约定、返回类型、参数等共同决定。

2、名字修饰约定随调用约定和编译种类（C或C++）的不同而变化。函数名修饰约定随编译种类和调用约定的不同而不同，下面分别说明。

a、C编译时函数名修饰约定规则：

__stdcall调用约定在输出函数名前加上一个下划线前缀，后面加上一个“@”符号和其参数的字节数，格式为_name@number。

__cdecl调用约定仅在输出函数名前加上一个下划线前缀，格式为_name。

__fastcall调用约定在输出函数名前加上一个“@”符号，后面也是一个“@”符号和其参数的字节数，格式为@name@number。

它们均不改变输出函数名中的字符大小写，这和PASCAL调用约定不同，PASCAL约定输出的函数名无任何修饰且全部大写。

b、C++编译时函数名修饰约定规则：

__stdcall调用约定：

1、以“?”标识函数名的开始，后跟函数名；

2、函数名后面以“@@YG”标识参数表的开始，后跟参数表；

3、参数表以代号表示：

X--void
D--char
E--unsigned char
F--short
H--int
I--unsigned int
J--long
K--unsigned long
M--float
N--double
_N--bool
……
PA--表示指针，后面的代号表明指针类型，如果相同类型的指针连续出现，以“0”代替，一个“0”代表一次重复；

4、参数表的第一项为该函数的返回值类型，其后依次为参数的数据类型,指针标识在其所指数据类型前；

5、参数表后以“@Z”标识整个名字的结束，如果该函数无参数，则以“Z”标识结束。其格式为“?name@@YG*****@Z”或“?name@@YG*XZ”，例如

int Test1(char *var1, unsigned long) ----- “?Test1@@YGHPADK@Z”

void Test2() ----- “?Test2@@YGXXZ”

__cdecl调用约定：

规则同上面的_stdcall调用约定，只是参数表的开始标识由上面的“@@YG”变为“@@YA”。

__fastcall调用约定：

规则同上面的_stdcall调用约定，只是参数表的开始标识由上面的“@@YG”变为“@@YI”。

VC++对函数的省缺声明是“__cedcl”，将只能被C/C++调用。

extern "C" 包含双重含义，从字面上即可得到：首先，被它修饰的目标是“extern”的；其次，被它修饰的目标是“C”的。让我们来详细解读这两重含义。

　　（1） 被extern "C"限定的函数或变量是extern类型的：

　　extern是C/C++语言中表明函数和全局变量作用范围（可见性）的关键字，该关键字告诉编译器，其声明的函数和变量可以在本模块或其它模块中使用。记住，下列语句：

　　extern int a;

　　仅仅是一个变量的声明，其并不是在定义变量a，并未为a分配内存空间。变量a在所有模块中作为一种全局变量只能被定义一次，否则会出现连接错误。

　　通常，在模块的头文件中对本模块提供给其它模块引用的函数和全局变量以关键字extern声明。例如，如果模块B欲引用该模块A中定义的全局变量和函数时只需包含模块A的头文件即可。这样，模块B中调用模块A中的函数时，在编译阶段，模块B虽然找不到该函数，但是并不会报错；它会在连接阶段中从模块A编译生成的目标代码中找到此函数。

　　与extern对应的关键字是static，被它修饰的全局变量和函数只能在本模块中使用。因此，一个函数或变量只可能被本模块使用时，其不可能被extern “C”修饰。

　　（2） 被extern "C"修饰的变量和函数是按照C语言方式编译和连接的；

　　未加extern “C”声明时的编译方式

　　首先看看C++中对类似C的函数是怎样编译的。

　　作为一种面向对象的语言，C++支持函数重载，而过程式语言C则不支持。函数被C++编译后在符号库中的名字与C语言的不同。例如，假设某个函数的原型为：

　　void foo( int x, int y );

　　该函数被C编译器编译后在符号库中的名字为_foo，而C++编译器则会产生像_foo_int_int之类的名字（不同的编译器可能生成的名字不同，但是都采用了相同的机制，生成的新名字称为“mangled name”）。_foo_int_int这样的名字包含了函数名、函数参数数量及类型信息，C++就是靠这种机制来实现函数重载的。例如，在C++中，函数void foo( int x, int y )与void foo( int x, float y )编译生成的符号是不相同的，后者为_foo_int_float。

　　同样地，C++中的变量除支持局部变量外，还支持类成员变量和全局变量。用户所编写程序的类成员变量可能与全局变量同名，我们以"."来区分。而本质上，编译器在进行编译时，与函数的处理相似，也为类中的变量取了一个独一无二的名字，这个名字与用户程序中同名的全局变量名字不同。

　　未加extern "C"声明时的连接方式

　　假设在C++中，模块A的头文件如下：

　　// 模块A头文件　moduleA.h

　　#ifndef MODULE_A_H

　　#define MODULE_A_H

　　int foo( int x, int y );

　　#endif

　　在模块B中引用该函数：

　　// 模块B实现文件　moduleB.cpp

　　＃i nclude "moduleA.h"

　　foo(2,3);

　　实际上，在连接阶段，连接器会从模块A生成的目标文件moduleA.obj中寻找_foo_int_int这样的符号！

　　加extern "C"声明后的编译和连接方式

　　加extern "C"声明后，模块A的头文件变为：

　　// 模块A头文件　moduleA.h

　　#ifndef MODULE_A_H

　　#define MODULE_A_H

　　extern "C" int foo( int x, int y );

　　#endif

　　在模块B的实现文件中仍然调用foo( 2,3 )，其结果是：

　　（1）模块A编译生成foo的目标代码时，没有对其名字进行特殊处理，采用了C语言的方式；

　　（2）连接器在为模块B的目标代码寻找foo(2,3)调用时，寻找的是未经修改的符号名_foo。

　　如果在模块A中函数声明了foo为extern "C"类型，而模块B中包含的是extern int foo( int x, int y ) ，则模块B找不到模块A中的函数；反之亦然。

　　所以，可以用一句话概括extern “C”这个声明的真实目的（任何语言中的任何语法特性的诞生都不是随意而为的，来源于真实世界的需求驱动。我们在思考问题时，不能只停留在这个语言是怎么做的，还要问一问它为什么要这么做，动机是什么，这样我们可以更深入地理解许多问题）：

　　实现C++与C及其它语言的混合编程。

　　明白了C++中extern "C"的设立动机，我们下面来具体分析extern "C"通常的使用技巧。

　　4.extern "C"的惯用法

　　（1）在C++中引用C语言中的函数和变量，在包含C语言头文件（假设为cExample.h）时，需进行下列处理：

　　extern "C"

　　{

　　＃i nclude "cExample.h"

　　}

　　而在C语言的头文件中，对其外部函数只能指定为extern类型，C语言中不支持extern "C"声明，在.c文件中包含了extern "C"时会出现编译语法错误。

　　笔者编写的C++引用C函数例子工程中包含的三个文件的源代码如下：

　　/* c语言头文件：cExample.h */

　　#ifndef C_EXAMPLE_H

　　#define C_EXAMPLE_H

　　extern int add(int x,int y);

　　#endif

　　/* c语言实现文件：cExample.c */

　　＃i nclude "cExample.h"

　　int add( int x, int y )

　　{

　　return x + y;

　　}

　　// c++实现文件，调用add：cppFile.cpp

　　extern "C"

　　{

　　＃i nclude "cExample.h"

　　}

　　int main(int argc, char* argv[])

　　{

　　add(2,3);

　　return 0;

　　}

　　（注意这里如果用GCC编译的时候，请先使用gcc -c选项生成cExample.o，再使用g++ -o cppFile cppFile.cpp cExample.o才能生成预期的c++调用c函数的结果，否则，使用g++ -o cppFile cppFile.cpp cExample.c编译器会报错；而当cppFile.cpp 文件中不使用下列语句

　　extern "C"

　　{

　　＃i nclude "cExample.h"

　　}

　　而改用

　　＃i nclude "cExample.h"

　　extern "C" int add( int x, int y );

　　时

　　g++ -o cppFile cppFile.cpp cExample.c的编译过程会把add函数按c++的方式解释为_foo_int_int这样的符号。

　　）

　　如果C++调用一个C语言编写的.DLL时，当包括.DLL的头文件或声明接口函数时，应加extern "C" {　}。

　　（2）在C中引用C++语言中的函数和变量时，C++的头文件需添加extern "C"，但是在C语言中不能直接引用声明了extern "C"的该头文件，应该仅将C文件中将C++中定义的extern "C"函数声明为extern类型。

　　笔者编写的C引用C++函数例子工程中包含的三个文件的源代码如下：

　　//C++头文件 cppExample.h

　　#ifndef CPP_EXAMPLE_H

　　#define CPP_EXAMPLE_H

　　extern "C" int add( int x, int y );

　　#endif

　　//C++实现文件 cppExample.cpp

　　＃i nclude "cppExample.h"

　　int add( int x, int y )

　　{

　　return x + y;

　　}

　　/* C实现文件 cFile.c

　　/* 这样会编译出错：＃i nclude "cppExample.h" */

　　extern int add( int x, int y );

　　int main( int argc, char* argv[] )

　　{

　　add( 2, 3 );

　　return 0;

　　}