在 Borland C++ 及 Visual C++ 环境中使用 STLport (作者:孟岩)

侯捷注:本文承作者孟岩先生应允,
转载於此以飨*读者,非常感谢。

未得孟岩先生之同意,任何人请勿将此文再做转载。

以下红色为译注,紫色为侯捷个人认为宜再斟酌之处。
浅蓝色是侯捷个人阅读时的神秘标记。

本繁体文系直接转码,并未将大陆惯用术语转换为*惯用术语。

STL是一个标准,各商家根据这个标准开发了各自的STL版本。而在这形形色色的STL版本中,SGI STL无疑是最引人瞩目的一个。这当然是因为这个STL产品系出名门,其设计和编写者名单中,Alexander Stepanov和Matt Austern赫然在内,有两位大师坐镇,其代码水平自然有了最高的保证。SGI STL不但在效率上一直名列前茅,而且完全依照ISO C++之规范设计,使用者尽可放心。此外,SGI STL做到了thread-safe, 还体贴地为用户增设数种组件,如hash, hash_map,hash_multimap, slist和rope容器等等。因此无论在学习或实用中,SGI STL应是首选。

无奈,SGI STL本质上是为了配合SGI自作的UNIX变体IRIX所量身定做,其它平台上的C++编译器想使用SGI STL,都需要一番周折。着名的GNU C++虽然也使用 SGI STL,但在发行前已经过调试整合。普通的用户,特别是Windows平台上的BCB/VC用户要想使自己的C++编译器与SGI STL共同工作,可不是一件容易的事情。好在英雄总能及时出现,俄国人Boris Fomitchev注意到这个问题之後,建立了一个free的项目,称为STLport,旨在将SGI STL的基本代码移植到各种主流编译环境中,使各种编译器的用户都能够享受到SGI STL带来的先进之处。STLport 发展过程中,曾受到Matt Austern的亲切指导,发展到今天,已经比较成熟。最新的STLport 4.0,可以从www.stlport.org免费下载,zip文件体积约1.2M, 可以支持向各种主流C++编译环境的移植。BCB及VC当然算是主流的编译环境,自然得到STLport的关照。但据笔者实践来看,配置过程中还有一些障碍需要跨越,本文即旨在详细指导读者在Borland C++Builder 5.5及Visual C++ 6.0 环境中配置STLport。


首先请从www.stlport.org中下载STLport 4.0的ZIP文件,文件名stlport-4.0.zip. 然後利用WinZip等工具展开。生成stlport-4.0目录,该目录中有且仅有一个子目录,名称亦为stlport-4.0,不妨将整目录拷贝到你以为合适的位置,然後改一个合适的名字,例如配合BCB的,可以叫STL4BC,等等。

下面分成BCB/VC两种情形来描述具体过程。


Borland C++Builder 5

Borland C++Builder5中所带之C++编译器是5.5版本,在当前较主流的Windows平台编译器中,对於ISO C++ Standard的支持是最完善的。用它来配合SGI STL相当方便,也是笔者推荐之选。没有此开发工具的读者,可以到www.borland.com上免费下载Borland C++ 5.5编译器的一个精装版,该精装版体积为8.54M,名称 freecommandlinetools1.exe,乃一自解压安装文件。可在Windows中执行它,
安装到合适的目录中。展开後体积50M。

以下描述中,假定你使用的Windows装在C:\Windows目录。如果你有BCB5,我假设装在C:\Program Files\Borland\CBuilder5;如果你没有BCB5,而是使用上述的精简版BCC,则假设安装在C:\BCC55目录中,而STLport原包置于C:\STL4BC。

C:\STL4BC中应该有以下内容:
<目录> doc
<目录> lib
<目录> src
<目录> stlport
<目录> test
文件 ChangLog
文件 Install
文件 Readme
文件 Todo

同时确保C:\Program Files\Borland\CBuilder5\Bin或C:\BCC55\Bin在你的Path环境变量中。

笔者推荐你在安装之前读一读Install文件,其中会讲到如何避免使用SGI提供的iostream库。如果你不愿意使用SGI iostream,STLport会在原来编译器自带的iostream库外加一个 wrapper,使之能与SGI STL共同合作。不过SGI提供的iostream库标准化程度好,跟本家的 STL代码配合起来速度也快些,所以笔者实在想不出什麽理由不使用它,在这里假定大家跟笔者一样,乐于使用SGI iostream库。有不同看法者尽可以按照Install文件的说法调整。

下面一步步来:

0. 本次配置任务均在DOS命令状态下完成,请先从“开始”-->“附件”菜单中选中MS-DOS方式,打开一个DOS窗口。

1. 到C:\Program Files\Borland\CBuilder5\bin中,利用你顺手的文本编辑器修改两个文件:

file1: bcc32.cfg,改成:

-I"C:\STL4BC\stlport";\ 
"C:\Program Files\Borland\CBuilder5\Include";\
"C:\Program Files\Borland\CBuilder5\Include\vcl"
-L"C:\STL4BC\LIB";\
"C:\Program Files\Borland\CBuilder5\Lib";\
"C:\Program Files\Borland\CBuilder5\Lib\obj";\
"C:\Program Files\Borland\CBuilder5\Lib\release"

上面为了方便阅读用"\"符号将很长的一行折行,实际文件应该只有两行。

file2: ilink32.cfg,改成:

-L"C:\STL4BC\LIB";\
"C:\Program Files\Borland\CBuilder5\Lib";\
"C:\Program Files\Borland\CBuilder5\Lib\obj";\
"C:\Program Files\Borland\CBuilder5\Lib\release"

在C:\BCC55\BIN目录中,不存在这两个文件,请你自己用文字编辑器手工做出这两个文件来,内容与上面有所不同,如下

file1: bcc32.cfg,内容:

-I"C:\STL4BC\stlport";"C:\BCC55\Include";
-L"C:\STL4BC\LIB";"C:\BCC55\Lib";

file2: ilink32.cfg,内容:

-L"C:\STL4BC\LIB";"C:\BCC55\Lib";

2. 进入到C:\STL4BC\SRC目录中。

3. 执行命令copy bcb5.mak Makefile

4. 执行命令make clean all

这个命令会执行很长时间,尤其在老旧机器上,可能运行30分钟以上。屏幕不断地在显示
工作情况,有时你会看到好像计算机在反复地做同样几件事,请保持耐心,这实际上是在
以不同编译开关建立不同性质的目标库。

5. 经过一段漫长的编译之後, 终於结束了。现在你再执行命令 make install 这次需要的时间不长。

6. 来到C:\STL4BC\LIB目录,执行
copy *.dll c:\windows\system;

7. OK,大功告成。下面一步应该是检验一下事不是真的用上了SGI STL。rope是SGI STL提供的一个特有容器,专门用来对付超大规模字符串(string是细弦,而rope是粗绳子,可以想见rope的能力有多强)。

下面这个程序有点暴殓天物,不过也可以做一个小试验了:

//issgistl.cpp
#include <iostream>
#include <rope>

using namespace std;

int main()
{
     // crope就是容纳char类型字符的rope容器
     crope bigstr1("It took me about one hour ");
     crope bigstr2("to plug the STLport into Borland C++!");
     crope story = bigstr1 + bigstr2;
     cout << story << endl;
     return 0;
}
//~issgistl.cpp

编译 bcc32 issgistl.cpp

咦,怪哉,linker报告说找不到stlport_bcc_static.lib,到C:\STL4BC\LIB看个究竟,确实并没有这个文件,倒是有一个stlport_bcb55_static.lib。笔者发现这是STLport的一个小问题,需要将库文件的名字做一点改动:

copy stlport_bcb55_static.lib stlport_bcc_static.lib

这做法比较稳妥,原来的stlport_bcb55_static.lib也保留下来。以其他选项进行编译时,还可能会遇到类似的问题,只要照葫芦画瓢该名字就没问题了。

现在再编译,应该没问题了。可能有一些warning,没有关系。只要能运行,就说明rope容器起作用了,也就是说你的SGI STL开始工作了。

Microsoft Visual C++ 6.0:

Microsoft Visual C++ 6.0是当今Windows下C++编译器主流中的主流,但是对於ISO C++的支持并不尽如人意。其所配送的STL性能也比较差。不过既然是主流,STLport自然不敢怠慢,下面介绍VC中的STLport配置方法。

以下描述中,假定你使用的Windows装在C:\Windows目录。VC装在 C:\Program Files\Microsoft Visual Studio\VC98;而STLport原包置于C:\STL4VC。

C:\STL4VC中应该有以下内容:

<目录> doc
<目录> lib
<目录> src
<目录> stlport
<目录> test
文件 ChangLog
文件 Install
文件 Readme
文件 Todo

同时确保C:\Program Files\Microsoft Visual Studio\VC98\bin在你的Path环境变量中。

下面一步步来:

0. 本次配置任务均在DOS命令状态下完成,请先从“开始”-->“附件”菜单中选中MS-DOS方式,打开一个DOS窗口。

1. 到C:\Program Files\Microsoft Visual Studio\VC98中,利用你顺手的文本编辑器修改两个文件vcvars32.bat,其中有两行

set INCLUDE=%MSVCDir%\ATL\INCLUDE;%MSVCDir%\INCLUDE;%MSVCDir%\MFC\INCLUDE;%INCLUDE%
set LIB=%MSVCDir%\LIB;%MSVCDir%\MFC\LIB;%LIB%

改成:

set INCLUDE=C:\STL4VC\stlport;%MSVCDir%\ATL\INCLUDE;%MSVCDir%\INCLUDE;\
%MSVCDir%\MFC\INCLUDE;%INCLUDE%
set LIB=C:\STL4VC\lib;%MSVCDir%\LIB;%MSVCDir%\MFC\LIB;%LIB%

上面为了方面阅读用 "\" 符号将过长的一行折成两行,实际文件中还是一行。

修改完毕後保存,然後执行命令vcvars32。一切顺利的话应该给出一行结果:

Setting environment for using Microsoft Visual C++ tools.

如果你预设的DOS环境空间不足,这个BAT文件执行中可能导致环境空间overflow,此时应该在DOS窗口的“属性”对话框中找到“内存”页,修改“初始环境”ComboBox,改为一个较大的值,如1280或2048。然後再次开一个DOS窗口,运行vcvars32.bat。

2. 进入到C:\STL4VC\SRC目录中。

3. 执行命令copy vc6.mak Makefile

4. 执行命令make clean all

如果说BCB编译STLport的时间很长,那麽VC编译STLport的过程就更加漫长。屏幕反反复复地显示似乎是同样的内容,请务必保持耐心,这实际上是在以不同编译开关建立不同性质的目标库。

5. 经过一段漫长的编译之後, 终於结束了。现在你再执行命令

make install

这次需要的时间不那麽长,但也要有点耐心。

6. OK,大功告成。下面一步应该是检验一下事不是真的用上了SGI STL。跟上面BCB的过程差不多,找一个使用了SGI STL特性的程序,比如使用rope, slist, hash_set, hash_map等容器的程序来编译。注意,编译时务必使用下面的格式:

cl /GX /MT program.cpp

SGI STL中大量使用try..throw..catch,VC缺省情况下不支持此语法,/GX是要求VC++ Compiler打开对异常处理语法的支持。/MT则是要求VC的linker本程序obj文件与libcmt.lib连接在一起,因为SGI STL是thread-safe的,必须以multi-thread形式运行。

若要在图形界面中使用SGI STL,可在VC中调整Project-->Setting(Alt+F7), 设置编译选项,注意使用/MT和/GX,并且引入选项/Ic:\stl4vc\stlport及/libpath:c:\stl4vc\lib。

整个过程在笔者的老式Pentium 150机器上运行了超过3小时,读者的机器想必快得多,但也必然会花去出乎你意料的时间。全部完成後,C:\STL4VC这个目录的体积也由原来的区区4.4M膨胀到可怕的333M,当然这其中有300M是编译过程中产生的.obj文件,如果你确信自己的STLport工作正常的话,可以删掉它们,省出硬盘空间。不过这样一来,下次若再编译,就只好再等很长时间。

另外,据笔者勘察,STLport 4.0所使用的SGI STL并非最新问世的SGI STL3.3版本,不知道把SGI STL3.3的代码导入STLport会有何效果,有兴趣的读者不妨一试。

大致情形就是这样,现在,套用STLport自带文件的结束语:

Have fun!

孟岩
2001-3-11

在 Borland C++ 及 Visual C++ 环境中使用 STLport (作者:孟岩)

上一篇:c语言,string库函数itoa实现:将int转换为char*


下一篇:python 模拟登录博客园并且自动发布一篇文章