test

C++ User's Guide

Preface

This manual instructs you in the use of the C++ 5.0 compiler, and provides detailed information on command-line compiler options.

Who Should Use This Book

This manual is intended for programmers with a working knowledge of C++ and some understanding of the Solaris(TM) operating environment and UNIX\256 commands.

How This Book Is Organized

This book contains the following chapters:

Chapter 1, "The C++ Compiler," gives an overview of the C++ compiler.

Chapter 2, "Using the C++ Compiler," provides instructions for invoking the compiler and generally discusses the compilation process.

Chapter 3, "C++ Compiler Options," explains the C++ compiler options in detail and provides task-oriented option groupings.

Chapter 4, "Using Templates," discusses use of templates, including template compilation, definition searching, and instance linkage.

Chapter 5, "Using Libraries," explains how to use the many C++ libraries.

Chapter 6, "Building Libraries," reviews the library-building process.

Multiplatform Release

The Sun(TM) WorkShop(TM) C++ compiler documentation applies to the release of the C++ compiler on Solaris 2.5.1, 2.6, and Solaris 7 operating environments on:

C++ Compiler Related Books

The following books are part of the C++ 5.0 documentation package.

Other Sun WorkShop Books

The following books are part of the Sun Visual WorkShop C++ documentation package:

Solaris Books

The following Solaris manuals provide additional useful information:

Commercially Available Books

The following is a partial list of available books on the C++ language.

Object-Oriented Analysis and Design with Applications, Second Edition, Grady Booch (Addison-Wesley, 1994).

Thinking in C++, Bruce Eckel (Prentice Hall, 1995).

The Annotated C++ Reference Manual, Margaret A. Ellis and Bjarne Stroustrup (Addison-Wesley, 1990).

Design Patterns: Elements of Reusable Object-Oriented Software, Erich Gamma, Richard Helm, Ralph Johnson and John Vlissides, (Addison-Wesley, 1995).

C++ Primer, Third Edition, Stanley B. Lippman and Josee Lajoie (Addison-Wesley, 1998).

Effective C++-50 Ways to Improve Your Programs and Designs, Second Edition, Scott Meyers (Addison-Wesley, 1998).

More Effective C++-35 Ways to Improve Your Programs and Designs, Scott Meyers (Addison-Wesley, 1996).

STL Tutorial and Reference Guide-Programming with the Standard Template Library, David R. Musser and Atul Saini (Addison-Wesley, 1996).

C++ for C Programmers, Ira Pohl (Benjamin/Cummings, 1989).

The C++ Programming Language, Third Edition, Bjarne Stroustrup (Addison-Wesley, 1997).

Ordering Sun Documents

The SunDocsSM program provides more than 250 manuals from Sun Microsystems, Inc. If you live in the United States, Canada, Europe, or Japan, you can purchase documentation sets or individual manuals using this program.

For a list of documents and how to order them, see the catalog section of the SunExpress(TM) Internet site at http://www.sun.com/sunexpress.

Accessing Sun Documents Online

Sun WorkShop documentation is available online from several sources:

Using the docs.sun.com Web site

The docs.sun.com Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://docs.sun.com.

Accessing AnswerBook2 Collections

The Sun WorkShop documentation is also available using AnswerBook2 software. To access the AnswerBook2 collections, your system administrator must have installed the AnswerBook2 documents during the installation process (if the documents are not installed, see your system administrator or Chapter 3 of Sun WorkShop Quick Install for installation instructions). For information about accessing AnswerBook2 documents, see Chapter 6 of Sun WorkShop Quick Install, Solaris installation documentation, or your system administrator.

Note -

To access AnswerBook2 documents, Solaris 2.5.1 users must first download AnswerBook2 documentation server software from a Sun Web page. For more information, see Chapter 6 of Sun WorkShop Quick Install.

Accessing HTML Documents

The following Sun Workshop documents are available online only in HTML format:

To access these HTML documents:

  1. Open the following file through your HTML browser:

    install-directory/SUNWspro/DOC5.0/lib/locale/C/html/index.html

    Replace install-directory with the name of the directory where your Sun WorkShop software is installed (the default is /opt).

    The browser displays an index of the HTML documents for the Sun WorkShop products that are installed.

  2. Open a document in the index by clicking the document's title.

Accessing Sun WorkShop Online Help and Release Notes

This release of Sun WorkShop includes an online help system as well as online manuals. To find out more see:

Online Books

The docs.sun.com Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://docs.sun.com/.

The Sun WorkShop documentation is also available using AnswerBook(TM) software. To access the AnswerBook collections, your system administrator must have installed the AnswerBook package during the installation process. For information on installing and accessing AnswerBook software see the Sun WorkShop installation documentation, the Solaris installation documentation, or your system administrator.

This release of Sun WorkShop includes an online help system as well as online manuals. To find out more, see:

What Typographic Changes Mean

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions

Typeface or Symbol 

Meaning 

Example 

AaBbCc123

The names of commands, files, and directories; on-screen computer output. 

Edit your .login file.

Use ls -a to list all files.

machine_name% You have mail.

 

AaBbCc123

What you type, contrasted with on-screen computer output. 

machine_name% su

Password:

AaBbCc123

Command-line placeholder: 

replace with a real name or value. 

To delete a file, type rm filename.

AaBbCc123

Book titles, new words or terms, or words to be emphasized. 

Read Chapter 6 in User's Guide. These are called class options.

You must be root to do this.

Compiler options and code samples may use the following conventions: 

[ ]

 

Square brackets contain arguments that are optional. 

-xO[n]

 

( ) 

Parentheses contain a set of choices for a required option. 

-d(y|n)

|

 

The "pipe" or "bar" symbol separates arguments, only one of which may be used at one time. 

-d(y|n)

 

...

 

The ellipsis indicates omission in a series. 

-xinline=f1[,...fn]

 

%

 

The percent sign indicates the word has a special meaning.  

-ftrap=%all, no%division

 

<>

 

In ASCII files, such as the README file, angle brackets contain a variable that must be replaced by an appropriate value.

-xtemp=<dir>

 

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P-2 System Prompts

Shell 

Prompt 

C shell prompt 

machine_name%

C shell superuser prompt 

machine_name#

Bourne shell and Korn shell prompt 

$

Bourne shell and Korn shell superuser prompt 

#