VSI OpenVMS
          C++ Class Library Reference Manual
             Document Number: DO-DGDCLU-01A
             Publication Date: May 2020
             This document describes a library of VSI C++ classes.
             Revision Update Information: This is a new manual.
             Operating System and Version: VSI OpenVMS I64 Version 8.4-1H1
                              VSI OpenVMS Alpha Version 8.4-2L1
             Software Version: VSI C++ Version 7.4-6 for OpenVMS I64
                       VSI C++ Version 7.4-8 for OpenVMS Alpha
             VMS Software, Inc., (VSI)
             Bolton, Massachusetts, USA
         C++ Class Library Reference Manual
         Copyright © 2020 VMS Software, Inc. (VSI), Bolton, Massachusetts, USA
         Legal Notice
         Confidential computer software. Valid license from VSI required for possession, use or copying. Consistent with FAR 12.211 and 12.212,
         Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S.
         Government under vendor's standard commercial license.
         The information contained herein is subject to change without notice. The only warranties for VSI products and services are set forth in the
         express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional
         warranty. VSI shall not be liable for technical or editorial errors or omissions contained herein.
         HPE, HPE Integrity, HPE Alpha, and HPE Proliant are trademarks or registered trademarks of Hewlett Packard Enterprise.
         Intel, Itanium and IA64 are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other
         countries.
         Microsoft, Windows, Windows-NT and Microsoft XP are U.S. registered trademarks of Microsoft Corporation. Microsoft Vista is either a
         registered trademark or trademark of Microsoft Corporation in the United States and/or other countries.
         Motif is a registered trademark of The Open Group
         UNIX is a registered trademark of The Open Group.
         The VSI OpenVMS documentation set is available on CD.
         ii
                            C++ Class Library Reference Manual
           Preface .....................................................................................................................................  v
             1. About VSI ...................................................................................................................... v
             2. Intended Audience ..........................................................................................................  v
             3. Document Structure ........................................................................................................  v
             4. Associated Documents ....................................................................................................  v
             5. VSI Encourages Your Comments .................................................................................... vi
             6. How to Order Additional Documentation ........................................................................ vi
             7. Typographical Conventions ............................................................................................  vi
           Chapter 1. Overview .............................................................................................................. 1
             1.1. Thread Safe Programming ............................................................................................  1
             1.2. Using RMS Attributes with iostreams ...........................................................................  1
             1.3. Class Library Restrictions ............................................................................................. 2
           Chapter 2. complex Package ................................................................................................  3
             Global Declarations ............................................................................................................  3
             complex class .....................................................................................................................  4
             c_exception class ................................................................................................................  9
           Chapter 3. generic Package ................................................................................................ 11
             Global Declarations ........................................................................................................... 11
           Chapter 4. iostream Package .............................................................................................. 17
             Global Declarations ........................................................................................................... 19
             filebuf class ......................................................................................................................  24
             fstream class .....................................................................................................................  27
             IAPP(TYPE) class ............................................................................................................  29
             ifstream class ....................................................................................................................  30
             IMANIP(TYPE) class .......................................................................................................  32
             IOAPP(TYPE) class .......................................................................................................... 33
             IOMANIP(TYPE) class ..................................................................................................... 34
             ios class ............................................................................................................................ 35
             iostream class ...................................................................................................................  43
             iostream_withassign class .................................................................................................. 43
             istream class .....................................................................................................................  44
             istream_withassign class .................................................................................................... 49
             istrstream class .................................................................................................................. 50
             OAPP(TYPE) class ...........................................................................................................  51
             ofstream class ...................................................................................................................  52
             OMANIP(TYPE) class ...................................................................................................... 54
             ostream class ....................................................................................................................  55
             ostream_withassign class ................................................................................................... 58
             ostrstream class ................................................................................................................. 59
             SAPP(TYPE) class ............................................................................................................ 60
             SMANIP(TYPE) class ....................................................................................................... 61
             stdiobuf class ....................................................................................................................  62
             stdiostream class ...............................................................................................................  64
             streambuf class .................................................................................................................  65
             strstream class ................................................................................................................... 72
             strstreambuf class .............................................................................................................. 73
           Chapter 5. Messages Package ............................................................................................. 77
             Messages class .................................................................................................................. 77
           Chapter 6. Mutex Package .................................................................................................  81
                                                             iii
                        C++ Class Library Reference Manual
         Mutex class ......................................................................................................................  81
       Chapter 7. Objection Package ............................................................................................ 83
         Global Declaration ............................................................................................................  83
         Objection class .................................................................................................................. 83
       Chapter 8. Stopwatch Package ........................................................................................... 87
         Stopwatch class ................................................................................................................. 87
       Chapter 9. String Package .................................................................................................. 91
         String class .......................................................................................................................  91
       Chapter 10. task Package ...................................................................................................  97
         Global Declarations ........................................................................................................... 98
         erand class ......................................................................................................................  100
         histogram class ................................................................................................................ 101
         Interrupt_handler class ..................................................................................................... 103
         object class .....................................................................................................................  105
         qhead class .....................................................................................................................  108
         qtail class ........................................................................................................................ 110
         randint class .................................................................................................................... 113
         sched class ...................................................................................................................... 114
         task class ........................................................................................................................  118
         timer class ......................................................................................................................  122
         urand class ...................................................................................................................... 124
       Chapter 11. vector Package ..............................................................................................  127
         stack(TYPE) class ...........................................................................................................  128
         vector(TYPE) class .........................................................................................................  130
       iv