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 Math.h++ class library.

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

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 Math.h++ and Tools.h++ header file include path is

c:\rwav\workspaces\WINNT4\BORLANDC++_Builder_30\4s

and that we have built a static, multithreaded version of Math.h++ named mth4s.lib. Then we can compile myapp.cpp with the Borland C++ compiler with the following command (all on one line):

bcc32 -Ic:\rwav\workspaces\WINNT4\BORLANDC++_Builder_30\4s myapp.cpp
  c:\rwav\workspaces\WINNT4\BORLANDC++_Builder_30\4s\lib\tls4s.lib 
  c:\rwav\workspaces\WINNT4\BORLANDC++_Builder_30\4s\lib\mth4s.lib
  c:\rwav\workspaces\WINNT4\BORLANDC++_Builder_30\4s\lib\bla4s.lib

This command will compile and link in one step.

The -I option tells the compiler where to find the header files.

The paths:

c:\rwav\workspaces\WINNT4\BORLANDC++_Builder_30\4s\lib\tls4s.lib
c:\rwav\workspaces\WINNT4\BORLANDC++_Builder_30\4s\lib\mth4s.lib 
c:\rwav\workspaces\WINNT4\BORLANDC++_Builder_30\4s\lib\bla4s.lib

are the full path names for no standard library, no debugging, static Tools.h++, Math.h++, and BLA libraries for Borland C++. (Substitute as appropriate.)

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

Math.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.

To use the DLL version of Math.h++, you must:

Use the Borland runtime library (RTL) DLL.
Define the macros _RWMATHDLL, _RWTOOLSDLL, and _RTLDLL on the compiler command line. This tells the header files to configure for dynamic linking.
Link your program with the import libraries. Example import libraries names are:

Release Version (no symbolic debugging or assertions):

Math.h++: mth4d.lib

Borland runtime library: cw32imt.lib

Debug Version (with symbolic debugging and assertions):

Math.h++: mth7d.lib

Borland runtime library: cw32imt.lib

The Math.h++ DLL is mth61<build#>d.dll. Section 2.5 explains build numbers.

When you run your program, the Math.h++ DLL and the Borland RTL DLL must be in one of the following places:

the current directory
the \WINDOWS directory
the \WINDOWS\SYSTEM directory
the directory containing the executable file for your program
a directory listed in the PATH environment variable
the list of directories mapped in a network

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 Math.h++ library to your Project Window. See the Borland User's Guide for instructions.