Compaq C++ User Documentation — C++ 6.2

United States

Compaq C++

Using Compaq C++ for Tru64 UNIX

Order Number: AA-PX2BJ-TE

April 1999

This manual contains information about developing Compaq C++ programs on Compaq Tru64 UNIX systems. It describes language features specific to Compaq C++ for Tru64 UNIX.

Revision/Update Information: This is a revised manual, replacing AA-PX2BH-TE

Software Version: Compaq C++ Version 6.2 for Tru64 UNIX

Compaq Computer Corporation
Houston, Texas

First Printing, March 1993
First Revision, May 1994
Second Revision, July 1994
Third Revision, May 1995
Fourth Revision, March 1996
Fifth Revision, October 1996
Sixth Revision, June 1997
Seventh Revision, December 1997
Eighth Revision, March 1999
Ninth Revision, July 1999

The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document.

The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license.

Compaq, the Compaq logo, and Alpha, DEC, DEC FUSE, DECthreads, DECwindows, DIGITAL, Ladebug, OpenVMS, Tru64 UNIX, ULTRIX, VAX, and VMS are registered in the U.S. Patent and Trademark Office.

The following are third-party trademarks:

AT&T is a registered trademark of American Telephone and Telegraph Company.

Hewlett-Packard is a registered tradmark of the Hewlett-Packard Company.

IEEE is a registered trademark of the Institute of Electrical and Electronics Engineers, Inc.

Microsoft and Visual C++ are trademarks of Microsoft Corporation.

OSF/1 is a registered tradmark of the Open Software Foundation, Inc.

POSIX is a registered certification mark of the Institute of Electrical and Electronic Engineers.

UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd.

All other trademarks and registered trademarks are the property of their respective holders.

Portions of the ANSI C++ Standard Library have been implemented using source licensed from and copyrighted by Rogue Wave Software, Inc.

This document is available on CD-ROM.

Contents

Index

Preface

This manual contains information for developing and debugging Compaq C++ programs on Tru64 UNIX systems, and includes information on other Tru64 UNIX features and tools that work with Compaq C++.

Intended Audience

This manual is intended for experienced programmers who need to develop Compaq C++ programs on Tru64 UNIX systems. Users of this manual should have a basic understanding of the C++ language and some familiarity with the Tru64 UNIX operating system.

Structure of this Document

This manual is organized as follows:

Chapter 1 shows how to create, compile, link, and run Compaq C++ programs.
Chapter 2 describes features and characteristics that are specific to the Compaq C++ implementation.
Chapter 3 describes how to modify existing C header files to be accepted by Compaq C++.
Chapter 4 contains tips for moving applications built with other C++ implementations to Compaq C++.
Chapter 5 describes how to use templates with Compaq C++.
Chapter 6 describes how to use precompiled headers with Compaq C++.
Chapter 7 describes the Compaq C++ implementation of the C++ Standard Library.
Chapter 8 explains how to use C++ exception handling.
Chapter 9 describes how to use the Ladebug debugger.
Appendix A describes Class Library restrictions.
Appendix B describes built-in functions.
Appendix C describes Third Degree messages generated by the C++ Class and Standard Libraries.
The cxx(1) reference page describes command line options.

Associated Documents

The following documents contain information associated with topics in this manual:

Stroustrup, Bjarne. The C++ Programming Language, 3rd Edition. Reading, Massachusetts: Addison-Wesley, 1997.
Provides an exhaustive introduction to the C++ programming language, including sophisticated language features. This book also includes the text but not the annotations of The Annotated C++ Reference Manual.
C++ Class Library Reference Manual
This manual describes the class library packages supplied with Compaq C++.
Compaq C++ Installation Guide for Tru64 UNIX
This document supplies the information necessary to install Compaq C++.
The AT&T C++ Language System, Release 2.0, Library Manual
This document describes the AT&T class library package.

Conventions Used in this Manual

Table 1 lists the conventions used in this manual.

**Table 1 Conventions Used in this Manual**
Convention	Meaning
`%`	A percent sign (%) is the default user prompt.
`class complex {` . . . `};`	A vertical ellipsis indicates that some intervening program code or output is not shown. Only the more pertinent material is shown in the example.
,...	A horizontal ellipsis in a syntax description indicates that you can enter additional parameters, options, or values. A comma preceding the ellipsis indicates that successive items must be separated by commas.
The `generic` class... The `get()` function...	Monospaced type denotes the names of Compaq C++ language elements, and also the names of classes, members, and nonmembers. Monospaced type is also used in text to reference code elements displayed in examples and file-name extensions.
italic	Italic type denotes the names of variables that appear as parameters or in arguments to functions, and also denotes book titles.
boldface	Boldface type in text indicates the first instance of terms defined in text.
UPPERCASE lowercase	The Tru64 UNIX operating system distinquishes between uppercase and lowercase characters. Literal strings that appear in text, examples, syntax descriptions, and function definitions must be entered exactly as shown.
`cxx` (1)	Cross-references to reference pages include the appropriate section number in parentheses.

Reader's Comments

You may send comments or suggestions regarding this manual, or any Compaq C++ document, by electronic mail to the following Internet address:

cxx_docs@zko.dec.com

Product Support

Support for Tru64 UNIX and C++ products is provided worldwide by Compaq MultivendorCustomer Services. To request information on support services in the United States and Canada, call toll-free

1.800.AT.COMPAQ (800-282-6672)

For information on support in other countries, contact your local customer services organization.

When reporting problems to Compaq, please provide the following information:

Name and version of compiler (from a listing file)
Name and version of operating system
Smallest possible complete source and commands needed to reproduce the problem
An example of the incorrect results and the desired results