xref: /netbsd-src/external/gpl3/gcc/dist/libstdc++-v3/doc/html/manual/api.html (revision 76c7fc5f6b13ed0b1508e6b313e88e59977ed78e)
1<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>API Evolution and Deprecation History</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><meta name="keywords" content="ISO C++, api, evolution, deprecation, history" /><meta name="keywords" content="ISO C++, library" /><meta name="keywords" content="ISO C++, runtime, library" /><link rel="home" href="../index.html" title="The GNU C++ Library" /><link rel="up" href="appendix_porting.html" title="Appendix B.  Porting and Maintenance" /><link rel="prev" href="abi.html" title="ABI Policy and Guidelines" /><link rel="next" href="backwards.html" title="Backwards Compatibility" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">API Evolution and Deprecation History</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="abi.html">Prev</a> </td><th width="60%" align="center">Appendix B. 
3  Porting and Maintenance
4
5</th><td width="20%" align="right"> <a accesskey="n" href="backwards.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="appendix.porting.api"></a>API Evolution and Deprecation History</h2></div></div></div><p>
6A list of user-visible changes, in chronological order
7</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_300"></a><code class="constant">3.0</code></h3></div></div></div><p>
8Extensions moved to <code class="filename">include/ext</code>.
9  </p><p>
10Include files from the SGI/HP sources that pre-date the ISO standard
11are added. These files are placed into
12the <code class="filename">include/backward</code> directory and a deprecated warning
13is added that notifies on inclusion (<code class="literal">-Wno-deprecated</code>
14deactivates the warning.)
15</p><p>Deprecated include <code class="filename">backward/strstream</code> added.</p><p>Removal of include <code class="filename">builtinbuf.h</code>, <code class="filename">indstream.h</code>, <code class="filename">parsestream.h</code>, <code class="filename">PlotFile.h</code>, <code class="filename">SFile.h</code>, <code class="filename">stdiostream.h</code>, and <code class="filename">stream.h</code>.
16</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_310"></a><code class="constant">3.1</code></h3></div></div></div><p>
17  </p><p>
18Extensions from SGI/HP moved from <code class="code">namespace std</code>
19to <code class="code">namespace __gnu_cxx</code>. As part of this, the following
20new includes are
21added: <code class="filename">ext/algorithm</code>, <code class="filename">ext/functional</code>, <code class="filename">ext/iterator</code>, <code class="filename">ext/memory</code>, and <code class="filename">ext/numeric</code>.
22</p><p>
23Extensions to <code class="code">basic_filebuf</code> introduced: <code class="code">__gnu_cxx::enc_filebuf</code>, and <code class="code">__gnu_cxx::stdio_filebuf</code>.
24</p><p>
25Extensions to tree data structures added in <code class="filename">ext/rb_tree</code>.
26</p><p>
27Removal of <code class="filename">ext/tree</code>, moved to <code class="filename">backward/tree.h</code>.
28</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_320"></a><code class="constant">3.2</code></h3></div></div></div><p>
29  </p><p>Symbol versioning introduced for shared library.</p><p>Removal of include <code class="filename">backward/strstream.h</code>.</p><p>Allocator changes. Change <code class="code">__malloc_alloc</code> to <code class="code">malloc_allocator</code> and <code class="code">__new_alloc</code> to <code class="code">new_allocator</code>. </p><p> For GCC releases from 2.95 through the 3.1 series, defining
30   <code class="literal">__USE_MALLOC</code> on the gcc command line would change the
31   default allocation strategy to instead use <code class="code"> malloc</code> and
32   <code class="function">free</code>. For the 3.2 and 3.3 release series the same
33   functionality was spelled <code class="literal">_GLIBCXX_FORCE_NEW</code>. From
34   GCC 3.4 onwards the functionality is enabled by setting
35   <code class="literal">GLIBCXX_FORCE_NEW</code> in the environment, see
36   <a class="link" href="mt_allocator.html" title="Chapter 20. The mt_allocator">the mt allocator chapter</a>
37   for details.
38   </p><p>Error handling in iostreams cleaned up, made consistent. </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_330"></a><code class="constant">3.3</code></h3></div></div></div><p>
39  </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_340"></a><code class="constant">3.4</code></h3></div></div></div><p>
40  </p><p>
41Large file support.
42</p><p> Extensions for generic characters and <code class="code">char_traits</code> added in <code class="filename">ext/pod_char_traits.h</code>.
43</p><p>
44Support for <code class="code">wchar_t</code> specializations of <code class="code">basic_filebuf</code> enhanced to support <code class="code">UTF-8</code> and <code class="code">Unicode</code>, depending on host. More hosts support basic <code class="code">wchar_t</code> functionality.
45</p><p>
46Support for <code class="code">char_traits</code> beyond builtin types.
47</p><p>
48Conformant <code class="code">allocator</code> class and usage in containers. As
49part of this, the following extensions are
50added: <code class="filename">ext/bitmap_allocator.h</code>, <code class="filename">ext/debug_allocator.h</code>, <code class="filename">ext/mt_allocator.h</code>, <code class="filename">ext/malloc_allocator.h</code>,<code class="filename">ext/new_allocator.h</code>, <code class="filename">ext/pool_allocator.h</code>.
51</p><p>
52This is a change from all previous versions, and may require
53source-level changes due to allocator-related changes to structures
54names and template parameters, filenames, and file locations. Some,
55like <code class="code">__simple_alloc, __allocator, __alloc, </code> and <code class="code">
56_Alloc_traits</code> have been removed.
57</p><p>Default behavior of <code class="code">std::allocator</code> has changed.</p><p>
58   Previous versions prior to 3.4 cache allocations in a memory
59   pool, instead of passing through to call the global allocation
60   operators (i.e., <code class="classname">__gnu_cxx::pool_allocator</code>).  More
61   recent versions default to the
62   simpler <code class="classname">__gnu_cxx::new_allocator</code>.
63</p><p> Previously, all allocators were written to the SGI
64   style, and all STL containers expected this interface. This
65   interface had a traits class called <code class="code">_Alloc_traits</code> that
66   attempted to provide more information for compile-time allocation
67   selection and optimization. This traits class had another allocator
68   wrapper, <code class="code">__simple_alloc&lt;T,A&gt;</code>, which was a
69   wrapper around another allocator, A, which itself is an allocator
70   for instances of T. But wait, there's more:
71   <code class="code">__allocator&lt;T,A&gt;</code> is another adapter.  Many of
72   the provided allocator classes were SGI style: such classes can be
73   changed to a conforming interface with this wrapper:
74   <code class="code">__allocator&lt;T, __alloc&gt;</code> is thus the same as
75   <code class="code">allocator&lt;T&gt;</code>.
76   </p><p> The class <code class="classname">allocator</code> used the typedef
77   <span class="type">__alloc</span> to select an underlying allocator that
78   satisfied memory allocation requests. The selection of this
79   underlying allocator was not user-configurable.
80   </p><div class="table"><a id="table.extension_allocators"></a><p class="title"><strong>Table B.6. Extension Allocators</strong></p><div class="table-contents"><table class="table" summary="Extension Allocators" border="1"><colgroup><col align="left" class="c1" /><col align="left" class="c2" /><col align="left" class="c3" /><col align="left" class="c4" /></colgroup><thead><tr><th align="left">Allocator (3.4)</th><th align="left">Header (3.4)</th><th align="left">Allocator (3.[0-3])</th><th align="left">Header (3.[0-3])</th></tr></thead><tbody><tr><td align="left"><code class="classname">__gnu_cxx::new_allocator&lt;T&gt;</code></td><td align="left"><code class="filename">ext/new_allocator.h</code></td><td align="left"><code class="classname">std::__new_alloc</code></td><td align="left"><code class="filename">memory</code></td></tr><tr><td align="left"><code class="classname">__gnu_cxx::malloc_allocator&lt;T&gt;</code></td><td align="left"><code class="filename">ext/malloc_allocator.h</code></td><td align="left"><code class="classname">std::__malloc_alloc_template&lt;int&gt;</code></td><td align="left"><code class="filename">memory</code></td></tr><tr><td align="left"><code class="classname">__gnu_cxx::debug_allocator&lt;T&gt;</code></td><td align="left"><code class="filename">ext/debug_allocator.h</code></td><td align="left"><code class="classname">std::debug_alloc&lt;T&gt;</code></td><td align="left"><code class="filename">memory</code></td></tr><tr><td align="left"><code class="classname">__gnu_cxx::__pool_alloc&lt;T&gt;</code></td><td align="left"><code class="filename">ext/pool_allocator.h</code></td><td align="left"><code class="classname">std::__default_alloc_template&lt;bool,int&gt;</code></td><td align="left"><code class="filename">memory</code></td></tr><tr><td align="left"><code class="classname">__gnu_cxx::__mt_alloc&lt;T&gt;</code></td><td align="left"><code class="filename">ext/mt_allocator.h</code></td><td align="left"> </td><td align="left"> </td></tr><tr><td align="left"><code class="classname">__gnu_cxx::bitmap_allocator&lt;T&gt;</code></td><td align="left"><code class="filename">ext/bitmap_allocator.h</code></td><td align="left"> </td><td align="left"> </td></tr></tbody></table></div></div><br class="table-break" /><p> Releases after gcc-3.4 have continued to add to the collection
81   of available allocators. All of these new allocators are
82   standard-style. The following table includes details, along with
83   the first released version of GCC that included the extension allocator.
84   </p><div class="table"><a id="table.extension_allocators2"></a><p class="title"><strong>Table B.7. Extension Allocators Continued</strong></p><div class="table-contents"><table class="table" summary="Extension Allocators Continued" border="1"><colgroup><col align="left" class="c1" /><col align="left" class="c2" /><col align="left" class="c3" /></colgroup><thead><tr><th align="left">Allocator</th><th align="left">Include</th><th align="left">Version</th></tr></thead><tbody><tr><td align="left"><code class="classname">__gnu_cxx::array_allocator&lt;T&gt;</code></td><td align="left"><code class="filename">ext/array_allocator.h</code></td><td align="left">4.0.0</td></tr><tr><td align="left"><code class="classname">__gnu_cxx::throw_allocator&lt;T&gt;</code></td><td align="left"><code class="filename">ext/throw_allocator.h</code></td><td align="left">4.2.0</td></tr></tbody></table></div></div><br class="table-break" /><p>
85Debug mode first appears.
86</p><p>
87Precompiled header support <acronym class="acronym">PCH</acronym> support.
88</p><p>
89Macro guard for changed, from <code class="literal">_GLIBCPP_</code> to <code class="literal">_GLIBCXX_</code>.
90</p><p>
91Extension <code class="filename">ext/stdio_sync_filebuf.h</code> added.
92</p><p>
93Extension <code class="filename">ext/demangle.h</code> added.
94</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_400"></a><code class="constant">4.0</code></h3></div></div></div><p>
95  </p><p>
96TR1 features first appear.
97</p><p>
98Extension allocator <code class="filename">ext/array_allocator.h</code> added.
99</p><p>
100Extension <code class="code">codecvt</code> specializations moved to <code class="filename">ext/codecvt_specializations.h</code>.
101</p><p>
102Removal of <code class="filename">ext/demangle.h</code>.
103</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_410"></a><code class="constant">4.1</code></h3></div></div></div><p>
104  </p><p>
105Removal of <code class="filename">cassert</code> from all standard headers: now has to be explicitly included for <code class="code">std::assert</code> calls.
106</p><p> Extensions for policy-based data structures first added. New includes,
107types, namespace <code class="code">pb_assoc</code>.
108</p><p> Extensions for typelists added in <code class="filename">ext/typelist.h</code>.
109</p><p> Extension for policy-based <code class="code">basic_string</code> first added: <code class="code">__gnu_cxx::__versa_string</code> in <code class="filename">ext/vstring.h</code>.
110</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_420"></a><code class="constant">4.2</code></h3></div></div></div><p>
111  </p><p> Default visibility attributes applied to <code class="code">namespace std</code>. Support for <code class="code">-fvisibility</code>.
112</p><p>TR1 <code class="filename">random</code>, <code class="filename">complex</code>, and C compatibility headers added.</p><p> Extensions for concurrent programming consolidated
113into <code class="filename">ext/concurrence.h</code> and <code class="filename">ext/atomicity.h</code>,
114including change of namespace to <code class="code">__gnu_cxx</code> in some
115cases. Added types
116include <code class="code">_Lock_policy</code>, <code class="code">__concurrence_lock_error</code>, <code class="code">__concurrence_unlock_error</code>, <code class="code">__mutex</code>, <code class="code">__scoped_lock</code>.</p><p> Extensions for type traits consolidated
117into <code class="filename">ext/type_traits.h</code>. Additional traits are added
118(<code class="code">__conditional_type</code>, <code class="code">__enable_if</code>, others.)
119</p><p> Extensions for policy-based data structures revised. New includes,
120types, namespace moved to <code class="code">__pb_ds</code>.
121</p><p> Extensions for debug mode modified: now nested in <code class="code">namespace
122std::__debug</code> and extensions in <code class="code">namespace
123__gnu_cxx::__debug</code>.</p><p> Extensions added: <code class="filename">ext/typelist.h</code>
124and <code class="filename">ext/throw_allocator.h</code>.
125</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_430"></a><code class="constant">4.3</code></h3></div></div></div><p>
126  </p><p>
127C++0X features first appear.
128</p><p>TR1 <code class="filename">regex</code> and <code class="filename">cmath</code>'s mathematical special function added.
129</p><p>
130Backward include edit.
131</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Removed</p><p>
132<code class="filename">algobase.h</code> <code class="filename">algo.h</code> <code class="filename">alloc.h</code> <code class="filename">bvector.h</code> <code class="filename">complex.h</code>
133<code class="filename">defalloc.h</code> <code class="filename">deque.h</code> <code class="filename">fstream.h</code> <code class="filename">function.h</code> <code class="filename">hash_map.h</code> <code class="filename">hash_set.h</code>
134<code class="filename">hashtable.h</code> <code class="filename">heap.h</code> <code class="filename">iomanip.h</code> <code class="filename">iostream.h</code> <code class="filename">istream.h</code> <code class="filename">iterator.h</code>
135<code class="filename">list.h</code> <code class="filename">map.h</code> <code class="filename">multimap.h</code> <code class="filename">multiset.h</code> <code class="filename">new.h</code> <code class="filename">ostream.h</code> <code class="filename">pair.h</code> <code class="filename">queue.h</code> <code class="filename">rope.h</code> <code class="filename">set.h</code> <code class="filename">slist.h</code> <code class="filename">stack.h</code> <code class="filename">streambuf.h</code> <code class="filename">stream.h</code> <code class="filename">tempbuf.h</code>
136<code class="filename">tree.h</code> <code class="filename">vector.h</code>
137  </p></li><li class="listitem"><p>Added</p><p>
138  <code class="filename">hash_map</code> and <code class="filename">hash_set</code>
139  </p></li><li class="listitem"><p>Added in C++11</p><p>
140    <code class="filename">auto_ptr.h</code> and <code class="filename">binders.h</code>
141  </p></li></ul></div><p>
142Header dependency streamlining.
143</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><code class="filename">algorithm</code> no longer includes <code class="filename">climits</code>, <code class="filename">cstring</code>, or <code class="filename">iosfwd</code> </p></li><li class="listitem"><p><code class="filename">bitset</code> no longer includes <code class="filename">istream</code> or <code class="filename">ostream</code>, adds <code class="filename">iosfwd</code> </p></li><li class="listitem"><p><code class="filename">functional</code> no longer includes <code class="filename">cstddef</code></p></li><li class="listitem"><p><code class="filename">iomanip</code> no longer includes <code class="filename">istream</code>, <code class="filename">istream</code>, or <code class="filename">functional</code>, adds <code class="filename">ioswd</code> </p></li><li class="listitem"><p><code class="filename">numeric</code> no longer includes <code class="filename">iterator</code></p></li><li class="listitem"><p><code class="filename">string</code> no longer includes <code class="filename">algorithm</code> or <code class="filename">memory</code></p></li><li class="listitem"><p><code class="filename">valarray</code> no longer includes <code class="filename">numeric</code> or <code class="filename">cstdlib</code></p></li><li class="listitem"><p><code class="filename">tr1/hashtable</code> no longer includes <code class="filename">memory</code> or <code class="filename">functional</code></p></li><li class="listitem"><p><code class="filename">tr1/memory</code> no longer includes <code class="filename">algorithm</code></p></li><li class="listitem"><p><code class="filename">tr1/random</code> no longer includes <code class="filename">algorithm</code> or <code class="filename">fstream</code></p></li></ul></div><p>
144Debug mode for <code class="filename">unordered_map</code> and <code class="filename">unordered_set</code>.
145</p><p>
146Parallel mode first appears.
147</p><p>Variadic template implementations of items in <code class="filename">tuple</code> and
148    <code class="filename">functional</code>.
149</p><p>Default <code class="code">what</code> implementations give more elaborate
150    exception strings for <code class="code">bad_cast</code>,
151    <code class="code">bad_typeid</code>, <code class="code">bad_exception</code>, and
152    <code class="code">bad_alloc</code>.
153</p><p>
154PCH binary files no longer installed. Instead, the source files are installed.
155</p><p>
156Namespace pb_ds moved to __gnu_pb_ds.
157</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_440"></a><code class="constant">4.4</code></h3></div></div></div><p>
158  </p><p>
159C++0X features.
160</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
161    Added.
162  </p><p>
163    <code class="filename">atomic</code>,
164    <code class="filename">chrono</code>,
165    <code class="filename">condition_variable</code>,
166    <code class="filename">forward_list</code>,
167    <code class="filename">initializer_list</code>,
168    <code class="filename">mutex</code>,
169    <code class="filename">ratio</code>,
170    <code class="filename">thread</code>
171  </p></li><li class="listitem"><p>
172    Updated and improved.
173  </p><p>
174    <code class="filename">algorithm</code>,
175    <code class="filename">system_error</code>,
176    <code class="filename">type_traits</code>
177  </p></li><li class="listitem"><p>
178    Use of the GNU extension namespace association converted to inline namespaces.
179  </p></li><li class="listitem"><p>
180    Preliminary support for <code class="classname">initializer_list</code>
181    and defaulted and deleted constructors in container classes.
182  </p></li><li class="listitem"><p>
183    <code class="classname">unique_ptr</code>.
184  </p></li><li class="listitem"><p>
185    Support for new character types <span class="type">char16_t</span>
186    and <span class="type">char32_t</span> added
187    to <code class="classname">char_traits</code>, <code class="classname">basic_string</code>, <code class="classname">numeric_limits</code>,
188    and assorted compile-time type traits.
189  </p></li><li class="listitem"><p>
190    Support for string conversions <code class="function">to_string</code>
191    and <code class="function">to_wstring</code>.
192  </p></li><li class="listitem"><p>
193    Member functions taking string arguments were added to iostreams
194    including <code class="classname">basic_filebuf</code>, <code class="classname">basic_ofstream</code>,
195    and <code class="classname">basic_ifstream</code>.
196  </p></li><li class="listitem"><p>
197    Exception propagation support,
198    including <code class="classname">exception_ptr</code>, <code class="function">current_exception</code>, <code class="function">copy_exception</code>,
199    and <code class="function">rethrow_exception</code>.
200  </p></li></ul></div><p>
201Uglification of <code class="literal">try</code> to <code class="literal">__try</code>
202and <code class="literal">catch</code> to <code class="literal">__catch</code>.
203  </p><p>
204Audit of internal mutex usage, conversion to functions returning static
205local mutex.
206  </p><p> Extensions
207added: <code class="filename">ext/pointer.h</code>
208and <code class="filename">ext/extptr_allocator.h</code>. Support
209for non-standard pointer types has been added
210to <code class="classname">vector</code>
211and <code class="classname">forward_list</code>.
212</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_450"></a><code class="constant">4.5</code></h3></div></div></div><p>
213  </p><p>
214C++0X features.
215</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
216    Added.
217  </p><p>
218    <code class="filename">functional</code>,
219    <code class="filename">future</code>,
220    <code class="filename">random</code>
221  </p></li><li class="listitem"><p>
222    Updated and improved.
223  </p><p>
224    <code class="filename">atomic</code>,
225    <code class="filename">system_error</code>,
226    <code class="filename">type_traits</code>
227  </p></li><li class="listitem"><p>
228    Add support for explicit operators and standard layout types.
229  </p></li></ul></div><p>
230Profile mode first appears.
231</p><p>
232Support for decimal floating-point arithmetic, including <code class="classname">decimal32</code>, <code class="classname">decimal64</code>, and <code class="classname">decimal128</code>.
233</p><p>
234Python pretty-printers are added for use with appropriately-advanced versions of <span class="command"><strong>gdb</strong></span>.
235</p><p>
236Audit for application of function attributes nothrow, const, pure, and noreturn.
237</p><p>
238The default behavior for comparing typeinfo names changed, so
239in <code class="filename">typeinfo</code>, <code class="literal">__GXX_MERGED_TYPEINFO_NAMES</code>
240now defaults to zero.
241</p><p> Extensions modified: <code class="filename">ext/throw_allocator.h</code>.
242</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_460"></a><code class="constant">4.6</code></h3></div></div></div><p>
243  Use constexpr and nullptr where appropriate throughout the library.
244</p><p>
245  The library was updated to avoid including
246  <code class="filename">stddef.h</code> in order
247  to reduce namespace pollution.
248</p><p>Reference-count annotations to assist data race detectors.
249</p><p>
250  Added <code class="function">make_exception_ptr</code> as an alias of
251  <code class="function">copy_exception</code>.
252</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_470"></a><code class="constant">4.7</code></h3></div></div></div><p>Use of noexcept throughout library.</p><p>Partial support for C++11 allocators first appears.</p><p>
253  <code class="classname">monotonic_clock</code> renamed to
254  <code class="classname">steady_clock</code> as required by the final C++11
255  standard.
256</p><p>A new clocale model for newlib is available.</p><p>
257  The library was updated to avoid including
258  <code class="filename">unistd.h</code> in order
259  to reduce namespace pollution.
260</p><p>Debug Mode was improved for unordered containers. </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_480"></a><code class="constant">4.8</code></h3></div></div></div><p>
261  New random number engines and distributions.
262  Optimisations for random.
263</p><p>New --enable-libstdcxx-verbose configure option</p><p>
264  The --enable-libstdcxx-time configure option becomes unnecessary given a
265  sufficiently recent glibc.
266</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_490"></a><code class="constant">4.9</code></h3></div></div></div><p> Implementation of <code class="classname">regex</code> completed. </p><p> C++14 library and TS implementations are added. </p><p> <code class="function">copy_exception</code> deprecated. </p><p> <code class="classname">__gnu_cxx::array_allocator</code> deprecated. </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_51"></a><code class="constant">5</code></h3></div></div></div><p>
267  ABI transition adds new implementations of several components, using the
268  <code class="code">abi_tag</code> attribute and the <code class="code">__cxx11</code> inline
269  namespace to distinguish the new entities from the old ones.
270</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
271    Use of the new or old ABI can be selected per-translation unit with the
272    <a class="xref" href="using_macros.html" title="Macros">Macros</a>.
273  </p></li><li class="listitem"><p>
274    New non-reference-counted <code class="classname">string</code> implementation.
275  </p></li><li class="listitem"><p>
276    New <code class="classname">list</code> implementation containing a new
277    data member in order to provide O(1) <code class="function">size()</code>.
278  </p></li><li class="listitem"><p>
279    New <code class="classname">ios_base::failure</code> implementation inheriting
280    from <code class="classname">system_error</code>.
281  </p></li></ul></div><p>
282  C++11 support completed (movable iostreams, new I/O manipulators,
283  Unicode conversion utilities, atomic operations for
284  <code class="classname">shared_ptr</code>, functions for notifying condition
285  variables and making futures ready at thread exit).
286</p><p>
287   Changed formatting of floating point types when
288   <code class="code">ios_base::fixed|ios_base::scientific</code> is set in a stream's
289   format flags.
290</p><p> Improved C++14 support and TS implementations. </p><p> New random number engines and distributions. </p><p>
291  GDB Xmethods for containers and <code class="classname">unique_ptr</code> added.
292</p><p>
293  <code class="classname">has_trivial_default_constructor</code>,
294  <code class="classname">has_trivial_copy_constructor</code> and
295  <code class="classname">has_trivial_copy_assign</code> deprecated.
296</p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="api.rel_53"></a><code class="constant">5.3</code></h4></div></div></div><p> Experimental implementation of the C++ Filesystem TS added. </p></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_61"></a><code class="constant">6</code></h3></div></div></div><p> C++14 support completed. </p><p>
297  Support for mathematical special functions (ISO/IEC 29124:2010) added.
298</p><p>
299  Assertions to check function preconditions can be enabled by defining the
300  <a class="xref" href="using_macros.html" title="Macros">Macros</a>.
301  The initial set of assertions are a subset of the checks enabled by
302  the Debug Mode, but without the ABI changes and changes to algorithmic
303  complexity that are caused by enabling the full Debug Mode.
304</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_71"></a><code class="constant">7</code></h3></div></div></div><p>
305  The type of exception thrown by iostreams changed to the <code class="code">cxx11</code>
306  ABI version of <code class="classname">std::ios_base::failure</code>.
307</p><p>
308  Experimental C++17 support added, including most new library features.
309  The meaning of <code class="classname">shared_ptr&lt;T[]&gt;</code> changed to
310  match the C++17 semantics.
311</p><p>
312  <a class="xref" href="using_macros.html" title="Macros">Macros</a> added.
313</p><p>
314  <code class="classname">has_trivial_default_constructor</code>,
315  <code class="classname">has_trivial_copy_constructor</code> and
316  <code class="classname">has_trivial_copy_assign</code> removed.
317</p><p> Profile Mode was deprecated. </p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="api.rel_73"></a><code class="constant">7.3</code></h4></div></div></div><p>
318  Including new C++14 or C++17 headers without a suitable <code class="option">-std</code>
319  no longer causes compilation to fail via <code class="literal">#error</code>.
320  Instead the header is simply empty and doesn't define anything.
321</p></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="api.rel_81"></a><code class="constant">8</code></h3></div></div></div><p>
322  The exceptions thrown by iostreams can now be caught by handlers for either
323  version of <code class="classname">std::ios_base::failure</code>.
324</p><p>
325  Experimental implementation of the C++17 Filesystem library added.
326</p><p>
327  AddressSanitizer annotations added to <code class="classname">std::vector</code>
328  to detect out-of-range accesses to the unused capacity of a vector.
329</p><p>
330  <code class="function">std::char_traits&lt;char16_t&gt;::to_int_type(u'\uFFFF')</code>
331  now returns <code class="literal">0xFFFD</code>, as <code class="literal">0xFFFF</code> is
332  used for <code class="function">std::char_traits&lt;char16_t&gt;::eof()</code>.
333</p><p>
334  The extension allowing arithmetic on
335  <code class="classname">std::atomic&lt;void*&gt;</code> and types like
336  <code class="classname">std::atomic&lt;R(*)()&gt;</code> was deprecated.
337</p><p>
338  The <code class="function">std::uncaught_exception</code> function was deprecated
339  for C++17 mode.
340</p><p>
341  The nested typedefs <span class="type">std::hash::result_type</span> and
342  <span class="type">std::hash::argument_type</span> were deprecated for C++17 mode.
343</p><p>
344  The deprecated iostream members <span class="type">ios_base::io_state</span>,
345  <span class="type">ios_base::open_mode</span>, <span class="type">ios_base::seek_dir</span>, and
346  <code class="function">basic_streambuf::stossc</code> were removed for C++17 mode.
347</p><p>
348  The non-standard C++0x <code class="function">std::copy_exception</code> function
349  was removed.
350</p><p>
351  For <code class="option">-std=c++11</code>, <code class="option">-std=c++14</code>, and
352  <code class="option">-std=c++17</code> modes the <code class="filename">&lt;complex.h&gt;</code>
353  header no longer includes the C99 <code class="filename">&lt;complex.h&gt;</code>
354  header.
355</p><p>
356  For the non-default <code class="option">--enable-symvers=gnu-versioned-namespace</code>
357  configuration, the shared library SONAME has been changed to
358  <code class="filename">libstdc++.so.8</code>.
359</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="abi.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="appendix_porting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="backwards.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ABI Policy and Guidelines </td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> Backwards Compatibility</td></tr></table></div></body></html>