Chapter 1 Introduction to C++ Libraries

The C++ class libraries are modular components of reusable code. Using class libraries, you can integrate blocks of code that have been previously built and tested.

A C++ library consists of one or more header files and an object library. The header files provide class and other definitions needed to access the library functions. The object library provides compiled functions and data that are linked with your program to produce an executable program.

This manual describes two class libraries provided with the C++ compiler:

• Complex numbers, described in Chapter 2

• Iostreams, described in Chapter 3

  For a discussion of building shared and static libraries, and using libraries, see the C++ User's Guide.

Other Libraries

In addition to the Complex and Iostreams libraries, this release provides the C++ Standard library, the Tools.h++ library, and the Sun WorkShop Memory Monitor library.

The C++ Standard Library

The C++ Standard Library (libCstd) is based on the RogueWave(TM) Standard C++ Library, Version 2.0.1. This library is available only for the default mode (-compat=5) of the compiler and is not supported with use of the -compat or -compat=4 options. For details, see the Standard C++ Library User's Guide, the Standard C++ Library User's Guide, and the Standard C++ Class Library Reference.

Tools.h++ Library

Tools.h++ is a C++ foundation class library from RogueWave. Version 7.0.7 of this library is provided with this release. For information on using this library in the default mode of the compiler, see the C++ Users Guide.

For further information about this library, see:

• Tools.h++ User's Guide (Version 7.0.7)

• Tools.h++ Class Library Reference (Version 7.0.7)

Man Pages for the Libraries

The man pages associated with the libraries described in this manual are located in:

install-directory/SUNWspro/man/man3

install-directory/SUNWspro/man/man3cc4

install-directory/SUNWspro/man/man3c++

where the default install-directory is /opt.

To access these man pages, ensure that your MANPATH includes install-directory/SUNWspro/man (see the Sun WorkShop Quick Install).

To access man pages for the Sun WorkShop Compiler C++ 4.2 libraries, type:

man -s 3CC4 library-name

To access man pages for the Sun WorkShop Compiler C++ 5.0 libraries, type:

man library-name

Sun WorkShop Memory Monitor

The Sun WorkShop Memory Monitor provides facilities to automatically report and fix memory leaks, memory fragmentation, and premature frees. It has three modes of operation:

• Debugging

• Deployment

• Garbage collection

These modes are dependent on the library you link your application with.

The components of the Sun WorkShop Memory Monitor are:

• libgc--the library used in garbage collection and deployment modes

• libgc_dbg--the library used in memory debugging mode

• gcmonitor--the daemon used in memory debugging mode

For complete documentation on the Sun WorkShop Memory Monitor, see /install-directory/SUNWspro/SC5.0/htmldocs/locale/C/gc/index.html, where the default install-directory is /opt.

Man pages for the Sun WorkShop Memory Monitor are located in:

install-directory/SUNWspro/man/man1

install-directory/SUNWspro/man/man3

where the default install-directory is /opt.