z/OS Version 2 Release 3 Standard C++ Library Reference IBM SC14-7309-30 Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page 481. This edition applies to IBM z/OS XL C/C++ compiler in IBM z/OS operating system Version 2 Release 3 (5650-ZOS) and to all subsequent releases until otherwise indicated in new editions. This edition replaces SC09-4949-05. Make sure that you use the correct edition for the level of the program listed above. Also, ensure that you apply all necessary PTFs for the program. Last updated: 2019-02-15 IBM welcomes your comments. You can send your comments to the following Internet address: [email protected]. Be sure to include your e-mail address if you want a reply. Include the title and order number of this book, and the page number or topic related to your comment. When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. Copyright © IBM Corp. 1999, 2017. Copyright © P.J. Plauger and/or Dinkumware, Ltd. 1992-2006 Copyright © 1994 Hewlett-Packard Company US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. © Copyright International Business Machines Corporation . US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. Standard C++ Library Overview............................................................. 1 Header files overview...................................................................................................................................2 Using C++ Library Headers.......................................................................................................................... 3 Standard C++ Library Conventions..............................................................................................................3 Iostreams Conventions................................................................................................................................4 C++ Program Startup and Termination........................................................................................................4 Chapter 2. Standard C++ Library Header Files........................................................ 7 <algorithm>................................................................................................................................................10 Description........................................................................................................................................... 10 Synopsis................................................................................................................................................10 Functions.............................................................................................................................................. 14 <array>....................................................................................................................................................... 31 Description........................................................................................................................................... 31 Synopsis................................................................................................................................................31 Classes..................................................................................................................................................31 Template functions...............................................................................................................................36 Templates............................................................................................................................................. 37 <bitset>...................................................................................................................................................... 37 Description........................................................................................................................................... 37 Synopsis................................................................................................................................................37 Classes..................................................................................................................................................37 Template functions...............................................................................................................................42 <cassert>................................................................................................................................................... 42 <cctype>.................................................................................................................................................... 43 <cerrno>.....................................................................................................................................................43 <cfloat>...................................................................................................................................................... 43 <ciso646>.................................................................................................................................................. 43 <climits>.................................................................................................................................................... 43 <clocale>....................................................................................................................................................44 <cmath>..................................................................................................................................................... 44 <complex>................................................................................................................................................. 44 Description........................................................................................................................................... 45 Synopsis................................................................................................................................................45 Macros.................................................................................................................................................. 46 Classes..................................................................................................................................................47 Template functions...............................................................................................................................51 <csetjmp>.................................................................................................................................................. 58 <csignal>....................................................................................................................................................58 <cstdarg>................................................................................................................................................... 58 <cstddef>................................................................................................................................................... 59 <cstdio>..................................................................................................................................................... 59 <cstdlib>.................................................................................................................................................... 59 <cstring>.................................................................................................................................................... 60 <ctime>...................................................................................................................................................... 60 <cwchar>....................................................................................................................................................60 <cwctype>..................................................................................................................................................61 <deque>..................................................................................................................................................... 61 Description........................................................................................................................................... 61 Synopsis................................................................................................................................................61 iii Classes..................................................................................................................................................62 Template functions...............................................................................................................................68 <exception>............................................................................................................................................... 69 Description..........................................................................................................................................