Rogue Wave banner
Previous fileTop of DocumentContentsNext file

4.5 Compiling in Windows with Borland

This section describes how to use Borland's C++ compilers to compile programs that use Rogue Wave's Tools.h++ class library.

4.5.1 Using a Static Version of Tools.h++ (Borland)


NOTE: If you are compiling VCL applications, be sure to read the Borland notes in toolread.doc.

These instructions assume that the Borland include files and libraries are in the locations specified by the file bcc32.cfg for 32-bit compiles. If not, you will have to specify -I and -L flags as well, or change your configuration file. (See the Borland User's Guide for instructions.)

Let's say that we have a file named myapp.cpp and that we are compiling it in a Windows NT MS-DOS command prompt. Let's also say that the Tools.h++ header file include path is c:\rwav\workspaces\WINNT4\BORLANDC++_Builder_40\4s, and that we have built a static, multithreaded version of Tools.h++ named tls4s.lib. Then we can compile myapp.cpp with the Borland C++ compiler with the following command (all on one line):

This command will compile and link in one step.

4.5.2 Using a Dynamic Version of Tools.h++ (Borland)

Tools.h++ can be built as a DLL using Borland C++ under Windows 95 and Windows NT. Be sure to review the readme file for additional tips on using the DLL.

The dlldemo demonstration program is an example of using and linking with the DLL. It is in the <rw_root>\workspaces\<OS+ver>\<COMPILER+ver>\ <buildtype>\examples\tls<ver><osfam> directory. Additional tips on using the DLL are in the tooldll.doc readme file and in the Tools.h++ User's Guide section called "Dynamic Link Library."

To use the 32-bit DLL version of Tools.h++, you must:

  1. Use the Borland runtime library (RTL) DLL.

  2. Use the DLL version of Tools.h++.

  3. Define the macro _RWTOOLSDLL and _RTLDLL on the compiler command line. This tells the Tools.h++ header files to configure for dynamic linking. If Tools.h++ is also using the Standard C++ Library, you must also define _RWSTDDLL.

  4. Link your program with the Tools.h++ import libraries. The names of the import libraries are:

  5. When you run your program, it will search for the Tools.h++ DLL and the Borland RTL DLL in one of the following places and in the following order:

If you get exceptions, especially in *.DLLs, and you can't figure out where they're coming from, you may have incompatible *.DLLs running. Check for incompatible .DLLs in the directories indicated above.

4.5.3 Compiling from the Borland C++ IDE

When using the Borland C++ IDE, you must define the Rogue Wave include path, for example, <rw_root>\workspaces\WINNT4\BORLANDC++_Builder_30\4s, to every project. Use menu selection Options | Project | Directories.

You should also add the appropriate Tools.h++ library to your Project Window. See the Borland User's Guide for instructions.


Previous fileTop of DocumentContentsNext file

©Copyright 1999, Rogue Wave Software, Inc.
Contact Rogue Wave about documentation or support issues.