Order Number: AA--PY3FF--TK

This manual contains information about developing DIGITAL C++ programs on OpenVMS Alpha and describes related language features.

Revision/Update Information: This is a revised manual.

Operating System and Version: OpenVMS Alpha Version 6.2 to 7.2

Software Version: DIGITAL C++ Version 6.0 for OpenVMS Alpha

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.

No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies.

Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013.

Copyright ©1992, 1998

The following are trademarks of Digital Equipment Corporation: Alpha, DEC, DEC FUSE, DECthreads, Ladebug, OpenVMS, ULTRIX, VAX, VAX DOCUMENT, VMS, and the DIGITAL logo.

The following are third-party trademarks:

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

Hewlett-Packard is a registered trademark of Hewlett-Packard Company.

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

Microsoft is a registered trademark, and Visual C++ is a trademark of Microsoft Corporation.

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

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

Information pertaining to the C++ Standard Library has been edited and reprinted with permission of, Rogue Wave Software, Inc. All rights reserved.

Portions copyright 1994-1998 Rogue Wave Software, Inc.

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

ZK6024

This document is available on CD-ROM.

This document was prepared using VAX DOCUMENT, Version V3.2-1m.

Contents

Index

This manual contains information about developing and debugging DIGITAL C++ programs on OpenVMS Alpha, and includes information on other OpenVMS features and tools that work with DIGITAL C++.

Intended Audience

This manual is intended for experienced programmers who need to develop DIGITAL C++ programs on OpenVMS Alpha. Users of this manual should have a basic understanding of the C++ language and some familiarity with the DIGITAL Command Language (DCL).

Structure of this Document

This manual is organized as follows:

• Chapter 1 shows how to create, compile, link, and run DIGITAL C++ programs.
• Chapter 2 describes features and characteristics that are specific to the DIGITAL C++ implementation.
• Chapter 3 describes guidelines and procedures for customizing your language environment.
• Chapter 4 describes how to make code used with other C++ implementations acceptable to the DIGITAL C++ compiler.
• Chapter 5 describes how to use templates with DIGITAL C++.
• Chapter 6 explains how to use C++ exception handling.
• Chapter 7 describes the DIGITAL C++ implementation of the C++ Standard Library.
• Chapter 8 explains how to use the OpenVMS Debugger with DIGITAL C++.
• Appendix A provides information on using programming tools with DIGITAL C++.
• Appendix B describes built-in functions.

Associated Documents

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

• Stroustrup, Bjarne. The C++ Programming Language, 3nd Edition. Reading, Massachusetts: Addison-Wesley, 1997.
  This text combines a user guide and language reference manual. Where appropriate, section numbers shown in parentheses (for example, §r.2.3) refer to relevant portions of The C++ Programming Language, 3nd Edition.
• DEC C++ Class Library Reference Manual
  This manual describes a library of DIGITAL C++ classes.
• DIGITAL C++ Installation Guide for OpenVMS Alpha
  This document supplies the information necessary to install DIGITAL C++ on OpenVMS Alpha.
• DEC C Run-Time Library Reference Manual for OpenVMS Systems
  This library manual provides information, useful to DIGITAL C++ users, on the OpenVMS Run-Time Library (RTL) for DIGITAL C functions and macros, which include the ANSI C standard library. This manual also contains information about porting programs to and from other operating systems.

The C++ Programming Language, 3nd Edition and the STL Tutorial and Reference Guide are available only in printed form. Online copies are not available.

Related Documents

• Stroustrup, Bjarne. The C++ Programming Language, 3nd 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.
• Carroll, Martin D. and Margaret E. Ellis. Designing and Coding Reusable C++. Reading, Massachusetts: Addison-Wesley, 1995.
  This text provides practical information for designing and implementing C++ programs.
• Myers, Scott. Effective C++: 50 Specific Ways to Improve Your Programs and Designs, 3rd edition. Reading, Massachusetts: Addison-Wesley, 1997.
• Myers, Scott. More Effective C++: 35 New Ways to Improve Your Programs and Designs. Reading, Massachusetts: Addison-Wesley, 1995.
  These texts provide practical information for designing and implementing C++ programs.

Conventions Used in this Manual

Table 1 lists the conventions used in this manual.

Table 1 Conventions Used in this Manual

Convention	Meaning
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 DIGITAL 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.
italic	Italic type denotes the names of variables that appear as parameters or in arguments to functions, and also denotes file-name extensions and book titles.
boldface	Boldface type in text indicates the first instance of terms defined in text.

Reader's Comments

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

cxx_docs@bookie.enet.dec.com

Product Support

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

1--800--DIGITAL (800--344--4825)

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