Standard C++ Library Reference - SciNetWiki .C/C++ for AIX, V10.1 Standard C++ Library Reference

  • View
    213

  • Download
    0

Embed Size (px)

Text of Standard C++ Library Reference - SciNetWiki .C/C++ for AIX, V10.1 Standard C++ Library Reference

  • IBM XL C/C++ for AIX, V10.1

    Standard C++ Library Reference

    SC23-8890-00

  • IBM XL C/C++ for AIX, V10.1

    Standard C++ Library Reference

    SC23-8890-00

  • Note! Before using this information and the product it supports, be sure to read the general information under Notices on page 531.

    First Edition

    This edition applies to IBM XL C/C++ Enterprise Edition for AIX, V9.0 (Program number 5724-S71) and to all subsequent releases and modifications until otherwise indicated in new editions. Make sure you are using the correct edition for the level of the product.

    Copyright IBM Corp. 1999, 2007.Copyright P.J. Plauger and/or Dinkumware, Ltd. 1992-2006Copyright 1994 Hewlett-Packard Company

    US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

  • Contents

    Chapter 1. C++ Library Overview . . . . 1 Header files overview . . . . . . . . . . . 2 Using C++ Library Headers . . . . . . . . . 3 C++ Library Conventions . . . . . . . . . . 4 Iostreams Conventions . . . . . . . . . . . 5 C++ Program Startup and Termination . . . . . 5

    Chapter 2. Standard C++ Library Header Files . . . . . . . . . . . . . . . . 7 . . . . . . . . . . . . . . 10

    Description . . . . . . . . . . . . . 11 Synopsis . . . . . . . . . . . . . . 11 Functions . . . . . . . . . . . . . . 16

    adjacent_find . . . . . . . . . . . . 16 binary_search . . . . . . . . . . . . 16 copy . . . . . . . . . . . . . . . 16 copy_backward . . . . . . . . . . . 16 count . . . . . . . . . . . . . . 17 count_if . . . . . . . . . . . . . 17 equal . . . . . . . . . . . . . . 17 equal_range . . . . . . . . . . . . 17 fill . . . . . . . . . . . . . . . 17 fill_n . . . . . . . . . . . . . . 18 find . . . . . . . . . . . . . . . 18 find_end . . . . . . . . . . . . . 18 find_first_of . . . . . . . . . . . . 18 find_if . . . . . . . . . . . . . . 19 for_each . . . . . . . . . . . . . 19 generate . . . . . . . . . . . . . 19 generate_n . . . . . . . . . . . . . 19 includes . . . . . . . . . . . . . 19 inplace_merge . . . . . . . . . . . 20 iter_swap . . . . . . . . . . . . . 20 lexicographical_compare . . . . . . . . 20 lower_bound . . . . . . . . . . . . 20 make_heap . . . . . . . . . . . . 21 max . . . . . . . . . . . . . . . 21 max_element . . . . . . . . . . . . 21 merge . . . . . . . . . . . . . . 22 min . . . . . . . . . . . . . . . 22 min_element . . . . . . . . . . . . 22 mismatch . . . . . . . . . . . . . 23 next_permutation . . . . . . . . . . 23 nth_element . . . . . . . . . . . . 23 partial_sort . . . . . . . . . . . . 24 partial_sort_copy . . . . . . . . . . 24 partition . . . . . . . . . . . . . 24 pop_heap . . . . . . . . . . . . . 25 prev_permutation . . . . . . . . . . 25 push_heap . . . . . . . . . . . . . 25 random_shuffle . . . . . . . . . . . 26 remove . . . . . . . . . . . . . . 26 remove_copy . . . . . . . . . . . . 26 remove_copy_if . . . . . . . . . . . 26 remove_if . . . . . . . . . . . . . 27

    replace . . . . . . . . . . . . . . 27 replace_copy . . . . . . . . . . . . 27 replace_copy_if . . . . . . . . . . . 27 replace_if . . . . . . . . . . . . . 28 reverse . . . . . . . . . . . . . . 28 reverse_copy . . . . . . . . . . . . 28 rotate . . . . . . . . . . . . . . 28 rotate_copy . . . . . . . . . . . . 28 search . . . . . . . . . . . . . . 29 search_n . . . . . . . . . . . . . 29 set_difference . . . . . . . . . . . . 29 set_intersection . . . . . . . . . . . 30 set_symmetric_difference . . . . . . . . 30 set_union . . . . . . . . . . . . . 31 sort . . . . . . . . . . . . . . . 32 sort_heap . . . . . . . . . . . . . 32 stable_partition . . . . . . . . . . . 32 stable_sort . . . . . . . . . . . . . 32 swap . . . . . . . . . . . . . . 33 swap_ranges . . . . . . . . . . . . 33 transform . . . . . . . . . . . . . 33 unique . . . . . . . . . . . . . . 33 unique_copy . . . . . . . . . . . . 34 upper_bound . . . . . . . . . . . . 34

    . . . . . . . . . . . . . . . . 35 Description . . . . . . . . . . . . . 35 Synopsis . . . . . . . . . . . . . . 35 Classes . . . . . . . . . . . . . . . 36

    array . . . . . . . . . . . . . . 36 Description . . . . . . . . . . . 36 Synopsis . . . . . . . . . . . . 36 Types . . . . . . . . . . . . . 37 Member functions . . . . . . . . . 38

    Template functions . . . . . . . . . . . 40 get . . . . . . . . . . . . . . . 40 operator!= . . . . . . . . . . . . . 40 operator== . . . . . . . . . . . . 40 operator< . . . . . . . . . . . . . 40 operator . . . . . . . . . . . . . 41 operator>= . . . . . . . . . . . . 41 swap . . . . . . . . . . . . . . 41

    Templates . . . . . . . . . . . . . . 41 tuple_element . . . . . . . . . . . 41 tuple_size . . . . . . . . . . . . . 41

    . . . . . . . . . . . . . . . 41 Description . . . . . . . . . . . . . 42 Synopsis . . . . . . . . . . . . . . 42 Classes . . . . . . . . . . . . . . . 42

    bitset . . . . . . . . . . . . . . 42 Description . . . . . . . . . . . 42 Synopsis . . . . . . . . . . . . 42 Constructor . . . . . . . . . . . 43 Member functions . . . . . . . . . 43

    Template functions . . . . . . . . . . . 46 operator

  • operator>> . . . . . . . . . . . . 47 . . . . . . . . . . . . . . . 47 . . . . . . . . . . . . . . . 47 . . . . . . . . . . . . . . . 48 . . . . . . . . . . . . . . . 48 . . . . . . . . . . . . . . . 48 . . . . . . . . . . . . . . 49 . . . . . . . . . . . . . . . 49 . . . . . . . . . . . . . . . 49 . . . . . . . . . . . . . . . 49 . . . . . . . . . . . . . . . 50 . . . . . . . . . . . . . . 51

    Description . . . . . . . . . . . . . 52 Synopsis . . . . . . . . . . . . . . 52 Macros . . . . . . . . . . . . . . . 54

    __STD_COMPLEX . . . . . . . . . . 54 Classes . . . . . . . . . . . . . . . 54

    complex . . . . . . . . . . . . . 54 Description . . . . . . . . . . . 54 Synopsis . . . . . . . . . . . . 54 Constructor . . . . . . . . . . . 55 Member functions . . . . . . . . . 55

    complex . . . . . . . . . . 57 complex . . . . . . . . . . . 58 complex . . . . . . . . 58

    Template functions . . . . . . . . . . . 58 abs . . . . . . . . . . . . . . . 58 acos . . . . . . . . . . . . . . . 58 acosh . . . . . . . . . . . . . . 59 arg . . . . . . . . . . . . . . . 59 asin . . . . . . . . . . . . . . . 59 asinh . . . . . . . . . . . . . . 59 atan . . . . . . . . . . . . . . . 59 atanh . . . . . . . . . . . . . . 59 conj . . . . . . . . . . . . . . . 59 cos . . . . . . . . . . . . . . . 59 cosh . . . . . . . . . . . . . . . 60 exp . . . . . . . . . . . . . . . 60 fabs . . . . . . . . . . . . . . . 60 imag . . . . . . . . . . . . . . . 60 log . . . . . . . . . . . . . . . 60 log10 . . . . . . . . . . . . . . 60 norm . . . . . . . . . . . . . . 60 operator!= . . . . . . . . . . . . . 60 operator* . . . . . . . . . . . . . 61 operator+ . . . . . . . . . . . . . 61 operator- . . . . . . . . . . . . . 61 operator/ . . . . . . . . . . . . . 61 operator> . . . . . . . . . . . . 62 polar . . . . . . . . . . . . . . 62 pow . . . . . . . . . . . . . . . 63 real . . . . . . . . . . . . . . . 63 sin . . . . . . . . . . . . . . . 63 sinh . . . . . . . . . . . . . . . 63 sqrt . . . . . . . . . . . . . . . 63 tan . . . . . . . . . . . . . . . 63 tanh . . . . . . . . . . . . . . . 63

    . . . . . . . . . . . . . . . 64 . . . . . . . . . . . . . . . 64

    . . . . . . . . . . . . . . . 64 . . . . . . . . . . . . . . 64 . . . . . . . . . . . . . . . 65 . . . . . . . . . . . . . . . 65 . . . . . . . . . . . . . . . 66 . . . . . . . . . . . . . . . 66 . . . . . . . . . . . . . . . 67 . . . . . . . . . . . . . . . 67 . . . . . . . . . . . . . . . 67 . . . . . . . . . . . . . . . 68 . . . . . . . . . . . . . . . 69 . . . . . . . . . . . . . . . 69

    Description . . . . . . . . . . . . . 69 Synopsis . . . . . . . . . . . . . . 69 Classes . . . . . . . . . . . . . . . 70

    deque . . . . . . . . . . . . . . 70 Description . . . . . . . . . . . 70 Synopsis . . . . . . . . . . . . 70 Constructor . . . . . . . . . . . 71 Types . . . . . . . . . . . . . 72 Member functions . . . . . . . . . 73

    Template functions . . . . . . . . . . . 77 operator!= . . . . . . . . . . . . . 77 operator== . . . . . . . . . . . . 77 operator< . . . . . . . . . . . . . 77 operator . . . . . . . . . . . . . 78 operator>= . . . . . . . . . . . . 78 swap . . . . . . . . . . . . . . 78

    . . . . . . . . . . . . . . 78 Description . . . . . . . . . . . . . 78 Synopsis . . . . . . . . . . . . . . 78 Classes . . . . . . . . . . . . . . . 79

    bad_exception . . . . . . . . . . . 79 exception . . . . . . . . . . . . . 79

    Functions . . . . . . . . . . . . . . 79 set_terminate . . . . . . . . . . . . 79 set_unexpected . . . . . . . . . . . 79 terminate . . . . . . . . . . . . . 79 uncaught_exception . . . . . . . . . 80 unexpected . . . . . . . . . . . . 80

    Types . . . . . . . . . . . . . . . 80 terminate_handler . . . . . . . . . . 80 unexpected_handler . . . . . . . . . 80

    . . . . . . . . . . . . . . . 80 Description . . . . . . . . . . . . . 81 Synopsis . . . . . . . . . . . . . . 81 Classes . . . . . . . . . . . . . . . 81

    basic_filebuf . . . . . . . . . . . . 81 Description . . . . . . . . .