Show: Object Pascal C++
Display Preferences

Boost Libraries

From Appmethod Topics
Jump to: navigation, search

Go Up to C++ Reference


Note: Appmethod C++ currently supports the use of the Boost Libraries on Windows (Win32 and Win64) and Mac OS X. Mobile platforms are not currently supported.

The Boost libraries are a set of C++ libraries that significantly expand the language using template metaprogramming. Subsets of Boost Version 1.39 and Version 1.55.0 are available for download by Appmethod customers. These versions have been fully tested and preconfigured specifically for Appmethod C++. You can install Boost from http://www.appmethod.com/

  • Binaries have been built for functions that require them.
  • Include paths have been set for the Boost libraries, and any necessary libraries should be automatically linked because of #pragma link lines in the Boost code.

Installing and Uninstalling the Boost Libraries

To download the Boost Libraries, visit http://appmethod.com and click the Download link at the upper right-hand corner. Then you can either sign up or log in using your EDN user ID, and locate the Boost Library download link. Boost Libraries are not installed during Appmethod installation.

Note about 64-bit Windows: For a 64-bit Windows Appmethod C++ installation, you need at least 4 Gigabytes of free disk space in order to ensure that the Boost Libraries are correctly installed.
  • For a 64-bit Windows install, you get both Boost 1.55.0 (for 64-bit Windows applications) and Boost 1.39 (for 32-bit Windows applications).
  • For Boost Version 1.39, separate libraries are installed for 32-bit Windows and for OS X.

To uninstall only the Boost libraries (not the entire product), you should run the Boost installer and choose the Remove option, as described in the following steps.

To uninstall only the Boost libraries (not the product):

  1. Open the Windows Control Panel.
  2. Choose Uninstall a program.
  3. Double-click Boost Libraries for Appmethod C++ <version>. The Boost installer starts.
  4. On the Welcome page of the Boost installer, choose the Remove option and click Next.
  5. On the Ready to Uninstall page, click Next.

Boost Libraries Installation Locations

The following table shows the Boost Libraries Versions that are used on specific target platforms and installed on specific development systems with Appmethod:

Boost Version Target Platform Development System

Boost version 1.39

  • 32-bit Windows target platform
  • Mac OS X target platform
  • 32-bit Windows development systems
  • 64-bit Windows development systems

Boost version 1.55.0

  • 64-bit Windows target platform
  • 64-bit Windows development systems

Boost Version 1.39

Include Directories

For Boost Version 1.39, the typical include directory is as follows:

C:\Program Files (x86)\Embarcadero\Studio\15.0\include\boost_1_39\boost

Run-Time Libraries

For the Windows target platform, the Boost Version 1.39 libraries are typically installed here:

C:\Program Files (x86)\Embarcadero\Studio\15.0\lib\Win32\release

For the Mac OS X target platform, the Boost Version 1.39 libraries are installed in the following directory:

C:\Program Files (x86)\Embarcadero\Studio\15.0\lib\osx32\release

Example File Names

For Boost Version 1.39 on Windows, the files themselves are too numerous to list, but these are the names of the Boost libraries for the OS X target platform:

libboost_date_time-bcb-mt-1_39.a
libboost_math_c99-bcb-mt-1_39.a
libboost_math_c99f-bcb-mt-1_39.a
libboost_regex-bcb-mt-1_39.a
libboost_signals-bcb-mt-1_39.a
libboost_system-bcb-mt-1_39.a

Libraries for the Win32 target platform have the file extension .lib.

Boost Version 1.55.0

Boost Version 1.55.0 is used only for the 64-bit Windows target platform.

Include Directory

For Boost Version 1.55.0, the typical include directory is:

C:\Program Files (x86)\Embarcadero\Studio\15.0\include\boost_1_55\boost

Run-Time Libraries

For the 64-bit target platform, the Boost Version 1.55.0 files are typically installed here:

C:\Program Files (x86)\Embarcadero\Studio\15.0\lib\win64\release

Example File Names

The files themselves for Version 1.55.0 are too numerous to list, but these are examples:

libboost_chrono-bcb64-1_55.a
libboost_date_time-bcb64-1_55.a
libboost_math_c99-bcb64-1_55.a
libboost_prg_exec_monitor-bcb64-1_55.a
libboost_random-bcb64-1_55.a
libboost_unit_test_framework-bcb64-1_55.a

Including the Boost Libraries for Windows

A C++ application uses the correct version of Boost to match the target platform for an application. For example, if your application has a 64-bit Windows target platform, Boost version 1.55.0 is used. If you set a 32-bit Windows or OS X target platform, Boost version 1.39 is used. (The term target platform means the current setting of the Target Platforms node in the Project Manager.)

In a Boost 1.39 installation, the Boost minmax extensions are installed in the algorithm directory. For example, to use minmax in an application that targets 32-bit Windows, your code should specify:

#include <boost/algorithm/minmax.hpp>

This command includes the minmax library that is part of the algorithm directory. The Boost 1.55.0 directory structure might be different.

The path to the Boost libraries is specified in the following environment variables in the IDE:

  • CG_BOOST_ROOT (for 32-bit Windows systems): C:\Program Files (x86)\Embarcadero\Studio\15.0\include\boost_1_39
  • CG_64_BOOST_ROOT (for 64-bit Windows systems): C:\Program Files (x86)\Embarcadero\Studio\15.0\include\boost_1_55

These variables are set on the Tools > Options > Environment Options > Environment Variables dialog box.

Including the Boost Libraries for Mac OS X Applications

For Mac OS X application development, you can use the Boost libraries for OS X, which are installed by default at:

C:\Program Files (x86)\Embarcadero\Studio\15.0\lib\osx32\release

With the OS X target platform, .a files are library files. For example, the C:\Program Files (x86)\Embarcadero\Studio\15.0\lib\osx32\release directory contains .a files such as date time, math_C99/math_c99f, regex, signals, and system. For exact information about the OS X Boost headers available to you, please explore the directories subordinate to your Boost installation directory.

Using the same #include command shown in the example above (for Windows) also includes the Boost Libraries for Mac OS X in your project.

Boost Documentation

To view the help for the Boost libraries, go to:

See Also

Personal tools
In other languages