[c&cpp] C\C++交互—extern “C”

#ifndef __INCvxWorksh
#define __INCvxWorksh
#ifdef __cplusplus
extern "C" {
#endif
/*...*/
#ifdef __cplusplus
}
#endif
#endif /* __INCvxWorksh */

显然，头文件中的编译宏“#ifndef __INCvxWorksh、#define __INCvxWorksh、#endif” 的作用是防止该头文件被重复引用。

3-9行的代码作用又是什么呢？

1: extern "C"的含义

    extern "C" 包含双重含义，从字面上看：首先，被它修饰的目标是＂extern＂的; 其次，被它修饰的目标是＂C＂的. 被extern "C"限定的函数或变量是extern类型的；

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

    语句: extern int a; 仅仅是一个变量的声明，其并不是在定义变量a，并未为a分配内存空间。变量a在所有模块中作为一种全局变量只能被定义一次，否则会出现链接错误。通常，在模块的头文件中对本模块提供给其它模块引用的函数和全局变量以关键字extern声明。例如，如果模块B欲引用该模块A中定义的全局变量和函数时只需包含模块A的头文件即可。这样，模块B中调用模块A中的函数时，在编译阶段，模块B虽然找不到该函数，但是并不会报错; 它会在连接阶段中从模块A编译生成的目标代码中找到此函数。
    与extern对应的关键字是static，被它修饰的全局变量和函数只能在本模块中使用。因此，一个函数或变量只可能被本模块使用时，其不可能被extern “C”修饰。被extern "C"修饰的变量和函数是按照C语言方式编译和连接的。

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

3: 未加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
#include "moduleA.h"
foo(2,3);

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

4: 加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中的函数,因为连接器会从moduleA.obj中寻找_foo_int_int,但是在moduleA.obj中只有符号名_foo,反之亦然。

5. extern "C"的惯用法
1) 在C++中引用C语言中的函数和变量

在包含C语言头文件（假设为cExample.h）时，需进行下列处理：

extern "C" {
   #include "cExample.h"
}

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

示例代码如下:

/* c语言头文件：cExample.h */
#ifndef C_EXAMPLE_H
#define C_EXAMPLE_H
extern int add(int x,int y);
#endif

/* c语言实现文件：cExample.c */
#include "cExample.h"
int add( int x, int y ) {
return x + y;
}

// c++实现文件，调用add：cppFile.cc
extern "C"  {
#include "cExample.h"
}

int main(int argc, char* argv[]) {
    add(2,3);
    return 0;
}

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

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

示例代码如下:

//C++头文件 cppExample.h
#ifndef CPP_EXAMPLE_H
#define CPP_EXAMPLE_H
extern "C" int add( int x, int y );
#endif

//C++实现文件 cppExample.cpp
#include "cppExample.h"
int add( int x, int y ) {
    return x + y;
}

/* C实现文件 cFile.c
/* 这样会编译出错：#include "cExample.h" */
extern int add( int x, int y );
int main( int argc, char* argv[] ) {
    add( 2, 3 );
    return 0;
}