C++ User's Guide

Symbols

! NOT operator, iostream, 1, 2

$ identifier, 1, 2

<< insertion operator

complex, 1

iostream, 1, 2

>> extraction operator

complex, 1

iostream, 1

__global, 1

__hidden, 1

__SUNPRO_CC, 1

__symbolic, 1

__thread, 1

_OPENMP preprocessor token, 1

Numerics

-386, compiler option, 1

-486, compiler option, 1

A

-a, compiler option, 1

.a, 1, 2, 3

absolute value, complex numbers, 1

accessible documentation, 1

aliases, simplifying commands with, 1

alignments

default, 1

strictest, 1

anachronisms, disallowing, 1

angle, complex numbers, 1

anonymous class instance, passing, 1

applications

linking multithreaded, 1, 2

MT-safe, 1

using MT-safe iostream objects, 1 - 2

applicator, parameterized manipulators, 1

arithmetic library, 1, 2 - 3

__ARRAYNEW, predefined macro, 1

assembler, compilation component, 1

assembly language templates, 1

assignment, iostream, 1

B

-Bbinding, compiler option, 1, 2 - 3

binary input, reading, 1

binary optimization, 1

bool type and literals, allowing, 1

_BOOL, predefined macro, 1

buffer

defined, 1

flushing output, 1

__BUILTIN_VA_ARG_INCR, predefined macro, 1

C

C API (application programming interface)

creating libraries, 1

removing dependency on C++ runtime libraries, 1

C standard library header files, replacing, 1

C++ man pages, accessing, 1, 2, 3

C++ standard library, 1 - 2

components, 1 - 2

man pages, 1, 2 - 3

replacing, 1 - 2

RogueWave version, 1

.c++, file name suffixes, 1

-c, compiler option, 1, 2

.C, file name suffixes, 1

.c, file name suffixes, 1

c_exception, complex class, 1

C99 support, 1

cache

directory, template, 1

used by optimizer, 1

cast

const and volatile, 1

dynamic, 1

casting down, 1

casting to void*, 1

casting up, 1

reinterpret_cast, 1

static_cast, 1

cc compiler options

-xdebugformat, 1

CC pragma directives, 1

.cc, file name suffixes, 1

CCadmin command, 1

CCFLAGS, environment variable, 1

cerr standard stream, 1, 2

-cg, compiler option, 1

char* extractor, 1 - 2

char, signedness of, 1

characters, reading single, 1

cin standard stream, 1, 2

class declaration specifier, 1

class instance, anonymous, 1

class libraries, using, 1 - 2

class templates, 1 - 2

See also templates

declaration, 1

definition, 1, 2

incomplete, 1

member, definition, 1

parameter, default, 1

static data members, 1

using, 1

classes

passing directly, 1

passing indirectly, 1

clog standard stream, 1, 2

code generation

inliner and assembler, compilation component, 1

options, 1

code optimization

by using -fast, 1

code optimizer, compilation component, 1

command line

options, 1, 2

recognized file suffixes, 1

-compat

compiler option, 1

default linked libraries, affect on, 1

-features option, value restrictions, 1

libraries, available modes for, 1

-library option, value restrictions, 1

linking C++ libraries, modes for, 1

compatibility mode

See also -compat

iostream, 1

libC, 1, 2

libcomplex, 1

Tools.h++, 1

compilation, memory requirements, 1 - 2

compiler

component invocation order, 1

diagnosing, 1 - 2

versions, incompatibility, 1

compiler commentary in object file, reading with er_src utility, 1

compilers, accessing, 1

compiling and linking, 1 - 2

complex

compatibility mode, 1

constructors, 1 - 2

efficiency, 1

error handling, 1 - 2

header file, 1

input/output, 1 - 2

library, 1 - 2, 3 - 4, 5 - 6

library, linking, 1

man pages, 1

mathematical functions, 1 - 2

mixed-mode, 1 - 2

operators, 1 - 2

standard mode and libCstd, 1

trigonometric functions, 1 - 2

complex number data type, 1

complex_error

definition, 1

message, 1

configuration macro, 1

conjugate of a number, 1

const_cast operator, 1

constant strings in read-only memory, 1

constructors

complex class, 1

iostream, 1

static, 1

copying

files, 1

stream objects, 1

cout, 1, 2, 3

__cplusplus, predefined macro, 1, 2, 3

.cpp, file name suffixes, 1

.cxx, file name suffixes, 1

D

-D, compiler option, 1, 2 - 3

+d, compiler option, 1

-d, compiler option, 1

-D_REENTRANT, 1

-dalign, compiler option, 1

data type, complex number, 1

__DATE__, predefined macro, 1

-DDEBUG, 1

debugger data format, 1

debugging

options, 1

preparing programs for, 1, 2

dec, iostream manipulator, 1

declaration specifiers

__global, 1

__hidden, 1

__symbolic, 1

__thread, 1

default libraries, static linking, 1

default operators, using, 1

definition included model, 1

definition separate model, 1

definitions, searching template, 1

delete array forms, recognizing, 1

dependency

on C++ runtime libraries, removing, 1

shared library, 1

destructors, 1, 2

dlclose(), 1, 2

dlopen(), 1, 2, 3, 4

dmesg, actual real memory, 1

documentation index, 1

documentation, accessing, 1

double, complex value, 1

-dryrun, compiler option, 1, 2

dwarf debugger-data format, 1

dynamic (shared) libraries, 1, 2, 3, 4

dynamic_cast operator, 1

E

-E compiler option, 1 - 2

+e(0|1), compiler option, 1

EDOM, errno setting, 1

elfdump, 1

endl, iostream manipulator, 1

ends, iostream manipulator, 1

enum

forward declarations, 1

incomplete, using, 1

scope qualifier, using name as, 1

environment variables

CCFLAGS, 1

LD_LIBRARY_PATH, 1, 2

PARALLEL, 1

RTLD_GLOBAL, 1

SUN_PROFDATA, 1

SUN_PROFDATA_DIR, 1

SUNWS_CACHE_NAME, 1

er_src utility, 1

ERANGE, errno setting, 1

errno, definition, 1 - 2

-erroff compiler option, 1

error

bits, 1

checking, MT-safety, 1

state, iostreams, 1

error function, 1

error handling

complex, 1 - 2

input, 1 - 2

error messages

compiler version incompatibility, 1

complex_error, 1

linker, 1, 2

-errtags compiler option, 1

-errwarn compiler option, 1

exceptions

and multithreading, 1

building shared libraries that have, 1

disabling, 1

disallowing, 1

functions, in overriding, 1

longjmp and, 1

predefined, 1

setjmp and, 1

shared libraries, 1

signal handlers and, 1

standard class, 1

standard header, 1

trapping, 1

explicit instances, 1 - 2

explicit keyword, recognizing, 1

export keyword, recognizing, 1

extension features, 1 - 2

allowing nonstandard code, 1

defined, 1

external

instances, 1

linkage, 1

extraction

char*, 1 - 2

defined, 1

operators, 1

user-defined iostream, 1 - 2

whitespace, 1

F

-fast, compiler option, 1 - 2

-features, compiler option, 1 - 2, 3, 4, 5, 6 - 7

file descriptors, using, 1 - 2

file names

.SUNWCCh file name suffix, 1 - 2

suffixes, 1

template definition files, 1

__FILE__, predefined macro, 1

files

See also source files

C standard header files, 1

copying, 1, 2

executable program, 1

multiple source, using, 1

object, 1, 2, 3

opening and closing, 1

repositioning, 1

standard library, 1

using fstreams with, 1

-filt, compiler option, 1

finalization functions, 1

-flags, compiler option, 1

float inserter, iostream output, 1

floating point

invalid, 1

options, 1

flush, iostream manipulator, 1, 2

-fnonstd, compiler option, 1

-fns, compiler option, 1

format control, iostreams, 1

Fortran runtime libraries, linking, 1

-fprecision=p, compiler option, 1 - 2

front end, compilation component, 1

-fround=r, compiler option, 1 - 2

-fsimple=n, compiler option, 1 - 2

-fstore, compiler option, 1

fstream, 1, 2, 3

fstream.h

iostream header file, 1

using, 1

-ftrap, compiler option, 1

__func__, identifier, 1

function

declaration specifier, 1

function templates, 1 - 2

See also templates

declaration, 1

definition, 1

using, 1

function-level reordering, 1

functions

in dynamic (shared) libraries, 1

inlining by optimizer, 1

MT-safe public, 1

overriding, 1

static, 1, 2

streambuf public virtual, 1

functions, name in __func__, 1

G

-G

dynamic library command, 1

option description, 1 - 2

-g

option description, 1

compiling templates using, 1

garbage collection

libraries, 1, 2

get pointer, streambuf, 1

get, char extractor, 1

global

data, in a multithreaded application, 1 - 2

instances, 1 - 2

linkage, 1 - 2

shared objects in MT application, 1

-gO option description, 1

gprof, C++ utilities, 1

H

-H, compiler option, 1

-h, compiler option, 1

hardware architecture, 1

header files

C standard, 1

complex, 1

creating, 1

idempotency, 1

iostream, 1, 2, 3

language-adaptable, 1

standard library, 1, 2 - 3

heap, setting page size for, 1

-help, compiler option, 1

hex, iostream manipulator, 1

I

-I, compiler option, 1, 2

-I-, compiler option, 1

-i, compiler option, 1

.i, file name suffixes, 1

I/O library, 1

__i386, predefined macro, 1

i386, predefined macro, 1

idempotency, 1

ifstream, 1, 2

.il, file name suffixes, 1

include directories, template definition files, 1

include files, search order, 1, 2

incompatibility, compiler versions, 1

initialization function, 1

inline expansion, assembly language templates, 1

inline functions

by optimizer, 1

C++, when to use, 1

-inline, See -xinline

input

binary, 1

error handling, 1 - 2

iostream, 1

peeking at, 1

input/output, complex, 1, 2 - 3

insertion

defined, 1

operator, 1 - 2

instance methods

explicit, 1

global, 1

semi-explicit, 1

static, 1

template, 1

instance states, consistent, 1

-instances=a, compiler option, 1 - 2, 3

instantiation

options, 1 - 2

template class static data members, 1

template classes, 1

template function members, 1

template functions, 1

-instlib, compiler option, 1

intermediate language translator, compilation component, 1

internationalization, implementation, 1

interprocedural analyzer, 1

interprocedural optimizations, 1

interval arithmetic libraries, linking, 1

iomanip.h, iostream header files, 1, 2

iostream

classic iostreams, 1, 2, 3

compatibility mode, 1

constructors, 1

copying, 1

creating, 1 - 2

defined, 1

error bits, 1

error handling, 1

extending functionality, MT considerations, 1

flushing, 1

formats, 1

header files, 1

input, 1

library, 1, 2 - 3, 4

using make with, 1

man pages, 1, 2

manipulators, 1

mixing old and new forms, 1

MT-safe interface changes, 1

MT-safe reentrant functions, 1

MT-safe restrictions, 1

new class hierarchy for MT, 1

new MT interface functions, 1 - 2

output errors, 1 - 2

output to, 1

predefined, 1 - 2

single-threaded applications, 1

standard iostreams, 1, 2, 3

standard mode, 1, 2, 3

stdio, 1, 2

stream assignment, 1

structure, 1 - 2

terminology, 1

using, 1

iostream.h, iostream header file, 1, 2

ISO C++ standard

conformance, 1

one-definition rule, 1, 2

ISO10646 UTF-16 string literal, 1

istream class, 1, 2

istrstream class, 1, 2

J

Java Native Interface, 1

JNI, 1

K

.KEEP_STATE, using with standard library header files, 1

-keeptmp, compiler option, 1

-KPIC, compiler option, 1, 2

-Kpic, compiler option, 1, 2

L

-L, compiler option, 1, 2

-l, compiler option, 1, 2, 3, 4

languages

C99 support, 1

options, 1

support for native, 1

LD_LIBRARY_PATH environment variable, 1, 2

ldd command, 1

left-shift operator

complex, 1

iostream, 1

lex, C++ utilities, 1

libC

compatibility mode, 1, 2

compiling and linking MT-safety, 1

library, 1 - 2

MT environment, using in, 1

new MT classes, 1

libc library, 1

libcomplex, See complex

libCrun library, 1, 2, 3, 4, 5

libCstd library, See C++ standard library

libcsunimath

library, 1

libdemangle library, 1 - 2

libgc library, 1

libiostream, See iostream

libm

inline templates, 1

library, 1

optimized version, 1

-libmieee, compiler option, 1

-libmil, compiler option, 1

libraries

building shared libraries, 1

C interface, 1

C++ compiler, provided with, 1

C++ standard, 1 - 2

class, using, 1

classic iostream, 1 - 2

configuration macro, 1

dynamically linked, 1

interval arithmetic, 1

linking options, 1, 2

linking order, 1

linking with -mt, 1

naming a shared library, 1

optimized math, 1

replacing, C++ standard library, 1 - 2

shared, 1 - 2, 3

suffixes, 1

Sun Performance Library, linking, 1, 2

understanding, 1 - 2

using, 1 - 2

libraries, building

dynamic (shared), 1 - 2

for private use, 1

for public use, 1

linking options, 1

shared with exceptions, 1

static (archive), 1 - 2

with C API, 1

-library, compiler option, 1 - 2, 3, 4 - 5

librwtool, See Tools.h++

libthread library, 1

licensing

options, 1

limit, 1, 2

__LINE__, predefined macro, 1

linker scoping, 1

linking

complex library, 1 - 2

consistent with compilation, 1 - 2

disabling system libraries, 1

dynamic (shared) libraries, 1, 2, 3

iostream library, 1

libraries, 1, 2, 3

library options, 1

-mt option, 1

MT-safe libC library, 1

separate from compilation, 1

static (archive) libraries, 1, 2, 3, 4, 5 - 6

symbolic, 1

template instance methods, 1

link-time optimization, 1

literal strings in read-only memory, 1

local-scope rules, enabling and disabling, 1

locking

See also stream_locker

mutex, 1, 2

object, 1 - 2

streambuf, 1

loops, 1

-lthread

suppressed by -xnolib, 1

using -mt in place of, 1, 2

M

macros

See also

predefined, 1

magnitude, complex numbers, 1

make command, 1 - 2

man pages

accessing, 1, 2

C++ standard library, 1 - 2

complex, 1

iostream, 1, 2, 3, 4

man pages, accessing, 1

manipulators

iostreams, 1 - 2

plain, 1

predefined, 1

MANPATH environment variable, setting, 1

math library, optimized version, 1

math.h, complex header files, 1

mathematical functions, complex arithmetic library, 1 - 2

-mc, compiler option, 1

member variables, caching, 1

memory requirements, 1 - 2

-migration, compiler option, 1

-misalign, compiler option, 1 - 2

mixed-language linking, 1

mixed-mode, complex arithmetic library, 1 - 2

-mr, compiler option, 1

-mt compiler option

and libthread, 1

linking libraries, 1

option description, 1

MT-safe

applications, 1

classes, considerations for deriving, 1

library, 1

object, 1

performance overhead, 1, 2

public functions, 1

multimedia types, handling of, 1

multiple source files, using, 1

multithreaded

application, 1

compilation, 1

exception-handling, 1

mutable keyword, recognizing, 1

mutex locks, MT-safe classes, 1, 2

mutual exclusion region, defining a, 1

N

namespace keyword, recognizing, 1

Native Connector Tool (NCT), 1

-native, compiler option, 1

native-language support, application development, 1

NCT, 1

new array forms, recognizing, 1

-noex, compiler option, 1, 2

-nofstore, compiler option, 1 - 2

-nolib, compiler option, 1, 2

-nolibmil, compiler option, 1

nonincremental link editor, compilation component, 1

nonstandard features, 1 - 2

allowing nonstandard code, 1

defined, 1

-noqueue, compiler option, 1

-norunpath, compiler option, 1, 2

numbers, 1, 2 - 3

O

.o files

option suffixes, 1

preserving, 1

-O, compiler option, 1

-o, compiler option, 1

object files

linking order, 1

reading compiler commentary with er_src, 1

relocatable, 1

object thread, private, 1

objects

destruction of shared, 1

destruction order, 1

global shared, 1

strategies for dealing with shared, 1

stream_locker, 1

temporary, 1

temporary, lifetime of, 1

within library, 1, 2

oct, iostream manipulator, 1

ofstream class, 1

-Olevel, compiler option, 1

operators

basic arithmetic, 1 - 2

complex, 1

iostream, 1, 2, 3 - 4

scope resolution, 1

optimization

at link time, 1

levels, 1

math library, 1

options for, 1

target hardware, 1

with -fast, 1

with pragma opt, 1

with -xmaxopt, 1

optimizer out of memory, 1

options

See also

code generation, 1

debugging, 1

description subsections, 1

expansion compilation, 1

floating point, 1

language, 1

library, 1 - 2

library linking, 1

licensing, 1

obsolete, 1, 2

optimization, 1

output, 1, 2

performance, 1

preprocessor, 1

processing order, 1, 2

profiling, 1

reference, 1

source, 1

subprogram compilation, 1 - 2

syntax format, 1, 2

template, 1

template compilation, 1

thread, 1

unrecognized, 1

ostream class, 1, 2

ostrstream class, 1, 2

output, 1

binary, 1

buffer flushing, 1

cout, 1

flushing, 1

handling errors, 1

options, 1

overflow function, streambuf, 1

overhead, MT-safe class performance, 1, 2

P

-P, compiler option, 1

+p, compiler option, 1

page size, setting for stack or heap, 1

PARALLEL, 1

parallelization

turning on with -xautopar for multiple processors, 1

parameterized manipulators, iostreams, 1 - 2

PATH environment variable, setting, 1

peeking at input, 1

Pentium, 1

-pentium, compiler option, 1

performance

optimizing with -fast, 1

options, 1

overhead of MT-safe classes, 1, 2

-pg, compiler option, 1

-PIC, compiler option, 1

-pic, compiler option, 1

placement, template instances, 1

plain manipulators, iostreams, 1 - 2

polar, complex number, 1

#pragma align, 1

#pragma does_not_read_global_data, 1

#pragma does_not_return, 1

#pragma does_not_write_global_data, 1

#pragma dumpmacros, 1

#pragma end_dumpmacros, 1

#pragma fini, 1

#pragma ident, 1

#pragma init, 1

#pragma no_side_effect, 1, 2

#pragma opt, 1

#pragma pack, 1

#pragma rarely_called, 1

#pragma returns_new_memory, 1

#pragma unknown_control_flow, 1

#pragma weak, 1

#pragma keywords, 1 - 2

precedence, avoiding problems of, 1

precompiled-header file, 1

predefined macros, 1

predefined manipulators, iomanip.h, 1

prefetch instructions, enabling, 1

preprocessor

defining macro to, 1

options, 1

preserving signedness of chars, 1

private, 1, 2

processing order, options, 1

processor, specifying target, 1

prof, C++ utilities, 1

profiling options, 1, 2

Programming Language-C++, standards conformance, 1

programs

basic building steps, 1 - 2

building multithreaded, 1

-pta, compiler option, 1

ptclean command, 1

pthread_cancel() function, 1

-pti, compiler option, 1, 2

-pto, compiler option, 1

-ptr, compiler option, 1

-ptv, compiler option, 1

public functions, MT-safe, 1

put pointer, streambuf, 1

Q

-Qoption, compiler option, 1

-qoption, compiler option, 1

-qp, compiler option, 1

-Qproduce, compiler option, 1

-qproduce, compiler option, 1

R

-R, compiler option, 1, 2 - 3

readme file, 1

-readme, compiler option, 1

real memory, display, 1

real numbers, 1, 2, 3

reference options, 1

reinterpret_cast operator, 1, 2

reorder functions, 1

repositioning within a file, fstream, 1

resetiosflags, iostream manipulator, 1

restrict keyword

as recognized by -Xs, 1

as type qualifier in parallelized code, 1

restricted pointers, 1

restrictions, MT-safe iostream, 1

right-shift operator

complex, 1

iostream, 1

RogueWave

See also Tools.h++

C++ standard library, 1

RTLD_GLOBAL, environment variable, 1

rtti keyword, recognizing, 1

runtime error messages, 1

runtime libraries readme, 1

S

-S, compiler option, 1

-s, compiler option, 1

.S, file name suffixes, 1

.s, file name suffixes, 1

-sb, compiler option, 1

-sbfast, compiler option, 1

sbufpub, man pages, 1

scope resolution operator, unsafe_ classes, 1

search path

definitions, 1

dynamic library, 1

include files, 1, 2

source options, 1

standard header implementation, 1 - 2

template options, 1

searching

template definition files, 1

semi-explicit instances, 1, 2

sequences, MT-safe execution of I/O operations, 1

set_terminate() function, 1

set_unexpected() function, 1

setbase,