C++ Library Reference

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 three class libraries provided with the C++ compiler:

• Complex numbers, described in Chapter 2
• iostreams, described in Chapter 3
• C++ standard library, described in Chapter 5

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

1.1 Man Pages

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. For instructions on setting your MANPATH, see Access to Sun WorkShop Development Tools in the preface.

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

example% man library-name

To access man pages for version 4.2 of the Sun WorkShop Compilers C++ libraries, type:

example% man -s 3CC4 library-name

You can also access the man pages by pointing your browser to:

file:install-directory/SUNWspro/docs/index.html

where the default install-directory is /opt.

1.2 Other Libraries

In addition to the complex, iostreams, and C++ standard libraries, this release provides the Tools.h++ library and the Sun WorkShop Memory Monitor library.

1.2.1 Tools.h++ Library

Tools.h++ is a C++ foundation class library from RogueWave. Version 7 of this library is provided with this release. For further information about this library, see:

• C++ Users Guide
• Tools.h++ User's Guide (Version 7)
• Tools.h++ Class Library Reference (Version 7)

1.2.2 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, launch the Memory Monitor or point your browser at the following file:

file:install-directory/SUNWspro/docs/index.html

Replace install-directory with the path to your Sun WorkShop installation directory. In a default installation, 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. 

TABLE 1-1   Man Pages for Sun WorkShop Memory Monitor

Man Page	Overview
gcmonitor	Web interface for Sun WorkShop Memory Monitor
gcFixPrematureFrees	Enable and disable fixing of premature frees by the Sun WorkShop Memory Monitor
gcInitialize	Configure Sun WorkShop Memory Monitor at startup