stm32f10x.h 的 #ifdef __cplusplus

转自http://blog.csdn.net/thanklife/article/details/7362893

stm32f10x.h：

#ifdef __cplusplus
extern "C" { 
#endif
...//device设置，晶振频率，是否包含外围 的设置
}

简答：

一般用于将C++代码以标准C形式输出（即以C的形式被调用），这是因为C++虽然常被认为是C的超集，但是C++的编译器还是与C的编译器不同的。C中调用C++中的代码这样定义会是安全的。
一般的考虑跨平台使用方法如下：
#ifdefined(__cplusplus)||defined(c_plusplus) //跨平台定义方法
extern "C"{
#endif
//... 正常的声明段
#ifdefined(__cplusplus)||defined(c_plusplus)
}
#endif 

简单的用在windows下可以如下定义:
#ifdef   __cplusplus
extern "C"{
//... 正常的声明段
}
#endif

详细答案：

<span style="font-size:18px;">__cplusplus是cpp中的自定义宏，那么定义了这个宏的话表示这是一段cpp的代码，也就是说，上面的代码的含义是:</span><span style="font-size:18px; background-color: rgb(240, 240, 240); font-family: arial, 'courier new', courier, 宋体, monospace;">如果这是一段cpp的代码，那么加入extern"C"{ 和 } 处理其中的代码。</span>
<span style="font-size:18px;">    要明白为何使用extern"C"，还得从cpp中对函数的<strong>重载处理</strong>开始说起。在c++中，为了支持重载机制，在编译生成的汇编码中，要对函数的名字进行一些处理，比如</span><span style="font-size:18px; background-color: rgb(240, 240, 240); font-family: Arial, Helvetica, sans-serif;">加入</span><span style="font-size:18px; background-color: rgb(240, 240, 240); font-family: arial, 'courier new', courier, 宋体, monospace;">函数的</span><span style="font-size:18px; background-color: rgb(240, 240, 240); font-family: arial, 'courier new', courier, 宋体, monospace;">返回类型等等.而在C中，只是简单的函数名字而已，不会加入其他的信息.也就是说:C++和C对产生的函数名字的处理是不一样的.</span>

<span style="font-size:18px;">比如下面的一段简单的函数，我们看看加入和不加入extern"C"产生的汇编代码都有哪些变化:</span>
<pre code_snippet_id="332094" snippet_file_name="blog_20140507_5_1477130" class="reply-text mb10" name="code" style="font-size:18px; color: rgb(51, 51, 51); white-space: pre-wrap; word-wrap: break-word; line-height: 26px; background-color: rgb(255, 255, 255);"><pre code_snippet_id="332094" snippet_file_name="blog_20140507_5_1477130" name="code" class="cpp">int f(void)
{
return1;
}

<span style="color:#333333;">在加入extern"C"的时候产生的汇编代码是:
</span><pre code_snippet_id="332094" snippet_file_name="blog_20140507_6_997169" name="code" class="objc" style="color: rgb(51, 51, 51);">.file"test.cxx"
.text
.align2
.globl_f
.def_f;.scl2;.type32;.endef
_f:
pushl%ebp
movl%esp，%ebp
movl$1，%eax
popl%ebp
ret

但是不加入了extern"C"之后

.file"test.cxx"
.text
.align2
.globl__Z1fv
.def__Z1fv;.scl2;.type 32;.endef
__Z1fv:
pushl%ebp
movl%esp，%ebp
movl$1，%eax
popl%ebp
ret

两段汇编代码同样都是使用gcc-S命令产生的，所有的地方都是一样的，唯独是产生的函数名，一个是_f，一个是__Z1fv。 明白了加入与不加入extern"C"之后对函数名称产生的影响，我们继续我们的讨论:为什么需要使用extern"C"呢？C++之父在设计C++之时，考虑到当时已经存在了大量的C代码，为了支持原来的C代码和已经写好的C库， 需要在C++中尽可能的支持C ，而extern"C"就是其中的一个策略。 试想这样的情况:一个库文件已经用C写好了而且运行得很良好，这个时候我们需要使用这个库文件，但是我们需要使用C++来写这个新的代码。如果这个代码使用的是C++的方式链接这个C库文件的话，那么就会出现链接错误.我们来看一段代码:首先，我们使用C的处理方式来写一个函数，也就是说假设这个函数当时是用C写成的:

//f1.c
extern"C"
{
voidf1()
{
return;
}
}

编译命令是:gcc-cf1.c-of1.o 产生了一个叫f1.o的库文件。再写一段代码调用这个f1函数:

//test.cxx
//这个extern表示f1函数在别的地方定义，这样可以通过
//编译，但是链接的时候还是需要
//链接上原来的库文件.
externvoidf1();
intmain()
{
f1();
return0;
}

通过gcc-ctest.cxx-otest.o 产生一个叫test.o的文件。然后，我们使用gcc test.o f1.o来链接两个文件，可是出错了，错误的提示是:test.o(.text+0x1f):test.cxx:undefinereferenceto'f1()'也就是说，在编译test.cxx的时候编译器是使用C++的方式来处理f1()函数的，但是实际上链接的库文件却是用C的方式来处理函数的，所以就会出现链接过不去的错误:因为链接器找不到函数。因此，为了在C++代码中调用用C写成的库文件，就需要用extern"C"来告诉编译器:这是一个用C写成的库文件，请用C的方式来链接它们。比如，现在我们有了一个C库文件，它的头文件是f.h，产生的lib文件是f.lib，那么我们如果要在C++中使用这个库文件，我们需要这样写:

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

回到上面的问题，如果要改正链接错误，我们需要这样子改写test.cxx:

extern"C"
{
externvoidf1();
}
intmain()
{
f1();
return0;
}

重新编译并且链接就可以过去了.总结C和C++对函数的处理方式是不同的.extern"C"是使C++能够调用C写作的库文件的一个手段，如果要对编译器提示使用C的方式来处理函数的话，那么就要使用extern"C"来说明。 

</pre><pre code_snippet_id="332094" snippet_file_name="blog_20140507_12_5939349" class="reply-text mb10" name="code" style="white-space: pre-wrap; word-wrap: break-word; line-height: 26px; background-color: rgb(255, 255, 255);"><div id="app-share-content"><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr></wbr></p><p><strong><span style="font-size:48px;">C++</span></strong><wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;">1.引言</p><p style="color: rgb(51, 51, 51);font-size:18px;">C++语言的创建初衷是“a better C”，但是这并不意味着C++中类似C语言的全局变量和函数所采用的编译和连接方式与C语言完全相同。作为一种欲与C兼容的语言，C++保留了一部分过程式语言的特点（被世人称为“不彻底地面向对象”），因而它可以定义不属于任何类的全局变量和函数。但是，C++毕竟是一种面向对象的程序设计语言，为了支持函数的重载，C++对全局函数的处理方式与C有明显的不同。</p><p style="color: rgb(51, 51, 51);font-size:18px;">2.从标准头文件说起</p><p style="color: rgb(51, 51, 51);font-size:18px;">某企业曾经给出如下的一道面试题：</p><p style="color: rgb(51, 51, 51);font-size:18px;">面试题</p><p style="color: rgb(51, 51, 51);font-size:18px;">为什么标准头文件都有类似以下的结构？</p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>#ifndef __INCvxWorksh</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>#define __INCvxWorksh</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr><span style="color: rgb(238, 102, 0); background-color: yellow;"><span id="Mark">#ifdef</span></span> <span style="color: blue; background-color: rgb(204, 255, 255);"><span id="Mark">__cplusplus</span></span></wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>extern "C" {</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>#endif</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr></wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr><span style="color: rgb(238, 102, 0); background-color: yellow;"><span id="Mark">#ifdef</span></span> <span style="color: blue; background-color: rgb(204, 255, 255);"><span id="Mark">__cplusplus</span></span></wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>}</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>#endif</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>#endif</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;">分析</p><p style="color: rgb(51, 51, 51);font-size:18px;">显然，头文件中的编译宏“#ifndef __INCvxWorksh、#define __INCvxWorksh、#endif” 的作用是防止该头文件被重复引用。</p><p style="color: rgb(51, 51, 51);font-size:18px;">那么</p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr><span style="color: rgb(238, 102, 0); background-color: yellow;"><span id="Mark">#ifdef</span></span> <span style="color: blue; background-color: rgb(204, 255, 255);"><span id="Mark">__cplusplus</span></span></wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>extern "C" {</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>#endif</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><span style="color: rgb(238, 102, 0); background-color: yellow;"><span id="Mark">#ifdef</span></span> <span style="color: blue; background-color: rgb(204, 255, 255);"><span id="Mark">__cplusplus</span></span></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>}</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr>#endif</wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;">的作用又是什么呢？我们将在下文一一道来。</p><p style="color: rgb(51, 51, 51);font-size:18px;">3.深层揭密extern "C"</p><p style="color: rgb(51, 51, 51);font-size:18px;">extern "C" 包含双重含义，从字面上即可得到：首先，被它修饰的目标是“extern”的；其次，被它修饰的目标是“C”的。让我们来详细解读这两重含义。</p><p style="color: rgb(51, 51, 51);font-size:18px;">（1） <wbr><wbr><wbr><wbr><wbr><wbr><wbr>被extern "C"限定的函数或变量是extern类型的；</wbr></wbr></wbr></wbr></wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;">extern是C/C++语言中表明函数和全局变量作用范围（可见性）的关键字，该关键字告诉编译器，其声明的函数和变量可以在本模块或其它模块中使用。记住，下列语句：</p><p style="color: rgb(51, 51, 51);font-size:18px;">extern int a;</p><p style="color: rgb(51, 51, 51);font-size:18px;">仅仅是一个变量的声明，其并不是在定义变量a，并未为a分配内存空间。变量a在所有模块中作为一种全局变量只能被定义一次，否则会出现连接错误。</p><p style="color: rgb(51, 51, 51);font-size:18px;">通常，在模块的头文件中对本模块提供给其它模块引用的函数和全局变量以关键字extern声明。例如，如果模块B欲引用该模块A中定义的全局变量和函数时只需包含模块A的头文件即可。这样，模块B中调用模块A中的函数时，在编译阶段，模块B虽然找不到该函数，但是并不会报错；它会在连接阶段中从模块 A编译生成的目标代码中找到此函数。</p><p style="color: rgb(51, 51, 51);font-size:18px;">与extern对应的关键字是static，被它修饰的全局变量和函数只能在本模块中使用。因此，一个函数或变量只可能被本模块使用时，其不可能被extern “C”修饰。</p><p style="color: rgb(51, 51, 51);font-size:18px;">（2） <wbr><wbr><wbr><wbr><wbr><wbr><wbr>被extern "C"修饰的变量和函数是按照C语言方式编译和连接的；</wbr></wbr></wbr></wbr></wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><strong>未加extern “C”声明时的编译方式</strong></p><p style="color: rgb(51, 51, 51);font-size:18px;">首先看看C++中对类似C的函数是怎样编译的。</p><p style="color: rgb(51, 51, 51);font-size:18px;">作为一种面向对象的语言，C++支持函数重载，而过程式语言C则不支持。函数被C++编译后在符号库中的名字与C语言的不同。例如，假设某个函数的原型为：</p><p style="color: rgb(51, 51, 51);font-size:18px;">void foo( int x, int y );</p><p style="color: rgb(51, 51, 51);font-size:18px;">该函数被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。</p><p style="color: rgb(51, 51, 51);font-size:18px;">同样地，C++中的变量除支持局部变量外，还支持类成员变量和全局变量。用户所编写程序的类成员变量可能与全局变量同名，我们以"."来区分。而本质上，编译器在进行编译时，与函数的处理相似，也为类中的变量取了一个独一无二的名字，这个名字与用户程序中同名的全局变量名字不同。</p><p style="color: rgb(51, 51, 51);font-size:18px;">未加extern "C"声明时的连接方式</p><p style="color: rgb(51, 51, 51);font-size:18px;">假设在C++中，模块A的头文件如下：</p><p style="color: rgb(51, 51, 51);font-size:18px;">// 模块A头文件　moduleA.h</p><p style="color: rgb(51, 51, 51);font-size:18px;">#ifndef MODULE_A_H</p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr><wbr><wbr><wbr><wbr>#define MODULE_A_H</wbr></wbr></wbr></wbr></wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr><wbr>int foo( int x, int y );</wbr></wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;">#endif</p><p style="color: rgb(51, 51, 51);font-size:18px;">在模块B中引用该函数：</p><p style="color: rgb(51, 51, 51);font-size:18px;">// 模块B实现文件　moduleB.cpp</p><p style="color: rgb(51, 51, 51);font-size:18px;">＃include "moduleA.h"</p><p style="color: rgb(51, 51, 51);font-size:18px;">foo(2,3);</p><p style="color: rgb(51, 51, 51);font-size:18px;">实际上，在连接阶段，连接器会从模块A生成的目标文件moduleA.obj中寻找_foo_int_int这样的符号！</p><p style="color: rgb(51, 51, 51);font-size:18px;">
</p><p style="color: rgb(51, 51, 51);font-size:18px;"><strong>加extern "C"声明后的编译和连接方式</strong></p><p style="color: rgb(51, 51, 51);font-size:18px;">加extern "C"声明后，模块A的头文件变为：</p><p style="color: rgb(51, 51, 51);font-size:18px;">// 模块A头文件　moduleA.h</p><p style="color: rgb(51, 51, 51);font-size:18px;">#ifndef MODULE_A_H</p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr><wbr><wbr><wbr><wbr>#define MODULE_A_H</wbr></wbr></wbr></wbr></wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr><wbr><wbr><wbr>extern "C" int foo( int x, int y );</wbr></wbr></wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;">#endif</p><p style="color: rgb(51, 51, 51);font-size:18px;">在模块B的实现文件中仍然调用foo( 2,3 )，其结果是：</p><p style="color: rgb(51, 51, 51);font-size:18px;">（1）模块A编译生成foo的目标代码时，没有对其名字进行特殊处理，采用了C语言的方式；</p><p style="color: rgb(51, 51, 51);font-size:18px;">（2）连接器在为模块B的目标代码寻找foo(2,3)调用时，寻找的是未经修改的符号名_foo。</p><p style="color: rgb(51, 51, 51);font-size:18px;">如果在模块A中函数声明了foo为extern "C"类型，而模块B中包含的是extern int foo( int x, int y ) ，则模块B找不到模块A中的函数；反之亦然。</p><p style="color: rgb(51, 51, 51);font-size:18px;">所以，可以用一句话概括extern “C”这个声明的真实目的（任何语言中的任何语法特性的诞生都不是随意而为的，来源于真实世界的需求驱动。我们在思考问题时，不能只停留在这个语言是怎么做的，还要问一问它为什么要这么做，动机是什么，这样我们可以更深入地理解许多问题）：</p><p style="color: rgb(51, 51, 51);font-size:18px;">实现C++与C及其它语言的混合编程。</p><p style="color: rgb(51, 51, 51);font-size:18px;">明白了C++中extern "C"的设立动机，我们下面来具体分析extern "C"通常的使用技巧。</p><p style="color: rgb(51, 51, 51);font-size:18px;">4.<strong>extern "C"的惯用法</strong></p><p style="color: rgb(51, 51, 51);font-size:18px;">（1）在C++中引用C语言中的函数和变量，在包含C语言头文件（假设为cExample.h）时，需进行下列处理：</p><p style="color: rgb(51, 51, 51);font-size:18px;">extern "C"</p><p style="color: rgb(51, 51, 51);font-size:18px;">{</p><p style="color: rgb(51, 51, 51);font-size:18px;">＃include "cExample.h"</p><p style="color: rgb(51, 51, 51);font-size:18px;">}</p><p style="color: rgb(51, 51, 51);font-size:18px;">而在C语言的头文件中，对其外部函数只能指定为extern类型，C语言中不支持extern "C"声明，在.c文件中包含了extern "C"时会出现编译语法错误。</p><p style="color: rgb(51, 51, 51);font-size:18px;">笔者编写的C++引用C函数例子工程中包含的三个文件的源代码如下：</p><p style="color: rgb(51, 51, 51);font-size:18px;"><wbr></wbr></p><p style="color: rgb(51, 51, 51);font-size:18px;"></p><pre code_snippet_id="332094" snippet_file_name="blog_20140507_12_5939349" name="code" class="cpp">#ifndef C_EXAMPLE_H
#define C_EXAMPLE_H
extern int add(int x,int y);
#endif
＃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;
}

如果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;
}
extern int add( int x, int y );
int main( int argc, char* argv[] )
{
add( 2, 3 ); 
return 0;
}