1 <section xmlns="http://docbook.org/ns/docbook" version="5.0"
2 xml:id="status.iso.1998" xreflabel="ISO C++ 1998">
3 <?dbhtml filename="status_iso_cxx1998.html"?>
5 <info><title>C++ 1998/2003</title>
7 <keyword>ISO C++</keyword>
8 <keyword>1998</keyword>
13 <section xml:id="iso.1998.status" xreflabel="Implementation Status">
14 <info><title>Implementation Status</title></info>
17 This status table is based on the table of contents of ISO/IEC 14882:2003.
21 This section describes the C++ support in
22 mainline GCC, not in any particular release.
25 <!-- Status is Yes or No, Broken/Partial-->
30 <?dbhtml bgcolor="#C8B0B0" ?>
32 <?dbhtml bgcolor="#B0B0B0" ?>
34 <table frame="all" xml:id="table.cxx98_status">
35 <title>C++ 1998/2003 Implementation Status</title>
37 <tgroup cols="4" align="left" colsep="0" rowsep="1">
38 <colspec colname="c1"/>
39 <colspec colname="c2"/>
40 <colspec colname="c3"/>
41 <colspec colname="c4"/>
44 <entry>Section</entry>
45 <entry>Description</entry>
47 <entry>Comments</entry>
54 <emphasis>18</emphasis>
56 <entry namest="c2" nameend="c4" align="left">
57 <emphasis>Language support</emphasis>
69 <entry>Implementation properties</entry>
75 <entry>Numeric Limits</entry>
80 <entry>18.2.1.1</entry>
81 <entry>Class template <code>numeric_limits</code></entry>
86 <entry>18.2.1.2</entry>
87 <entry><code>numeric_limits</code> members</entry>
91 <entry>18.2.1.3</entry>
92 <entry><code>float_round_style</code></entry>
96 <entry>18.2.1.4</entry>
97 <entry><code>float_denorm_style</code></entry>
101 <entry>18.2.1.5</entry>
102 <entry><code>numeric_limits</code> specializations</entry>
107 <entry>18.2.2</entry>
108 <entry>C Library</entry>
114 <entry>Start and termination</entry>
120 <entry>Dynamic memory management</entry>
126 <entry>Type identification</entry>
131 <entry>18.5.1</entry>
132 <entry>Class type_info</entry>
137 <entry>18.5.2</entry>
138 <entry>Class bad_cast</entry>
143 <entry>18.5.3</entry>
144 <entry>Class bad_typeid</entry>
150 <entry>Exception handling</entry>
155 <entry>18.6.1</entry>
156 <entry>Class exception</entry>
161 <entry>18.6.2</entry>
162 <entry>Violation exception-specifications</entry>
167 <entry>18.6.3</entry>
168 <entry>Abnormal termination</entry>
173 <entry>18.6.4</entry>
174 <entry><code>uncaught_exception</code></entry>
180 <entry>Other runtime support</entry>
186 <emphasis>19</emphasis>
188 <entry namest="c2" nameend="c4" align="left">
189 <emphasis>Diagnostics</emphasis>
194 <entry>Exception classes</entry>
200 <entry>Assertions</entry>
206 <entry>Error numbers</entry>
212 <emphasis>20</emphasis>
214 <entry namest="c2" nameend="c4" align="left">
215 <emphasis>General utilities</emphasis>
220 <entry>Requirements</entry>
226 <entry>Utility components</entry>
231 <entry>20.2.1</entry>
232 <entry>Operators</entry>
237 <entry>20.2.2</entry>
238 <entry><code>pair</code></entry>
244 <entry>Function objects</entry>
249 <entry>20.3.1</entry>
255 <entry>20.3.2</entry>
256 <entry>Arithmetic operation</entry>
261 <entry>20.3.3</entry>
262 <entry>Comparisons</entry>
267 <entry>20.3.4</entry>
268 <entry>Logical operations</entry>
273 <entry>20.3.5</entry>
274 <entry>Negators</entry>
279 <entry>20.3.6</entry>
280 <entry>Binders</entry>
285 <entry>20.3.7</entry>
286 <entry>Adaptors for pointers to functions</entry>
291 <entry>20.3.8</entry>
292 <entry>Adaptors for pointers to members</entry>
298 <entry>Memory</entry>
303 <entry>20.4.1</entry>
304 <entry>The default allocator</entry>
309 <entry>20.4.2</entry>
310 <entry>Raw storage iterator</entry>
315 <entry>20.4.3</entry>
316 <entry>Temporary buffers</entry>
321 <entry>20.4.4</entry>
322 <entry>Specialized algorithms</entry>
327 <entry>20.4.4.1</entry>
328 <entry><code>uninitialized_copy</code></entry>
333 <entry>20.4.4.2</entry>
334 <entry><code>uninitialized_fill</code></entry>
339 <entry>20.4.4.3</entry>
340 <entry><code>uninitialized_fill_n</code></entry>
345 <entry>20.4.5</entry>
346 <entry>Class template <code>auto_ptr</code></entry>
351 <entry>20.4.6</entry>
352 <entry>C library</entry>
358 <emphasis>21</emphasis>
360 <entry namest="c2" nameend="c4" align="left">
361 <emphasis>Strings</emphasis>
366 <entry>Character traits</entry>
371 <entry>21.1.1</entry>
372 <entry>Character traits requirements</entry>
377 <entry>21.1.2</entry>
378 <entry>traits typedef</entry>
383 <entry>21.1.3</entry>
384 <entry><code>char_traits</code> specializations</entry>
389 <entry>21.1.3.1</entry>
390 <entry>struct <code>char_traits<char></code></entry>
395 <entry>21.1.3.2</entry>
396 <entry>struct <code>char_traits<wchar_t></code></entry>
402 <entry>String classes</entry>
408 <entry>Class template <code>basic_string</code></entry>
414 <entry>Null-terminated sequence utilities</entry>
416 <entry>C library dependency</entry>
420 <emphasis>22</emphasis>
422 <entry namest="c2" nameend="c4" align="left">
423 <emphasis>Localization</emphasis>
428 <entry>Locales</entry>
433 <entry>22.1.1</entry>
434 <entry>Class <code>locale</code></entry>
439 <entry>22.1.2</entry>
440 <entry><code>locale</code> globals</entry>
445 <entry>22.1.3</entry>
446 <entry>Convenience interfaces</entry>
451 <entry>22.1.3.1</entry>
452 <entry>Character classification</entry>
457 <entry>22.1.3.2</entry>
458 <entry>Character conversions</entry>
464 <entry>Standard locale categories</entry>
469 <entry>22.2.1</entry>
470 <entry><code>ctype</code></entry>
475 <entry>22.2.2</entry>
476 <entry>Numeric</entry>
481 <entry>22.2.2.1</entry>
482 <entry><code>num_get</code></entry>
487 <entry>22.2.2.2</entry>
488 <entry><code>num_put</code></entry>
493 <entry>22.2.3</entry>
494 <entry><code>num_punct</code></entry>
499 <entry>22.2.4</entry>
500 <entry><code>collate</code></entry>
505 <entry>22.2.5</entry>
511 <entry>22.2.5.1</entry>
512 <entry><code>time_get</code></entry>
517 <entry>22.2.5.2</entry>
518 <entry><code>time_get_byname</code></entry>
523 <entry>22.2.5.3</entry>
524 <entry><code>time_put</code></entry>
529 <entry>22.2.5.3</entry>
530 <entry><code>time_put_byname</code></entry>
535 <entry>22.2.6</entry>
536 <entry>Monetary</entry>
541 <entry>22.2.6.1</entry>
542 <entry><code>money_get</code></entry>
547 <entry>22.2.6.2</entry>
548 <entry><code>money_put</code></entry>
553 <entry>22.2.6.3</entry>
554 <entry><code>money_punct</code></entry>
559 <entry>22.2.6.4</entry>
560 <entry><code>money_punct_byname</code></entry>
565 <entry>22.2.7</entry>
566 <entry><code>messages</code></entry>
571 <entry>22.2.8</entry>
572 <entry>Program-defined facets</entry>
578 <entry>C Library Locales</entry>
584 <emphasis>23</emphasis>
586 <entry namest="c2" nameend="c4" align="left">
587 <emphasis>Containers</emphasis>
592 <entry>Container requirements</entry>
598 <entry>Sequence containers</entry>
603 <entry>23.2.1</entry>
604 <entry>Class template <code>deque</code></entry>
609 <entry>23.2.2</entry>
610 <entry>Class template <code>list</code></entry>
615 <entry>23.2.3</entry>
616 <entry>Adaptors</entry>
621 <entry>23.2.3.1</entry>
622 <entry>Class template <code>queue</code></entry>
627 <entry>23.2.3.2</entry>
628 <entry>Class template <code>priority_queue</code></entry>
633 <entry>23.2.3.3</entry>
634 <entry>Class template <code>stack</code></entry>
639 <entry>23.2.4</entry>
640 <entry>Class template <code>vector</code></entry>
645 <entry>23.2.5</entry>
646 <entry>Class <code>vector<bool></code></entry>
652 <entry>Associative containers</entry>
657 <entry>23.3.1</entry>
658 <entry>Class template <code>map</code></entry>
663 <entry>23.3.2</entry>
664 <entry>Class template <code>multimap</code></entry>
669 <entry>23.3.3</entry>
670 <entry>Class template <code>set</code></entry>
675 <entry>23.3.4</entry>
676 <entry>Class template <code>multiset</code></entry>
682 <emphasis>24</emphasis>
684 <entry namest="c2" nameend="c4" align="left">
685 <emphasis>Iterators</emphasis>
690 <entry>Requirements</entry>
696 <entry>Header <code><iterator></code> synopsis</entry>
702 <entry>Iterator primitives</entry>
708 <entry>Predefined iterators and Iterator adaptors</entry>
713 <entry>24.4.1</entry>
714 <entry>Reverse iterators</entry>
719 <entry>24.4.2</entry>
720 <entry>Insert iterators</entry>
726 <entry>Stream iterators</entry>
731 <entry>24.5.1</entry>
732 <entry>Class template <code>istream_iterator</code></entry>
737 <entry>24.5.2</entry>
738 <entry>Class template <code>ostream_iterator</code></entry>
743 <entry>24.5.3</entry>
744 <entry>Class template <code>istreambuf_iterator</code></entry>
749 <entry>24.5.4</entry>
750 <entry>Class template <code>ostreambuf_iterator</code></entry>
756 <emphasis>25</emphasis>
758 <entry namest="c2" nameend="c4" align="left">
759 <emphasis>Algorithms</emphasis>
764 <entry>Non-modifying sequence operations</entry>
770 <entry>Mutating sequence operations</entry>
776 <entry>Sorting and related operations</entry>
782 <entry>C library algorithms</entry>
788 <emphasis>26</emphasis>
790 <entry namest="c2" nameend="c4" align="left">
791 <emphasis>Numerics</emphasis>
796 <entry>Numeric type requirements</entry>
802 <entry>Complex numbers</entry>
808 <entry>Numeric arrays</entry>
813 <entry>26.3.1</entry>
814 <entry>Header <code><valarray></code> synopsis</entry>
819 <entry>26.3.2</entry>
820 <entry>Class template <code>valarray</code></entry>
825 <entry>26.3.3</entry>
826 <entry><code>valarray</code> non-member operations</entry>
831 <entry>26.3.4</entry>
832 <entry>Class <code>slice</code></entry>
837 <entry>26.3.5</entry>
838 <entry>Class template <code>slice_array</code></entry>
843 <entry>26.3.6</entry>
844 <entry>Class <code>gslice</code></entry>
849 <entry>26.3.7</entry>
850 <entry>Class template <code>gslice_array</code></entry>
855 <entry>26.3.8</entry>
856 <entry>Class template <code>mask_array</code></entry>
861 <entry>26.3.9</entry>
862 <entry>Class template <code>indirect_array</code></entry>
868 <entry>Generalized numeric operations</entry>
873 <entry>26.4.1</entry>
874 <entry><code>accumulate</code></entry>
879 <entry>26.4.2</entry>
880 <entry><code>inner_product</code></entry>
885 <entry>26.4.3</entry>
886 <entry><code>partial_sum</code></entry>
891 <entry>26.4.4</entry>
892 <entry><code>adjacent_difference</code></entry>
897 <entry>26.4.5</entry>
904 <entry>C Library</entry>
910 <emphasis>27</emphasis>
912 <entry namest="c2" nameend="c4" align="left">
913 <emphasis>Input/output</emphasis>
918 <entry>Requirements</entry>
924 <entry>Forward declarations</entry>
930 <entry>Standard iostream objects</entry>
935 <entry>27.3.1</entry>
936 <entry>Narrow stream objects</entry>
941 <entry>27.3.2</entry>
942 <entry>Wide stream objects</entry>
948 <entry>Iostreams base classes</entry>
954 <entry>Stream buffers</entry>
960 <entry>Formatting and manipulators</entry>
966 <entry>String-based streams</entry>
972 <entry>File-based streams</entry>
978 <emphasis>Appendix D</emphasis>
980 <entry namest="c2" nameend="c4" align="left">
981 <emphasis>Compatibility features</emphasis>
986 <entry>Increment operator with bool operand</entry>
992 <entry><code>static</code> keyword</entry>
998 <entry>Access declarations</entry>
1004 <entry>Implicit conversion from const strings</entry>
1010 <entry>C standard library headers</entry>
1016 <entry>Old iostreams members</entry>
1022 <entry>char* streams</entry>
1032 <section xml:id="iso.1998.specific" xreflabel="Implementation Specific"><info><title>Implementation Specific Behavior</title></info>
1036 The ISO standard defines the following phrase:
1042 <code>[1.3.5] implementation-defined behavior</code>
1046 Behavior, for a well-formed program construct and correct data, that
1047 depends on the implementation <emphasis>and that each implementation
1048 shall document</emphasis>.
1055 We do so here, for the C++ library only. Behavior of the
1056 compiler, linker, runtime loader, and other elements of "the
1057 implementation" are documented elsewhere. Everything listed
1058 in Annex B, Implementation Qualities, are also part of the
1059 compiler, not the library.
1062 For each entry, we give the section number of the standard, when
1063 applicable. This list is probably incomplet and inkorrekt.
1066 <emphasis>[1.9]/11 #3</emphasis> If <code>isatty(3)</code> is true, then
1067 interactive stream support is implied.
1070 <emphasis>[17.4.4.5]</emphasis> Non-reentrant functions are probably best
1071 discussed in the various sections on multithreading (see above).
1073 <!-- [17.4.4.8]/3 says any function that doesn't have an exception-spec
1074 can throw whatever we want; see also its footnote. Let's list those
1075 in the sections where the function itself occurs.
1077 <para><emphasis>[18.1]/4</emphasis> The type of <code>NULL</code> is described
1078 under <link linkend="std.support.types.null">Support</link>.
1080 <para><emphasis>[18.3]/8</emphasis> Even though it's listed in the library
1081 sections, libstdc++ has zero control over what the cleanup code hands
1082 back to the runtime loader. Talk to the compiler people. :-)
1084 <para><emphasis>[18.4.2.1]/5</emphasis> (bad_alloc),
1085 <emphasis>[18.5.2]/5</emphasis> (bad_cast),
1086 <emphasis>[18.5.3]/5</emphasis> (bad_typeid),
1087 <emphasis>[18.6.1]/8</emphasis> (exception),
1088 <emphasis>[18.6.2.1]/5</emphasis> (bad_exception): The <code>what()</code>
1089 member function of class <code>std::exception</code>, and these other
1090 classes publicly derived from it, returns the name of the
1091 class, e.g. <literal>"std::bad_alloc"</literal>.
1093 <para><emphasis>[18.5.1]/7</emphasis> The return value of
1094 <code>std::type_info::name()</code> is the mangled type name.
1095 You will need to call <code>c++filt</code> and pass the names as
1096 command-line parameters to demangle them, or call a
1097 <link linkend="manual.ext.demangle">runtime demangler function</link>.
1099 <para><emphasis>[20.1.5]/5</emphasis> <emphasis>"Implementors are encouraged to
1100 supply libraries that can accept allocators that encapsulate more
1101 general memory models and that support non-equal instances. In such
1102 implementations, any requirements imposed on allocators by containers
1103 beyond those requirements that appear in Table 32, and the semantics
1104 of containers and algorithms when allocator instances compare
1105 non-equal, are implementation-defined."</emphasis> There is experimental
1106 support for non-equal allocators in the standard containers in C++98
1107 mode. There are no additional requirements on allocators. It is undefined
1108 behaviour to swap two containers if their allocators are not equal.
1110 <para><emphasis>[21.1.3.1]/3,4</emphasis>,
1111 <emphasis>[21.1.3.2]/2</emphasis>,
1112 <emphasis>[21.3]/6 basic_string::iterator, basic_string::const_iterator</emphasis>,
1113 <emphasis>[23.*]'s foo::iterator</emphasis>,
1114 <emphasis>[27.*]'s foo::*_type</emphasis>,
1115 <emphasis>others...</emphasis>
1116 Nope, these types are called implementation-defined because you
1117 shouldn't be taking advantage of their underlying types. Listing them
1118 here would defeat the purpose. :-)
1120 <para><emphasis>[21.1.3.1]/5</emphasis> I don't really know about
1121 the <type>mbstate_t</type> stuff... see
1122 the <link linkend="std.localization.facet.codecvt"><code>codecvt</code>
1123 notes</link> for what does exist.
1125 <para><emphasis>[22.*]</emphasis> Anything and everything we have on locale
1126 implementation will be described under
1127 <link linkend="std.localization.locales.locale">Localization</link>.
1129 <para><emphasis>[23.*]</emphasis> All of the containers in this clause
1130 define <type>size_type</type> as <type>std::size_t</type> and
1131 <type>difference_type</type> as <type>std::ptrdiff_t</type>.
1133 <para><emphasis>[26.2.8]/9</emphasis> I have no idea what
1134 <code>complex<T></code>'s <code>pow(0,0)</code> returns.
1136 <para><emphasis>[27.4.2.4]/2</emphasis> Calling
1137 <code>std::ios_base::sync_with_stdio</code> after I/O has already been
1138 performed on the standard stream objects will
1139 flush the buffers, and <!-- this line might go away -->
1140 destroy and recreate the underlying buffer instances. Whether or not
1141 the previously-written I/O is destroyed in this process depends mostly
1142 on the <code>--enable-libio</code> choice: for stdio, if the written
1143 data is already in the stdio buffer, the data may be completely safe!
1145 <para><emphasis>[27.6.1.1.2]</emphasis>,
1146 <emphasis>[27.6.2.3]</emphasis> The I/O sentry ctor and dtor can perform
1147 additional work than the minimum required. We are not currently taking
1148 advantage of this yet.
1150 <para><emphasis>[27.7.1.3]/16</emphasis>,
1151 <emphasis>[27.8.1.4]/10</emphasis>
1152 The effects of <code>pubsetbuf/setbuf</code> are described in the
1153 <link linkend="std.io">Input and Output</link> chapter.
1155 <para><emphasis>[27.8.1.4]/16</emphasis> Calling <code>fstream::sync</code> when
1156 a get area exists will... whatever <code>fflush()</code> does, I think.