4.5 Compiling in Windows with MSVC

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

4.5.1 Using a Static Version of Analytics.h++ (MSVC)

Before starting, be sure that the Microsoft environment variables PATH, INCLUDE, and LIB are set to the proper search path for the Microsoft compiler, the system #include header files, and the libraries, respectively.

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 our Analytics.h++ header files are located in c:\rwav\workspaces\WINNT4\MSVC60\4s, and that we built static versions of Analytics.h++, Tools.h++, Math.h++, and LAPACK.h++, named, respectively, ana4s.lib, tls4s.lib, mth4s.lib, and, for LAPACK.h++, the three libraries lpk4s.lib, laf4s.lib, and bla4s.lib. Then we can compile myapp.cpp with the Microsoft C++ compiler with the following command (all on one line):

cl -Ic:\rwav\workspaces\WINNT4\MSVC60\4s myapp.cpp 
     c:\rwav\workspaces\WINNT4\MSVC60\4s\lib\ana4s.lib
     c:\rwav\workspaces\WINNT4\MSVC60\4s\lib\lpk4s.lib
     c:\rwav\workspaces\WINNT4\MSVC60\4s\lib\laf4s.lib
     c:\rwav\workspaces\WINNT4\MSVC60\4s\lib\bla4s.lib
     c:\rwav\workspaces\WINNT4\MSVC60\4s\lib\mth4s.lib
     c:\rwav\workspaces\WINNT4\MSVC60\4s\lib\tls4s.lib user32.lib

This command will compile and link in one step.

The -I option tells the compiler where to find the Rogue Wave header files.
The paths c:\rwav\workspaces\WINNT4\MSVC60\4s\lib\tls4s.lib and so on are the full path names for no standard library, no debugging, multithreaded, static Tools.h++ and Analytics.h++ libraries for MSVC (substitute as appropriate).
The user32.lib is the library for message-boxes and other widgets.

NOTE: Even if you are compiling a Analytics.h++ Windows NT or Windows 95 console program, you still need to link in the user32.lib library, because Tools.h++ uses the Windows message box to report errors.

4.5.2 Using a Dynamic Version of Analytics.h++ (MSVC)

Microsoft Visual C++ allows you to create a Analytics.h++ DLL under Windows 95 and Windows NT.

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

Use the Microsoft runtime DLL.
Use the DLL version of Tools.h++, Math.h++, and LAPACK.h++.
Define the macros _RWTOOLSDLL, RW_THR_DYNAMIC_BINDING, _RWMATHDLL and _RWLAPACKDLL on the compiler command line. This tells the header files to configure for dynamic linking. If Analytics.h++ is also using the Standard C++ Library, you must also define _RWSTDDLL. See the Tools.h++ Getting Started guide for more information on using the Standard C++ Library with Tools.h++.
Use the -MD or -MDd option on the compiler command line in order to use the release or debug version, respectively, of the Microsoft runtime library DLL.
You must link your program with the Tools.h++, Math.h++, LAPACK.h++, and Analytics.h++ import libraries. Example names of the import libraries are:

Release Version (no symbolic debugging or assertions):

Analytics.h++: ana4d.lib

LAPACK.h++: lpk4d.lib, laf4d.lib, and bla4d.lib

Math.h++: mth4d.lib

Tools.h++: tls4d.lib

Microsoft runtime library: msvcrt.lib

Debug Version (with symbolic debugging and assertions):

Analytics.h++: ana7d.lib

LAPACK.h++: lpk7d.lib, laf7d.lib, and bla7d.lib

Math.h++: mth7d.lib

Tools.h++: tls7d.lib

Microsoft runtime library: msvcrt.lib

The Analytics.h++ DLL is ana<build#>d.dll. See Section 2.4 for information on build numbers. Check the Tools.h++ Build Guide or Standard C++ Library Build Guide for the name of the DLL file.

When you run your program, the Analytics.h++, Tools.h++, Standard C++ Library, and Microsoft runtime library DLLs must be in one of the following places:

the current directory
the \WINDOWS or \WINNT directory
the \WINDOWS\SYSTEM or \WINNT\SYSTEM32 directory
the directory containing the executable file for the current task
the directories listed in the PATH environment variable
the list of directories mapped in your network search paths

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 your path.

4.5.3 Compiling from Microsoft Visual Studio

To build a program that uses Analytics.h++ under the Microsoft Visual Studio development environment, you must add the Rogue Wave include path, such as <rw_root>\workspaces\WINNT<ver>\MSVC<ver>\<buildtype>, to your studio configuration. Use the menu selection Tools | Options... to bring up the options dialog. Select the Directories tab, select Include Files from the Show Directories For: drop-down box, and add the necessary include paths.

You will also need to define any macros and compiler switches required to use a particular configuration of the Analytics.h++, Math.h++, and LAPACK.h++, and Tools.h++ products.

See the Microsoft Visual Studio help system for instructions on making changes to a project configuration.