总结:移植（porting），解决undefined reference to错误及unresovled错误

by sjyuhusun

 

鉴于本人在此走过弯路及探索，为了大家少走弯路，现小结一下移植（porting）的林林总总，供大家参考，不足之处还望前辈们多多指教。
以C code移植到symbian中为例：因原c程序功能所限，我在vc6中用向导生成了一个exe程序。
1。将原C程序的所有.C文件放到/src/目录下，将所有.h文件放到/inc/目录下
2。edit the mmp file. 首先，添加/EPOC32/INCLUDE/LIBC到systeminclude，即把c库include进去。其次，在SOUCE里添加各C文件。一定要把所用到的c文件都加进去，缺少会报好多错误，如undefined reference to错误.最后添加：library estlib.lib //这个库是支持标准c的，必须添加
STATICLIBRARY ecrt0.lib //这个是exe程序所需要的，它为exe提供E32Main()入口
3。在vc6下，将.C和.h文件导入。
4。修改原C程序的.h文件，在文件开始添加：
#ifdef __cplusplus
extern "C" {
#endif
在尾部添加：
#ifdef __cplusplus
}
#endif
大体结构如下：
#ifdef __cplusplus
extern "C" {
#endif
/*.....mycode..........*/
/* 这里主要是用extern声明一些函数或变量*/
#ifdef __cplusplus
}
#endif
5。在exe的cpp文件里要加上extern "C"{}
形如：extern "C"
{
/*要把在该C++中引用C文件里的头文件include进来
如：#include <stdlib.h>
#include <e32def.h>
#include <string.h>
#include <stdio.h>
或者添加所用到的c中的函数的声明，用extern声明，如extern void f1()
此处extern可以通过编译，但是链接时还要链接原C库文件，不然就会出错：形如
test.o(.test+0x1f):test.cpp:undefined reference to 错误
*/
}

在C++代码中调用C的库文件，需加上extern "C"，用来告知编译器：这是一个用C写成的库文件，请用C的方式连接他们。
Undefined reference to 错误:这类错误是在连接过程中出现的，可能有两种原因∶一是使用者自己定义的函数或者全局变量所在源代码文件，没有被编译、连接，或者干脆还没有定义，这需要使用者根据实际情况修改源程序，给出全局变量或者函数的定义体；二是未定义的符号是一个标准的库函数，在源程序中使用了该库函数，而连接过程中还没有给定相应的函数库的名称，或者是该档案库的目录名称有问题.

一般情况下，ARM生成将比模拟器（wins）生成更加困难，并且通常在第一次尝试时gcc会产生额外编译器错误和警告，因为gcc在一般情况下比microsoft编译器更为严格。

答疑：（此处参考bruce文章）标准头文件都有类似以下的结构
#ifndef _TEST_H
#define _TEST_H
#ifdef __cplusplus
extern "C" {
#endif
/*...*/
#ifdef __cplusplus
}
#endif
#endif /* _TEST_H */
分析，头文件中的编译宏“#ifndef _TEST_H、#define _TEST_H、#endif” 的作用是防止该头文件被重复引用。
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 语言方式编译和连接的；
未加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"通常的使用技巧。
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;
}
如果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 "cExample.h" */
extern int add( int x, int y );
int main( int argc, char* argv[] )
{
add( 2, 3 );
return 0;
}