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">
3 <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 V1.73.2" /><meta name=
"keywords" content=
"ISO C++, api, evolution, deprecation, history" /><meta name=
"keywords" content=
" ISO C++ , library " /><link rel=
"start" href=
"../spine.html" title=
"The GNU C++ Library Documentation" /><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. Porting and Maintenance
</th><td width=
"20%" align=
"right"> <a accesskey=
"n" href=
"backwards.html">Next
</a></td></tr></table><hr /></div><div class=
"sect1" lang=
"en" xml:
lang=
"en"><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>
4 A list of user-visible changes, in chronological order
5 </p><div class=
"sect2" lang=
"en" xml:
lang=
"en"><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>
6 Extensions moved to
<code class=
"filename">include/ext
</code>.
8 Include files from the SGI/HP sources that pre-date the ISO standard
9 are added. These files are placed into
10 the
<code class=
"filename">include/backward
</code> directory and a deprecated warning
11 is added that notifies on inclusion (
<code class=
"literal">-Wno-deprecated
</code>
12 deactivates the warning.)
13 </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>.
14 </p></div><div class=
"sect2" lang=
"en" xml:
lang=
"en"><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>
16 Extensions from SGI/HP moved from
<code class=
"code">namespace std
</code>
17 to
<code class=
"code">namespace __gnu_cxx
</code>. As part of this, the following
19 added:
<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>.
21 Extensions 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>.
23 Extensions to tree data structures added in
<code class=
"filename">ext/rb_tree
</code>.
25 Removal of
<code class=
"filename">ext/tree
</code>, moved to
<code class=
"filename">backward/tree.h
</code>.
26 </p></div><div class=
"sect2" lang=
"en" xml:
lang=
"en"><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>
27 </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
28 <code class=
"literal">__USE_MALLOC
</code> on the gcc command line would change the
29 default allocation strategy to instead use
<code class=
"code"> malloc
</code> and
30 <code class=
"function">free
</code>. See
31 <a class=
"ulink" href=
"../23_containers/howto.html#3" target=
"_top">this note
</a>
32 for details as to why this was something needing improvement.
33 </p><p>Error handling in iostreams cleaned up, made consistent.
</p></div><div class=
"sect2" lang=
"en" xml:
lang=
"en"><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>
34 </p></div><div class=
"sect2" lang=
"en" xml:
lang=
"en"><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>
37 </p><p> Extensions for generic characters and
<code class=
"code">char_traits
</code> added in
<code class=
"filename">ext/pod_char_traits.h
</code>.
39 Support 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.
41 Support for
<code class=
"code">char_traits
</code> beyond builtin types.
43 Conformant
<code class=
"code">allocator
</code> class and usage in containers. As
44 part of this, the following extensions are
45 added:
<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>.
47 This is a change from all previous versions, and may require
48 source-level changes due to allocator-related changes to structures
49 names and template parameters, filenames, and file locations. Some,
50 like
<code class=
"code">__simple_alloc, __allocator, __alloc,
</code> and
<code class=
"code">
51 _Alloc_traits
</code> have been removed.
52 </p><p>Default behavior of
<code class=
"code">std::allocator
</code> has changed.
</p><p>
53 Previous versions prior to
3.4 cache allocations in a memory
54 pool, instead of passing through to call the global allocation
55 operators (i.e.,
<code class=
"classname">__gnu_cxx::pool_allocator
</code>). More
56 recent versions default to the
57 simpler
<code class=
"classname">__gnu_cxx::new_allocator
</code>.
58 </p><p> Previously, all allocators were written to the SGI
59 style, and all STL containers expected this interface. This
60 interface had a traits class called
<code class=
"code">_Alloc_traits
</code> that
61 attempted to provide more information for compile-time allocation
62 selection and optimization. This traits class had another allocator
63 wrapper,
<code class=
"code">__simple_alloc
<T,A
></code>, which was a
64 wrapper around another allocator, A, which itself is an allocator
65 for instances of T. But wait, there's more:
66 <code class=
"code">__allocator
<T,A
></code> is another adapter. Many of
67 the provided allocator classes were SGI style: such classes can be
68 changed to a conforming interface with this wrapper:
69 <code class=
"code">__allocator
<T, __alloc
></code> is thus the same as
70 <code class=
"code">allocator
<T
></code>.
71 </p><p> The class
<code class=
"classname">allocator
</code> used the typedef
72 <span class=
"type">__alloc
</span> to select an underlying allocator that
73 satisfied memory allocation requests. The selection of this
74 underlying allocator was not user-configurable.
75 </p><div class=
"table"><a id=
"id521812"></a><p class=
"title"><b>Table B
.1. Extension Allocators
</b></p><div class=
"table-contents"><table summary=
"Extension Allocators" border=
"1"><colgroup><col align=
"left" /><col align=
"left" /><col align=
"left" /><col align=
"left" /></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
<T
></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
<T
></code></td><td align=
"left"><code class=
"filename">ext/malloc_allocator.h
</code></td><td align=
"left"><code class=
"classname">std::__malloc_alloc_template
<int
></code></td><td align=
"left"><code class=
"filename">memory
</code></td></tr><tr><td align=
"left"><code class=
"classname">__gnu_cxx::debug_allocator
<T
></code></td><td align=
"left"><code class=
"filename">ext/debug_allocator.h
</code></td><td align=
"left"><code class=
"classname">std::debug_alloc
<T
></code></td><td align=
"left"><code class=
"filename">memory
</code></td></tr><tr><td align=
"left"><code class=
"classname">__gnu_cxx::__pool_alloc
<T
></code></td><td align=
"left"><code class=
"filename">ext/pool_allocator.h
</code></td><td align=
"left"><code class=
"classname">std::__default_alloc_template
<bool,int
></code></td><td align=
"left"><code class=
"filename">memory
</code></td></tr><tr><td align=
"left"><code class=
"classname">__gnu_cxx::__mt_alloc
<T
></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
<T
></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
76 of available allocators. All of these new allocators are
77 standard-style. The following table includes details, along with
78 the first released version of GCC that included the extension allocator.
79 </p><div class=
"table"><a id=
"id422487"></a><p class=
"title"><b>Table B
.2. Extension Allocators Continued
</b></p><div class=
"table-contents"><table summary=
"Extension Allocators Continued" border=
"1"><colgroup><col align=
"left" /><col align=
"left" /><col align=
"left" /></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
<T
></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
<T
></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>
80 Debug mode first appears.
82 Precompiled header support
<acronym class=
"acronym">PCH
</acronym> support.
84 Macro guard for changed, from
<code class=
"literal">_GLIBCPP_
</code> to
<code class=
"literal">_GLIBCXX_
</code>.
86 Extension
<code class=
"filename">ext/stdio_sync_filebuf.h
</code> added.
88 Extension
<code class=
"filename">ext/demangle.h
</code> added.
89 </p></div><div class=
"sect2" lang=
"en" xml:
lang=
"en"><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>
91 TR1 features first appear.
93 Extension allocator
<code class=
"filename">ext/array_allocator.h
</code> added.
95 Extension
<code class=
"code">codecvt
</code> specializations moved to
<code class=
"filename">ext/codecvt_specializations.h
</code>.
97 Removal of
<code class=
"filename">ext/demangle.h
</code>.
98 </p></div><div class=
"sect2" lang=
"en" xml:
lang=
"en"><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>
100 Removal of
<code class=
"filename">cassert
</code> from all standard headers: now has to be explicitly included for
<code class=
"code">std::assert
</code> calls.
101 </p><p> Extensions for policy-based data structures first added. New includes,
102 types, namespace
<code class=
"code">pb_assoc
</code>.
103 </p><p> Extensions for typelists added in
<code class=
"filename">ext/typelist.h
</code>.
104 </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>.
105 </p></div><div class=
"sect2" lang=
"en" xml:
lang=
"en"><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>
106 </p><p> Default visibility attributes applied to
<code class=
"code">namespace std
</code>. Support for
<code class=
"code">-fvisibility
</code>.
107 </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
108 into
<code class=
"filename">ext/concurrence.h
</code> and
<code class=
"filename">ext/atomicity.h
</code>,
109 including change of namespace to
<code class=
"code">__gnu_cxx
</code> in some
111 include
<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
112 into
<code class=
"filename">ext/type_traits.h
</code>. Additional traits are added
113 (
<code class=
"code">__conditional_type
</code>,
<code class=
"code">__enable_if
</code>, others.)
114 </p><p> Extensions for policy-based data structures revised. New includes,
115 types, namespace moved to
<code class=
"code">__pb_ds
</code>.
116 </p><p> Extensions for debug mode modified: now nested in
<code class=
"code">namespace
117 std::__debug
</code> and extensions in
<code class=
"code">namespace
118 __gnu_cxx::__debug
</code>.
</p><p> Extensions added:
<code class=
"filename">ext/typelist.h
</code>
119 and
<code class=
"filename">ext/throw_allocator.h
</code>.
120 </p></div><div class=
"sect2" lang=
"en" xml:
lang=
"en"><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>
122 C++
0X features first appear.
123 </p><p>TR1
<code class=
"filename">regex
</code> and
<code class=
"filename">cmath
</code>'s mathematical special function added.
</p><p>
124 Backward include edit.
125 </p><div class=
"itemizedlist"><ul type=
"disc"><li><p>Removed
</p><p>
126 <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>
127 <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>
128 <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>
129 <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>
130 <code class=
"filename">tree.h
</code> <code class=
"filename">vector.h
</code>
131 </p></li><li><p>Added
</p><p>
132 <code class=
"filename">hash_map
</code> and
<code class=
"filename">hash_set
</code>
133 </p></li><li><p>Added in C++
0x
</p><p>
134 <code class=
"filename">auto_ptr.h
</code> and
<code class=
"filename">binders.h
</code>
135 </p></li></ul></div><p>
136 Header dependency streamlining.
137 </p><div class=
"itemizedlist"><ul type=
"disc"><li><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><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><p><code class=
"filename">functional
</code> no longer includes
<code class=
"filename">cstddef
</code></p></li><li><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><p><code class=
"filename">numeric
</code> no longer includes
<code class=
"filename">iterator
</code></p></li><li><p><code class=
"filename">string
</code> no longer includes
<code class=
"filename">algorithm
</code> or
<code class=
"filename">memory
</code></p></li><li><p><code class=
"filename">valarray
</code> no longer includes
<code class=
"filename">numeric
</code> or
<code class=
"filename">cstdlib
</code></p></li><li><p><code class=
"filename">tr1/hashtable
</code> no longer includes
<code class=
"filename">memory
</code> or
<code class=
"filename">functional
</code></p></li><li><p><code class=
"filename">tr1/memory
</code> no longer includes
<code class=
"filename">algorithm
</code></p></li><li><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>
138 Debug mode for
<code class=
"filename">unordered_map
</code> and
<code class=
"filename">unordered_set
</code>.
140 Parallel mode first appears.
141 </p><p>Variadic template implementations of items in
<code class=
"filename">tuple
</code> and
142 <code class=
"filename">functional
</code>.
143 </p><p>Default
<code class=
"code">what
</code> implementations give more elaborate
144 exception strings for
<code class=
"code">bad_cast
</code>,
145 <code class=
"code">bad_typeid
</code>,
<code class=
"code">bad_exception
</code>, and
146 <code class=
"code">bad_alloc
</code>.
148 PCH binary files no longer installed. Instead, the source files are installed.
150 Namespace pb_ds moved to __gnu_pb_ds.
151 </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=
"../spine.html">Home
</a></td><td width=
"40%" align=
"right" valign=
"top"> Backwards Compatibility
</td></tr></table></div></body></html>