1<?xml version='1.0'?> 2<!DOCTYPE part [ 3 <!ENTITY DR 4"http://www.open-std.org/jtc1/sc22/wg21/docs/lwg-defects.html"> 5] > 6 7<part xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="manual.intro" xreflabel="Introduction"> 8<?dbhtml filename="intro.html"?> 9 10<info><title> 11 Introduction 12 <indexterm><primary>Introduction</primary></indexterm> 13</title> 14 <keywordset> 15 <keyword>ISO C++</keyword> 16 <keyword>library</keyword> 17 </keywordset> 18</info> 19 20 21<!-- Chapter 01 : Status --> 22<chapter xml:id="manual.intro.status" xreflabel="Status"><info><title>Status</title></info> 23 <?dbhtml filename="status.html"?> 24 25 26 <!-- Section 01 : Implementation Status --> 27 <section xml:id="manual.intro.status.iso" xreflabel="Status"><info><title>Implementation Status</title></info> 28 29 30 <!-- Section 01.1 : Status C++ 1998 --> 31 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxx1998.xml"> 32 </xi:include> 33 34 <!-- Section 01.2 : Status C++ 2011 --> 35 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxx2011.xml"> 36 </xi:include> 37 38 <!-- Section 01.3 : Status C++ 2014 --> 39 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxx2014.xml"> 40 </xi:include> 41 42 <!-- Section 01.4 : Status C++ 2017 --> 43 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxx2017.xml"> 44 </xi:include> 45 46 <!-- Section 01.5 : Status C++ TR1 --> 47 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxxtr1.xml"> 48 </xi:include> 49 50 <!-- Section 01.6 : Status C++ TR24733 --> 51 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxxtr24733.xml"> 52 </xi:include> 53 54 <!-- Section 01.7 : Status C++ IS 24733 --> 55 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxxis29124.xml"> 56 </xi:include> 57 </section> 58 59 <!-- Section 02 : License --> 60 <section xml:id="manual.intro.status.license" xreflabel="License"><info><title>License</title></info> 61 <?dbhtml filename="license.html"?> 62 63 <para> 64 There are two licenses affecting GNU libstdc++: one for the code, 65 and one for the documentation. 66 </para> 67 68 <para> 69 There is a license section in the FAQ regarding common <link linkend="faq.license">questions</link>. If you have more 70 questions, ask the FSF or the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/lists.html">gcc mailing list</link>. 71 </para> 72 73 <section xml:id="manual.intro.status.license.gpl" xreflabel="License GPL"><info><title>The Code: GPL</title></info> 74 75 76 <para> 77 The source code is distributed under the <link linkend="appendix.gpl-3.0">GNU General Public License version 3</link>, 78 with the addition under section 7 of an exception described in 79 the <quote>GCC Runtime Library Exception, version 3.1</quote> 80 as follows (or see the file COPYING.RUNTIME): 81 </para> 82 83 <literallayout class="normal"> 84GCC RUNTIME LIBRARY EXCEPTION 85 86Version 3.1, 31 March 2009 87 88Copyright (C) 2009 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.fsf.org">Free Software Foundation, Inc.</link> 89 90Everyone is permitted to copy and distribute verbatim copies of this 91license document, but changing it is not allowed. 92 93This GCC Runtime Library Exception ("Exception") is an additional 94permission under section 7 of the GNU General Public License, version 953 ("GPLv3"). It applies to a given file (the "Runtime Library") that 96bears a notice placed by the copyright holder of the file stating that 97the file is governed by GPLv3 along with this Exception. 98 99When you use GCC to compile a program, GCC may combine portions of 100certain GCC header files and runtime libraries with the compiled 101program. The purpose of this Exception is to allow compilation of 102non-GPL (including proprietary) programs to use, in this way, the 103header files and runtime libraries covered by this Exception. 104 1050. Definitions. 106 107A file is an "Independent Module" if it either requires the Runtime 108Library for execution after a Compilation Process, or makes use of an 109interface provided by the Runtime Library, but is not otherwise based 110on the Runtime Library. 111 112"GCC" means a version of the GNU Compiler Collection, with or without 113modifications, governed by version 3 (or a specified later version) of 114the GNU General Public License (GPL) with the option of using any 115subsequent versions published by the FSF. 116 117"GPL-compatible Software" is software whose conditions of propagation, 118modification and use would permit combination with GCC in accord with 119the license of GCC. 120 121"Target Code" refers to output from any compiler for a real or virtual 122target processor architecture, in executable form or suitable for 123input to an assembler, loader, linker and/or execution 124phase. Notwithstanding that, Target Code does not include data in any 125format that is used as a compiler intermediate representation, or used 126for producing a compiler intermediate representation. 127 128The "Compilation Process" transforms code entirely represented in 129non-intermediate languages designed for human-written code, and/or in 130Java Virtual Machine byte code, into Target Code. Thus, for example, 131use of source code generators and preprocessors need not be considered 132part of the Compilation Process, since the Compilation Process can be 133understood as starting with the output of the generators or 134preprocessors. 135 136A Compilation Process is "Eligible" if it is done using GCC, alone or 137with other GPL-compatible software, or if it is done without using any 138work based on GCC. For example, using non-GPL-compatible Software to 139optimize any GCC intermediate representations would not qualify as an 140Eligible Compilation Process. 141 1421. Grant of Additional Permission. 143 144You have permission to propagate a work of Target Code formed by 145combining the Runtime Library with Independent Modules, even if such 146propagation would otherwise violate the terms of GPLv3, provided that 147all Target Code was generated by Eligible Compilation Processes. You 148may then convey such a combination under terms of your choice, 149consistent with the licensing of the Independent Modules. 150 1512. No Weakening of GCC Copyleft. 152 153The availability of this Exception does not imply any general 154presumption that third-party software is unaffected by the copyleft 155requirements of the license of GCC. 156 </literallayout> 157 158 <para> 159 Hopefully that text is self-explanatory. If it isn't, you need to speak 160 to your lawyer, or the Free Software Foundation. 161 </para> 162 </section> 163 164 <section xml:id="manual.intro.status.license.fdl" xreflabel="License FDL"><info><title>The Documentation: GPL, FDL</title></info> 165 166 167 <para> 168 The documentation shipped with the library and made available over 169 the web, excluding the pages generated from source comments, are 170 copyrighted by the Free Software Foundation, and placed under the 171 <link linkend="appendix.gfdl-1.3"> GNU Free Documentation 172 License version 1.3</link>. There are no Front-Cover Texts, no 173 Back-Cover Texts, and no Invariant Sections. 174 </para> 175 176 <para> 177 For documentation generated by doxygen or other automated tools 178 via processing source code comments and markup, the original source 179 code license applies to the generated files. Thus, the doxygen 180 documents are licensed <link linkend="appendix.gpl-3.0">GPL</link>. 181 </para> 182 183 <para> 184 If you plan on making copies of the documentation, please let us know. 185 We can probably offer suggestions. 186 </para> 187 </section> 188 189 </section> 190 191 <!-- Section 03 : Known Bugs --> 192 <section xml:id="manual.intro.status.bugs" xreflabel="Bugs"><info><title>Bugs</title></info> 193 <?dbhtml filename="bugs.html"?> 194 195 196 <section xml:id="manual.intro.status.bugs.impl" xreflabel="Bugs impl"><info><title>Implementation Bugs</title></info> 197 198 <para> 199 Information on known bugs, details on efforts to fix them, and 200 fixed bugs are all available as part of the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://gcc.gnu.org/bugs/">GCC bug tracking system</link>, 201 under the component <quote>libstdc++</quote>. 202 </para> 203 </section> 204 205 <section xml:id="manual.intro.status.bugs.iso" xreflabel="Bugs iso"><info><title>Standard Bugs</title></info> 206 207 <para> 208 Everybody's got issues. Even the C++ Standard Library. 209 </para> 210 <para> 211 The Library Working Group, or LWG, is the ISO subcommittee responsible 212 for making changes to the library. They periodically publish an 213 Issues List containing problems and possible solutions. As they reach 214 a consensus on proposed solutions, we often incorporate the solution. 215 </para> 216 <para> 217 Here are the issues which have resulted in code changes to the library. 218 The links are to the full version of the Issues List. 219 You can read the full version online 220 at the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.open-std.org/jtc1/sc22/wg21/">ISO C++ 221 Committee homepage</link>. 222 </para> 223 <para> 224 If a DR is not listed here, we may simply not have gotten to 225 it yet; feel free to submit a patch. Search the 226 <filename class="directory">include</filename> and 227 <filename class="directory">src</filename> 228 directories for appearances of 229 <constant>_GLIBCXX_RESOLVE_LIB_DEFECTS</constant> for examples 230 of style. Note that we usually do not make changes to the 231 code until an issue has reached <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.open-std.org/jtc1/sc22/wg21/docs/lwg-active.html#DR">DR</link> status. 232 </para> 233 234 <variablelist> 235 <varlistentry xml:id="manual.bugs.dr5"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#5">5</link>: 236 <emphasis>string::compare specification questionable</emphasis> 237 </term> 238 <listitem><para>This should be two overloaded functions rather than a single function. 239 </para></listitem></varlistentry> 240 241 <varlistentry xml:id="manual.bugs.dr17"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#17">17</link>: 242 <emphasis>Bad bool parsing</emphasis> 243 </term> 244 <listitem><para>Apparently extracting Boolean values was messed up... 245 </para></listitem></varlistentry> 246 247 <varlistentry xml:id="manual.bugs.dr19"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#19">19</link>: 248 <emphasis>"Noconv" definition too vague</emphasis> 249 </term> 250 <listitem><para>If <code>codecvt::do_in</code> returns <code>noconv</code> there are 251 no changes to the values in <code>[to, to_limit)</code>. 252 </para></listitem></varlistentry> 253 254 <varlistentry xml:id="manual.bugs.dr22"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#22">22</link>: 255 <emphasis>Member open vs flags</emphasis> 256 </term> 257 <listitem><para>Re-opening a file stream does <emphasis>not</emphasis> clear the state flags. 258 </para></listitem></varlistentry> 259 260 <varlistentry xml:id="manual.bugs.dr23"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#23">23</link>: 261 <emphasis>Num_get overflow result</emphasis> 262 </term> 263 <listitem><para>Implement the proposed resolution. 264 </para></listitem></varlistentry> 265 266 <varlistentry xml:id="manual.bugs.dr25"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#25">25</link>: 267 <emphasis>String operator<< uses width() value wrong</emphasis> 268 </term> 269 <listitem><para>Padding issues. 270 </para></listitem></varlistentry> 271 272 <varlistentry xml:id="manual.bugs.dr48"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#48">48</link>: 273 <emphasis>Use of non-existent exception constructor</emphasis> 274 </term> 275 <listitem><para>An instance of <code>ios_base::failure</code> is constructed instead. 276 </para></listitem></varlistentry> 277 278 <varlistentry xml:id="manual.bugs.dr49"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#49">49</link>: 279 <emphasis>Underspecification of ios_base::sync_with_stdio</emphasis> 280 </term> 281 <listitem><para>The return type is the <emphasis>previous</emphasis> state of synchronization. 282 </para></listitem></varlistentry> 283 284 <varlistentry xml:id="manual.bugs.dr50"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#50">50</link>: 285 <emphasis>Copy constructor and assignment operator of ios_base</emphasis> 286 </term> 287 <listitem><para>These members functions are declared <code>private</code> and are 288 thus inaccessible. Specifying the correct semantics of 289 "copying stream state" was deemed too complicated. 290 </para></listitem></varlistentry> 291 292 <varlistentry xml:id="manual.bugs.dr60"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#60">60</link>: 293 <emphasis>What is a formatted input function?</emphasis> 294 </term> 295 <listitem><para>This DR made many widespread changes to <code>basic_istream</code> 296 and <code>basic_ostream</code> all of which have been implemented. 297 </para></listitem></varlistentry> 298 299 <varlistentry xml:id="manual.bugs.dr63"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#63">63</link>: 300 <emphasis>Exception-handling policy for unformatted output</emphasis> 301 </term> 302 <listitem><para>Make the policy consistent with that of formatted input, unformatted 303 input, and formatted output. 304 </para></listitem></varlistentry> 305 306 <varlistentry xml:id="manual.bugs.dr68"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#68">68</link>: 307 <emphasis>Extractors for char* should store null at end</emphasis> 308 </term> 309 <listitem><para>And they do now. An editing glitch in the last item in the list of 310 [27.6.1.2.3]/7. 311 </para></listitem></varlistentry> 312 313 <varlistentry xml:id="manual.bugs.dr74"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#74">74</link>: 314 <emphasis>Garbled text for codecvt::do_max_length</emphasis> 315 </term> 316 <listitem><para>The text of the standard was gibberish. Typos gone rampant. 317 </para></listitem></varlistentry> 318 319 <varlistentry xml:id="manual.bugs.dr75"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#75">75</link>: 320 <emphasis>Contradiction in codecvt::length's argument types</emphasis> 321 </term> 322 <listitem><para>Change the first parameter to <code>stateT&</code> and implement 323 the new effects paragraph. 324 </para></listitem></varlistentry> 325 326 <varlistentry xml:id="manual.bugs.dr83"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#83">83</link>: 327 <emphasis>string::npos vs. string::max_size()</emphasis> 328 </term> 329 <listitem><para>Safety checks on the size of the string should test against 330 <code>max_size()</code> rather than <code>npos</code>. 331 </para></listitem></varlistentry> 332 333 <varlistentry xml:id="manual.bugs.dr90"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#90">90</link>: 334 <emphasis>Incorrect description of operator>> for strings</emphasis> 335 </term> 336 <listitem><para>The effect contain <code>isspace(c,getloc())</code> which must be 337 replaced by <code>isspace(c,is.getloc())</code>. 338 </para></listitem></varlistentry> 339 340 <varlistentry xml:id="manual.bugs.dr91"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#91">91</link>: 341 <emphasis>Description of operator>> and getline() for string<> 342 might cause endless loop</emphasis> 343 </term> 344 <listitem><para>They behave as a formatted input function and as an unformatted 345 input function, respectively (except that <code>getline</code> is 346 not required to set <code>gcount</code>). 347 </para></listitem></varlistentry> 348 349 <varlistentry xml:id="manual.bugs.dr103"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#103">103</link>: 350 <emphasis>set::iterator is required to be modifiable, but this allows 351 modification of keys.</emphasis> 352 </term> 353 <listitem><para>For associative containers where the value type is the same as 354 the key type, both <code>iterator</code> and <code>const_iterator 355 </code> are constant iterators. 356 </para></listitem></varlistentry> 357 358 <varlistentry xml:id="manual.bugs.dr109"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#109">109</link>: 359 <emphasis>Missing binders for non-const sequence elements</emphasis> 360 </term> 361 <listitem><para>The <code>binder1st</code> and <code>binder2nd</code> didn't have an 362 <code>operator()</code> taking a non-const parameter. 363 </para></listitem></varlistentry> 364 365 <varlistentry xml:id="manual.bugs.dr110"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#110">110</link>: 366 <emphasis>istreambuf_iterator::equal not const</emphasis> 367 </term> 368 <listitem><para>This was not a const member function. Note that the DR says to 369 replace the function with a const one; we have instead provided an 370 overloaded version with identical contents. 371 </para></listitem></varlistentry> 372 373 <varlistentry xml:id="manual.bugs.dr117"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#117">117</link>: 374 <emphasis>basic_ostream uses nonexistent num_put member functions</emphasis> 375 </term> 376 <listitem><para><code>num_put::put()</code> was overloaded on the wrong types. 377 </para></listitem></varlistentry> 378 379 <varlistentry xml:id="manual.bugs.dr118"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#118">118</link>: 380 <emphasis>basic_istream uses nonexistent num_get member functions</emphasis> 381 </term> 382 <listitem><para>Same as 117, but for <code>num_get::get()</code>. 383 </para></listitem></varlistentry> 384 385 <varlistentry xml:id="manual.bugs.dr129"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#129">129</link>: 386 <emphasis>Need error indication from seekp() and seekg()</emphasis> 387 </term> 388 <listitem><para>These functions set <code>failbit</code> on error now. 389 </para></listitem></varlistentry> 390 391 <varlistentry xml:id="manual.bugs.dr130"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#130">130</link>: 392 <emphasis>Return type of container::erase(iterator) differs for associative containers</emphasis> 393 </term> 394 <listitem><para>Make member <code>erase</code> return iterator for <code>set</code>, <code>multiset</code>, <code>map</code>, <code>multimap</code>. 395 </para></listitem></varlistentry> 396 397 <varlistentry xml:id="manual.bugs.dr136"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#136">136</link>: 398 <emphasis>seekp, seekg setting wrong streams?</emphasis> 399 </term> 400 <listitem><para><code>seekp</code> should only set the output stream, and 401 <code>seekg</code> should only set the input stream. 402 </para></listitem></varlistentry> 403 404<!--<varlistentry><term><ulink url="&DR;#159">159</ulink>: 405 <emphasis>Strange use of underflow()</emphasis> 406 </term> 407 <listitem><para>In fstream.tcc, the basic_filebuf<>::showmanyc() function 408 should probably not be calling <code>underflow()</code>. 409 </para></listitem></varlistentry> --> 410 411 <varlistentry xml:id="manual.bugs.dr167"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#167">167</link>: 412 <emphasis>Improper use of traits_type::length()</emphasis> 413 </term> 414 <listitem><para><code>op<<</code> with a <code>const char*</code> was 415 calculating an incorrect number of characters to write. 416 </para></listitem></varlistentry> 417 418 <varlistentry xml:id="manual.bugs.dr169"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#169">169</link>: 419 <emphasis>Bad efficiency of overflow() mandated</emphasis> 420 </term> 421 <listitem><para>Grow efficiently the internal array object. 422 </para></listitem></varlistentry> 423 424 <varlistentry xml:id="manual.bugs.dr171"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#171">171</link>: 425 <emphasis>Strange seekpos() semantics due to joint position</emphasis> 426 </term> 427 <listitem><para>Quite complex to summarize... 428 </para></listitem></varlistentry> 429 430 <varlistentry xml:id="manual.bugs.dr181"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#181">181</link>: 431 <emphasis>make_pair() unintended behavior</emphasis> 432 </term> 433 <listitem><para>This function used to take its arguments as reference-to-const, now 434 it copies them (pass by value). 435 </para></listitem></varlistentry> 436 437 <varlistentry xml:id="manual.bugs.dr195"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#195">195</link>: 438 <emphasis>Should basic_istream::sentry's constructor ever set eofbit?</emphasis> 439 </term> 440 <listitem><para>Yes, it can, specifically if EOF is reached while skipping whitespace. 441 </para></listitem></varlistentry> 442 443 <varlistentry xml:id="manual.bugs.dr211"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#211">211</link>: 444 <emphasis>operator>>(istream&, string&) doesn't set failbit</emphasis> 445 </term> 446 <listitem><para>If nothing is extracted into the string, <code>op>></code> now 447 sets <code>failbit</code> (which can cause an exception, etc., etc.). 448 </para></listitem></varlistentry> 449 450 <varlistentry xml:id="manual.bugs.dr214"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#214">214</link>: 451 <emphasis>set::find() missing const overload</emphasis> 452 </term> 453 <listitem><para>Both <code>set</code> and <code>multiset</code> were missing 454 overloaded find, lower_bound, upper_bound, and equal_range functions 455 for const instances. 456 </para></listitem></varlistentry> 457 458 <varlistentry xml:id="manual.bugs.dr231"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#231">231</link>: 459 <emphasis>Precision in iostream?</emphasis> 460 </term> 461 <listitem><para>For conversion from a floating-point type, <code>str.precision()</code> 462 is specified in the conversion specification. 463 </para></listitem></varlistentry> 464 465 <varlistentry xml:id="manual.bugs.dr233"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#233">233</link>: 466 <emphasis>Insertion hints in associative containers</emphasis> 467 </term> 468 <listitem><para>Implement N1780, first check before then check after, insert as close 469 to hint as possible. 470 </para></listitem></varlistentry> 471 472 <varlistentry xml:id="manual.bugs.dr235"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#235">235</link>: 473 <emphasis>No specification of default ctor for reverse_iterator</emphasis> 474 </term> 475 <listitem><para>The declaration of <code>reverse_iterator</code> lists a default constructor. 476 However, no specification is given what this constructor should do. 477 </para></listitem></varlistentry> 478 479 <varlistentry xml:id="manual.bugs.dr241"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#241">241</link>: 480 <emphasis>Does unique_copy() require CopyConstructible and Assignable?</emphasis> 481 </term> 482 <listitem><para>Add a helper for forward_iterator/output_iterator, fix the existing 483 one for input_iterator/output_iterator to not rely on Assignability. 484 </para></listitem></varlistentry> 485 486 <varlistentry xml:id="manual.bugs.dr243"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#243">243</link>: 487 <emphasis>get and getline when sentry reports failure</emphasis> 488 </term> 489 <listitem><para>Store a null character only if the character array has a non-zero size. 490 </para></listitem></varlistentry> 491 492 <varlistentry xml:id="manual.bugs.dr251"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#251">251</link>: 493 <emphasis>basic_stringbuf missing allocator_type</emphasis> 494 </term> 495 <listitem><para>This nested typedef was originally not specified. 496 </para></listitem></varlistentry> 497 498 <varlistentry xml:id="manual.bugs.dr253"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#253">253</link>: 499 <emphasis>valarray helper functions are almost entirely useless</emphasis> 500 </term> 501 <listitem><para>Make the copy constructor and copy-assignment operator declarations 502 public in gslice_array, indirect_array, mask_array, slice_array; provide 503 definitions. 504 </para></listitem></varlistentry> 505 506 <varlistentry xml:id="manual.bugs.dr265"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#265">265</link>: 507 <emphasis>std::pair::pair() effects overly restrictive</emphasis> 508 </term> 509 <listitem><para>The default ctor would build its members from copies of temporaries; 510 now it simply uses their respective default ctors. 511 </para></listitem></varlistentry> 512 513 <varlistentry xml:id="manual.bugs.dr266"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#266">266</link>: 514 <emphasis>bad_exception::~bad_exception() missing Effects clause</emphasis> 515 </term> 516 <listitem><para>The <code>bad_</code>* classes no longer have destructors (they 517 are trivial), since no description of them was ever given. 518 </para></listitem></varlistentry> 519 520 <varlistentry xml:id="manual.bugs.dr271"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#271">271</link>: 521 <emphasis>basic_iostream missing typedefs</emphasis> 522 </term> 523 <listitem><para>The typedefs it inherits from its base classes can't be used, since 524 (for example) <code>basic_iostream<T>::traits_type</code> is ambiguous. 525 </para></listitem></varlistentry> 526 527 <varlistentry xml:id="manual.bugs.dr275"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#275">275</link>: 528 <emphasis>Wrong type in num_get::get() overloads</emphasis> 529 </term> 530 <listitem><para>Similar to 118. 531 </para></listitem></varlistentry> 532 533 <varlistentry xml:id="manual.bugs.dr280"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#280">280</link>: 534 <emphasis>Comparison of reverse_iterator to const reverse_iterator</emphasis> 535 </term> 536 <listitem><para>Add global functions with two template parameters. 537 (NB: not added for now a templated assignment operator) 538 </para></listitem></varlistentry> 539 540 <varlistentry xml:id="manual.bugs.dr292"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#292">292</link>: 541 <emphasis>Effects of a.copyfmt (a)</emphasis> 542 </term> 543 <listitem><para>If <code>(this == &rhs)</code> do nothing. 544 </para></listitem></varlistentry> 545 546 <varlistentry xml:id="manual.bugs.dr300"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#300">300</link>: 547 <emphasis>List::merge() specification incomplete</emphasis> 548 </term> 549 <listitem><para>If <code>(this == &x)</code> do nothing. 550 </para></listitem></varlistentry> 551 552 <varlistentry xml:id="manual.bugs.dr303"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#303">303</link>: 553 <emphasis>Bitset input operator underspecified</emphasis> 554 </term> 555 <listitem><para>Basically, compare the input character to 556 <code>is.widen(0)</code> and <code>is.widen(1)</code>. 557 </para></listitem></varlistentry> 558 559 <varlistentry xml:id="manual.bugs.dr305"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#305">305</link>: 560 <emphasis>Default behavior of codecvt<wchar_t, char, 561 mbstate_t>::length()</emphasis> 562 </term> 563 <listitem><para>Do not specify what <code>codecvt<wchar_t, char, 564 mbstate_t>::do_length</code> must return. 565 </para></listitem></varlistentry> 566 567 <varlistentry xml:id="manual.bugs.dr328"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#328">328</link>: 568 <emphasis>Bad sprintf format modifier in 569 money_put<>::do_put()</emphasis> 570 </term> 571 <listitem><para>Change the format string to "%.0Lf". 572 </para></listitem></varlistentry> 573 574 <varlistentry xml:id="manual.bugs.dr365"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#365">365</link>: 575 <emphasis>Lack of const-qualification in clause 27</emphasis> 576 </term> 577 <listitem><para>Add const overloads of <code>is_open</code>. 578 </para></listitem></varlistentry> 579 580 <varlistentry xml:id="manual.bugs.dr387"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#387">387</link>: 581 <emphasis>std::complex over-encapsulated</emphasis> 582 </term> 583 <listitem><para>Add the <code>real(T)</code> and <code>imag(T)</code> 584 members; in C++11 mode, also adjust the existing 585 <code>real()</code> and <code>imag()</code> members and 586 free functions. 587 </para></listitem></varlistentry> 588 589 <varlistentry xml:id="manual.bugs.dr389"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#389">389</link>: 590 <emphasis>Const overload of valarray::operator[] returns 591 by value</emphasis> 592 </term> 593 <listitem><para>Change it to return a <code>const T&</code>. 594 </para></listitem></varlistentry> 595 596 <varlistentry xml:id="manual.bugs.dr396"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#396">396</link>: 597 <emphasis>what are characters zero and one</emphasis> 598 </term> 599 <listitem><para>Implement the proposed resolution. 600 </para></listitem></varlistentry> 601 602 <varlistentry xml:id="manual.bugs.dr402"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#402">402</link>: 603 <emphasis>Wrong new expression in [some_]allocator::construct</emphasis> 604 </term> 605 <listitem><para>Replace "new" with "::new". 606 </para></listitem></varlistentry> 607 608 <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#408">408</link>: 609 <emphasis> 610 Is vector<reverse_iterator<char*> > forbidden? 611 </emphasis> 612 </term> 613 <listitem><para>Tweak the debug-mode checks in _Safe_iterator. 614 </para></listitem></varlistentry> 615 616 <varlistentry xml:id="manual.bugs.dr409"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#409">409</link>: 617 <emphasis>Closing an fstream should clear the error state</emphasis> 618 </term> 619 <listitem><para>Have <code>open</code> clear the error flags. 620 </para></listitem></varlistentry> 621 622 <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#431">431</link>: 623 <emphasis>Swapping containers with unequal allocators</emphasis> 624 </term> 625 <listitem><para>Implement Option 3, as per N1599. 626 </para></listitem></varlistentry> 627 628 <varlistentry xml:id="manual.bugs.dr432"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#432">432</link>: 629 <emphasis>stringbuf::overflow() makes only one write position 630 available</emphasis> 631 </term> 632 <listitem><para>Implement the resolution, beyond DR 169. 633 </para></listitem></varlistentry> 634 635 <varlistentry xml:id="manual.bugs.dr434"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#434">434</link>: 636 <emphasis>bitset::to_string() hard to use</emphasis> 637 </term> 638 <listitem><para>Add three overloads, taking fewer template arguments. 639 </para></listitem></varlistentry> 640 641 <varlistentry xml:id="manual.bugs.dr438"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#438">438</link>: 642 <emphasis>Ambiguity in the "do the right thing" clause</emphasis> 643 </term> 644 <listitem><para>Implement the resolution, basically cast less. 645 </para></listitem></varlistentry> 646 647 <varlistentry xml:id="manual.bugs.dr445"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#445">445</link>: 648 <emphasis>iterator_traits::reference unspecified for some iterator categories</emphasis> 649 </term> 650 <listitem><para>Change <code>istreambuf_iterator::reference</code> in C++11 mode. 651 </para></listitem></varlistentry> 652 653 <varlistentry xml:id="manual.bugs.dr453"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#453">453</link>: 654 <emphasis>basic_stringbuf::seekoff need not always fail for an empty stream</emphasis> 655 </term> 656 <listitem><para>Don't fail if the next pointer is null and newoff is zero. 657 </para></listitem></varlistentry> 658 659 <varlistentry xml:id="manual.bugs.dr455"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#455">455</link>: 660 <emphasis>cerr::tie() and wcerr::tie() are overspecified</emphasis> 661 </term> 662 <listitem><para>Initialize cerr tied to cout and wcerr tied to wcout. 663 </para></listitem></varlistentry> 664 665 <varlistentry xml:id="manual.bugs.dr464"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#464">464</link>: 666 <emphasis>Suggestion for new member functions in standard containers</emphasis> 667 </term> 668 <listitem><para>Add <code>data()</code> to <code>std::vector</code> and 669 <code>at(const key_type&)</code> to <code>std::map</code>. 670 </para></listitem></varlistentry> 671 672 <varlistentry xml:id="manual.bugs.dr467"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#467">467</link>: 673 <emphasis>char_traits::lt(), compare(), and memcmp()</emphasis> 674 </term> 675 <listitem><para>Change <code>lt</code>. 676 </para></listitem></varlistentry> 677 678 <varlistentry xml:id="manual.bugs.dr508"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#508">508</link>: 679 <emphasis>Bad parameters for ranlux64_base_01</emphasis> 680 </term> 681 <listitem><para>Fix the parameters. 682 </para></listitem></varlistentry> 683 684 <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#512">512</link>: 685 <emphasis>Seeding subtract_with_carry_01 from a single unsigned long</emphasis> 686 </term> 687 <listitem><para>Construct a <code>linear_congruential</code> engine and seed with it. 688 </para></listitem></varlistentry> 689 690 <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#526">526</link>: 691 <emphasis>Is it undefined if a function in the standard changes in 692 parameters?</emphasis> 693 </term> 694 <listitem><para>Use &value. 695 </para></listitem></varlistentry> 696 697 <varlistentry xml:id="manual.bugs.dr538"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#538">538</link>: 698 <emphasis>241 again: Does unique_copy() require CopyConstructible 699 and Assignable?</emphasis> 700 </term> 701 <listitem><para>In case of input_iterator/output_iterator rely on Assignability of 702 input_iterator' value_type. 703 </para></listitem></varlistentry> 704 705 <varlistentry xml:id="manual.bugs.dr539"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#539">539</link>: 706 <emphasis>partial_sum and adjacent_difference should mention 707 requirements</emphasis> 708 </term> 709 <listitem><para>We were almost doing the right thing, just use std::move 710 in adjacent_difference. 711 </para></listitem></varlistentry> 712 713 <varlistentry xml:id="manual.bugs.dr541"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#541">541</link>: 714 <emphasis>shared_ptr template assignment and void</emphasis> 715 </term> 716 <listitem><para>Add an auto_ptr<void> specialization. 717 </para></listitem></varlistentry> 718 719 <varlistentry xml:id="manual.bugs.dr543"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#543">543</link>: 720 <emphasis>valarray slice default constructor</emphasis> 721 </term> 722 <listitem><para>Follow the straightforward proposed resolution. 723 </para></listitem></varlistentry> 724 725 <varlistentry xml:id="manual.bugs.dr550"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#550">550</link>: 726 <emphasis>What should the return type of pow(float,int) be?</emphasis> 727 </term> 728 <listitem><para>In C++11 mode, remove the pow(float,int), etc., signatures. 729 </para></listitem></varlistentry> 730 731 <varlistentry xml:id="manual.bugs.dr586"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#586">586</link>: 732 <emphasis>string inserter not a formatted function</emphasis> 733 </term> 734 <listitem><para>Change it to be a formatted output function (i.e. catch exceptions). 735 </para></listitem></varlistentry> 736 737 <varlistentry xml:id="manual.bugs.dr596"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#596">596</link>: 738 <emphasis>27.8.1.3 Table 112 omits "a+" and "a+b" modes</emphasis> 739 </term> 740 <listitem><para>Add the missing modes to fopen_mode. 741 </para></listitem></varlistentry> 742 743 <varlistentry xml:id="manual.bugs.dr630"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#630">630</link>: 744 <emphasis>arrays of valarray</emphasis> 745 </term> 746 <listitem><para>Implement the simple resolution. 747 </para></listitem></varlistentry> 748 749 <varlistentry xml:id="manual.bugs.dr660"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#660">660</link>: 750 <emphasis>Missing bitwise operations</emphasis> 751 </term> 752 <listitem><para>Add the missing operations. 753 </para></listitem></varlistentry> 754 755 <varlistentry xml:id="manual.bugs.dr691"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#691">691</link>: 756 <emphasis>const_local_iterator cbegin, cend missing from TR1</emphasis> 757 </term> 758 <listitem><para>In C++11 mode add cbegin(size_type) and cend(size_type) 759 to the unordered containers. 760 </para></listitem></varlistentry> 761 762 <varlistentry xml:id="manual.bugs.dr693"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#693">693</link>: 763 <emphasis>std::bitset::all() missing</emphasis> 764 </term> 765 <listitem><para>Add it, consistently with the discussion. 766 </para></listitem></varlistentry> 767 768 <varlistentry xml:id="manual.bugs.dr695"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#695">695</link>: 769 <emphasis>ctype<char>::classic_table() not accessible</emphasis> 770 </term> 771 <listitem><para>Make the member functions table and classic_table public. 772 </para></listitem></varlistentry> 773 774 <varlistentry xml:id="manual.bugs.dr696"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#696">696</link>: 775 <emphasis>istream::operator>>(int&) broken</emphasis> 776 </term> 777 <listitem><para>Implement the straightforward resolution. 778 </para></listitem></varlistentry> 779 780 <varlistentry xml:id="manual.bugs.dr761"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#761">761</link>: 781 <emphasis>unordered_map needs an at() member function</emphasis> 782 </term> 783 <listitem><para>In C++11 mode, add at() and at() const. 784 </para></listitem></varlistentry> 785 786 <varlistentry xml:id="manual.bugs.dr775"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#775">775</link>: 787 <emphasis>Tuple indexing should be unsigned?</emphasis> 788 </term> 789 <listitem><para>Implement the int -> size_t replacements. 790 </para></listitem></varlistentry> 791 792 <varlistentry xml:id="manual.bugs.dr776"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#776">776</link>: 793 <emphasis>Undescribed assign function of std::array</emphasis> 794 </term> 795 <listitem><para>In C++11 mode, remove assign, add fill. 796 </para></listitem></varlistentry> 797 798 <varlistentry xml:id="manual.bugs.dr781"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#781">781</link>: 799 <emphasis>std::complex should add missing C99 functions</emphasis> 800 </term> 801 <listitem><para>In C++11 mode, add std::proj. 802 </para></listitem></varlistentry> 803 804 <varlistentry xml:id="manual.bugs.dr809"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#809">809</link>: 805 <emphasis>std::swap should be overloaded for array types</emphasis> 806 </term> 807 <listitem><para>Add the overload. 808 </para></listitem></varlistentry> 809 810 <varlistentry xml:id="manual.bugs.dr853"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#853">853</link>: 811 <emphasis>to_string needs updating with zero and one</emphasis> 812 </term> 813 <listitem><para>Update / add the signatures. 814 </para></listitem></varlistentry> 815 816 <varlistentry xml:id="manual.bugs.dr865"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#865">865</link>: 817 <emphasis>More algorithms that throw away information</emphasis> 818 </term> 819 <listitem><para>The traditional HP / SGI return type and value is blessed 820 by the resolution of the DR. 821 </para></listitem></varlistentry> 822 823 <varlistentry xml:id="manual.bugs.dr1339"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#1339">1339</link>: 824 <emphasis>uninitialized_fill_n should return the end of its range</emphasis> 825 </term> 826 <listitem><para>Return the end of the filled range. 827 </para></listitem></varlistentry> 828 829 <varlistentry xml:id="manual.bugs.dr2021"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2021">2021</link>: 830 <emphasis>Further incorrect uses of <code>result_of</code></emphasis> 831 </term> 832 <listitem><para>Correctly decay types in signature of <code>std::async</code>. 833 </para></listitem></varlistentry> 834 835 <varlistentry xml:id="manual.bugs.dr2049"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2049">2049</link>: 836 <emphasis><code>is_destructible</code> underspecified</emphasis> 837 </term> 838 <listitem><para>Handle non-object types. 839 </para></listitem></varlistentry> 840 841 <varlistentry xml:id="manual.bugs.dr2056"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2056">2056</link>: 842 <emphasis>future_errc enums start with value 0 (invalid value for broken_promise)</emphasis> 843 </term> 844 <listitem><para>Reorder enumerators. 845 </para></listitem></varlistentry> 846 847 <varlistentry xml:id="manual.bugs.dr2059"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2059">2059</link>: 848 <emphasis>C++0x ambiguity problem with map::erase</emphasis> 849 </term> 850 <listitem><para>Add additional overloads. 851 </para></listitem></varlistentry> 852 853 <varlistentry xml:id="manual.bugs.dr2062"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2062">2062</link>: 854 <emphasis>2062. Effect contradictions w/o no-throw guarantee of <code>std::function</code> swaps</emphasis> 855 </term> 856 <listitem><para>Add <code>noexcept</code> to swap functions. 857 </para></listitem></varlistentry> 858 859 <varlistentry xml:id="manual.bugs.dr2063"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2063">2063</link>: 860 <emphasis>Contradictory requirements for string move assignment</emphasis> 861 </term> 862 <listitem><para>Respect propagation trait for move assignment. 863 </para></listitem></varlistentry> 864 865 <varlistentry xml:id="manual.bugs.dr2064"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2064">2064</link>: 866 <emphasis>More noexcept issues in basic_string</emphasis> 867 </term> 868 <listitem><para>Add noexcept to the comparison operators. 869 </para></listitem></varlistentry> 870 871 <varlistentry xml:id="manual.bugs.dr2067"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2067">2067</link>: 872 <emphasis>packaged_task should have deleted copy c'tor with const parameter</emphasis> 873 </term> 874 <listitem><para>Fix signatures. 875 </para></listitem></varlistentry> 876 877 <varlistentry xml:id="manual.bugs.dr2101"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2101">2101</link>: 878 <emphasis>Some transformation types can produce impossible types</emphasis> 879 </term> 880 <listitem><para>Use the referenceable type concept. 881 </para></listitem></varlistentry> 882 883 <varlistentry xml:id="manual.bugs.dr2106"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2106">2106</link>: 884 <emphasis>move_iterator wrapping iterators returning prvalues</emphasis> 885 </term> 886 <listitem><para>Change the <code>reference</code> type. 887 </para></listitem></varlistentry> 888 889 <varlistentry xml:id="manual.bugs.dr2108"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2108">2108</link>: 890 <emphasis>No way to identify allocator types that always compare equal</emphasis> 891 </term> 892 <listitem><para>Define and use <code>is_always_equal</code> even for C++11. 893 </para></listitem></varlistentry> 894 895 <varlistentry xml:id="manual.bugs.dr2118"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2118">2118</link>: 896 <emphasis><code>unique_ptr</code> for array does not support cv qualification conversion of actual argument</emphasis> 897 </term> 898 <listitem><para>Adjust constraints to allow safe conversions. 899 </para></listitem></varlistentry> 900 901 <varlistentry xml:id="manual.bugs.dr2127"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2127">2127</link>: 902 <emphasis>Move-construction with <code>raw_storage_iterator</code></emphasis> 903 </term> 904 <listitem><para>Add assignment operator taking an rvalue. 905 </para></listitem></varlistentry> 906 907 <varlistentry xml:id="manual.bugs.dr2132"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2132">2132</link>: 908 <emphasis><code>std::function</code> ambiguity</emphasis> 909 </term> 910 <listitem><para>Constrain the constructor to only accept callable types. 911 </para></listitem></varlistentry> 912 913 <varlistentry xml:id="manual.bugs.dr2141"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2141">2141</link>: 914 <emphasis><code>common_type</code> trait produces reference types</emphasis> 915 </term> 916 <listitem><para>Use <code>decay</code> for the result type. 917 </para></listitem></varlistentry> 918 919 <varlistentry xml:id="manual.bugs.dr2144"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2144">2144</link>: 920 <emphasis>Missing <code>noexcept</code> specification in <code>type_index</code></emphasis> 921 </term> 922 <listitem><para>Add <code>noexcept</code> 923 </para></listitem></varlistentry> 924 925 <varlistentry xml:id="manual.bugs.dr2145"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2145">2145</link>: 926 <emphasis><code>error_category</code> default constructor</emphasis> 927 </term> 928 <listitem><para>Declare a public constexpr constructor. 929 </para></listitem></varlistentry> 930 931 <varlistentry xml:id="manual.bugs.dr2162"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2162">2162</link>: 932 <emphasis><code>allocator_traits::max_size</code> missing <code>noexcept</code></emphasis> 933 </term> 934 <listitem><para>Add <code>noexcept</code>. 935 </para></listitem></varlistentry> 936 937 <varlistentry xml:id="manual.bugs.dr2187"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2187">2187</link>: 938 <emphasis><code>vector<bool></code> is missing <code>emplace</code> and <code>emplace_back</code> member functions</emphasis> 939 </term> 940 <listitem><para>Add <code>emplace</code> and <code>emplace_back</code> member functions. 941 </para></listitem></varlistentry> 942 943 <varlistentry xml:id="manual.bugs.dr2192"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2192">2192</link>: 944 <emphasis>Validity and return type of <code>std::abs(0u)</code> is unclear</emphasis> 945 </term> 946 <listitem><para>Move all declarations to a common header and remove the 947 generic <code>abs</code> which accepted unsigned arguments. 948 </para></listitem></varlistentry> 949 950 <varlistentry xml:id="manual.bugs.dr2196"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2196">2196</link>: 951 <emphasis>Specification of <code>is_*[copy/move]_[constructible/assignable]</code> unclear for non-referencable types</emphasis> 952 </term> 953 <listitem><para>Use the referenceable type concept. 954 </para></listitem></varlistentry> 955 956 <varlistentry xml:id="manual.bugs.dr2212"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2212">2212</link>: 957 <emphasis><code>tuple_size</code> for <code>const pair</code> request <code><tuple></code> header</emphasis> 958 </term> 959 <listitem><para>The <code>tuple_size</code> and <code>tuple_element</code> 960 partial specializations are defined in <code><utility></code> which 961 is included by <code><array></code>. 962 </para></listitem></varlistentry> 963 964 <varlistentry xml:id="manual.bugs.dr2296"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2296">2296</link>: 965 <emphasis><code>std::addressof</code> should be constexpr</emphasis> 966 </term> 967 <listitem><para>Use <code>__builtin_addressof</code> and add 968 <code>constexpr</code> to <code>addressof</code> for C++17 and later. 969 </para></listitem></varlistentry> 970 971 <varlistentry xml:id="manual.bugs.dr2306"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2306">2306</link>: 972 <emphasis><code>match_results::reference</code> should be <code>value_type&</code>, not <code>const value_type&</code></emphasis> 973 </term> 974 <listitem><para>Change typedef. 975 </para></listitem></varlistentry> 976 977 <varlistentry xml:id="manual.bugs.dr2313"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2313">2313</link>: 978 <emphasis><code>tuple_size</code> should always derive from <code>integral_constant<size_t, N></code></emphasis> 979 </term> 980 <listitem><para>Update definitions of the partial specializations for const and volatile types. 981 </para></listitem></varlistentry> 982 983 <varlistentry xml:id="manual.bugs.dr2328"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2328">2328</link>: 984 <emphasis>Rvalue stream extraction should use perfect forwarding</emphasis> 985 </term> 986 <listitem><para>Use perfect forwarding for right operand. 987 </para></listitem></varlistentry> 988 989 <varlistentry xml:id="manual.bugs.dr2329"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2329">2329</link>: 990 <emphasis><code>regex_match()/regex_search()</code> with <code>match_results</code> should forbid temporary strings</emphasis> 991 </term> 992 <listitem><para>Add deleted overloads for rvalue strings. 993 </para></listitem></varlistentry> 994 995 <varlistentry xml:id="manual.bugs.dr2332"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2332">2332</link>: 996 <emphasis><code>regex_iterator/regex_token_iterator</code> should forbid temporary regexes</emphasis> 997 </term> 998 <listitem><para>Add deleted constructors. 999 </para></listitem></varlistentry> 1000 1001 <varlistentry xml:id="manual.bugs.dr2354"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2354">2332</link>: 1002 <emphasis>Unnecessary copying when inserting into maps with braced-init syntax</emphasis> 1003 </term> 1004 <listitem><para>Add overloads of <code>insert</code> taking <code>value_type&&</code> rvalues. 1005 </para></listitem></varlistentry> 1006 1007 <varlistentry xml:id="manual.bugs.dr2399"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2399">2399</link>: 1008 <emphasis><code>shared_ptr</code>'s constructor from <code>unique_ptr</code> should be constrained</emphasis> 1009 </term> 1010 <listitem><para>Constrain the constructor to require convertibility. 1011 </para></listitem></varlistentry> 1012 1013 <varlistentry xml:id="manual.bugs.dr2400"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2400">2400</link>: 1014 <emphasis><code>shared_ptr</code>'s <code>get_deleter()</code> should use <code>addressof()</code></emphasis> 1015 </term> 1016 <listitem><para>Use <code>addressof</code>. 1017 </para></listitem></varlistentry> 1018 1019 <varlistentry xml:id="manual.bugs.dr2401"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2401">2401</link>: 1020 <emphasis><code>std::function</code> needs more <code>noexcept</code></emphasis> 1021 </term> 1022 <listitem><para>Add <code>noexcept</code> to the assignment and comparisons. 1023 </para></listitem></varlistentry> 1024 1025 <varlistentry xml:id="manual.bugs.dr2407"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2407">2407</link>: 1026 <emphasis><code>packaged_task(allocator_arg_t, const Allocator&, F&&)</code> 1027 should neither be constrained nor <code>explicit</code> 1028 </emphasis> 1029 </term> 1030 <listitem><para>Remove <code>explicit</code> from the constructor. 1031 </para></listitem></varlistentry> 1032 1033 <varlistentry xml:id="manual.bugs.dr2415"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2415">2415</link>: 1034 <emphasis>Inconsistency between <code>unique_ptr</code> and <code>shared_ptr</code></emphasis> 1035 </term> 1036 <listitem><para>Create empty an <code>shared_ptr</code> from an empty 1037 <code>unique_ptr</code>. 1038 </para></listitem></varlistentry> 1039 1040 <varlistentry xml:id="manual.bugs.dr2418"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2418">2418</link>: 1041 <emphasis><code>apply</code> does not work with member pointers</emphasis> 1042 </term> 1043 <listitem><para>Use <code>mem_fn</code> for member pointers. 1044 </para></listitem></varlistentry> 1045 1046 <varlistentry xml:id="manual.bugs.dr2440"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2440">2440</link>: 1047 <emphasis><code>seed_seq::size()</code> should be <code>noexcept</code></emphasis> 1048 </term> 1049 <listitem><para>Add <code>noexcept</code>. 1050 </para></listitem></varlistentry> 1051 1052 <varlistentry xml:id="manual.bugs.dr2441"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2441">2441</link>: 1053 <emphasis>Exact-width atomic typedefs should be provided</emphasis> 1054 </term> 1055 <listitem><para>Define the typedefs. 1056 </para></listitem></varlistentry> 1057 1058 <varlistentry xml:id="manual.bugs.dr2442"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2442">2442</link>: 1059 <emphasis><code>call_once()</code> shouldn't <code>DECAY_COPY()</code></emphasis> 1060 </term> 1061 <listitem><para>Remove indirection through call wrapper that made copies 1062 of arguments and forward arguments straight to <code>std::invoke</code>. 1063 </para></listitem></varlistentry> 1064 1065 <varlistentry xml:id="manual.bugs.dr2454"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2454">2454</link>: 1066 <emphasis>Add <code>raw_storage_iterator::base()</code> member 1067 </emphasis> 1068 </term> 1069 <listitem><para>Add the <code>base()</code> member function. 1070 </para></listitem></varlistentry> 1071 1072 <varlistentry xml:id="manual.bugs.dr2455"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2455">2455</link>: 1073 <emphasis>Allocator default construction should be allowed to throw 1074 </emphasis> 1075 </term> 1076 <listitem><para>Make <code>noexcept</code> specifications conditional. 1077 </para></listitem></varlistentry> 1078 1079 <varlistentry xml:id="manual.bugs.dr2458"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2458">2458</link>: 1080 <emphasis>N3778 and new library deallocation signatures 1081 </emphasis> 1082 </term> 1083 <listitem><para>Remove unused overloads. 1084 </para></listitem></varlistentry> 1085 1086 <varlistentry xml:id="manual.bugs.dr2459"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2459">2459</link>: 1087 <emphasis><code>std::polar</code> should require a non-negative rho 1088 </emphasis> 1089 </term> 1090 <listitem><para>Add debug mode assertion. 1091 </para></listitem></varlistentry> 1092 1093 <varlistentry xml:id="manual.bugs.dr2466"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2466">2466</link>: 1094 <emphasis><code>allocator_traits::max_size()</code> default behavior is incorrect 1095 </emphasis> 1096 </term> 1097 <listitem><para>Divide by the object type. 1098 </para></listitem></varlistentry> 1099 1100 <varlistentry xml:id="manual.bugs.dr2484"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2484">2484</link>: 1101 <emphasis><code>rethrow_if_nested()</code> is doubly unimplementable 1102 </emphasis> 1103 </term> 1104 <listitem><para>Avoid using <code>dynamic_cast</code> when it would be 1105 ill-formed. 1106 </para></listitem></varlistentry> 1107 1108 <varlistentry xml:id="manual.bugs.dr2537"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2537">2537</link>: 1109 <emphasis>Constructors for <code>priority_queue</code> taking allocators 1110 should call <code>make_heap</code> 1111 </emphasis> 1112 </term> 1113 <listitem><para>Call <code>make_heap</code>. 1114 </para></listitem></varlistentry> 1115 1116 <varlistentry xml:id="manual.bugs.dr2583"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2583">2583</link>: 1117 <emphasis>There is no way to supply an allocator for <code>basic_string(str, pos)</code> 1118 </emphasis> 1119 </term> 1120 <listitem><para>Add new constructor 1121 </para></listitem></varlistentry> 1122 1123 <varlistentry xml:id="manual.bugs.dr2586"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2586">2586</link>: 1124 <emphasis>Wrong value category used in <code>scoped_allocator_adaptor::construct()</code> 1125 </emphasis> 1126 </term> 1127 <listitem><para>Change internal helper for uses-allocator construction 1128 to always check using const lvalue allocators. 1129 </para></listitem></varlistentry> 1130 1131 <varlistentry xml:id="manual.bugs.dr2684"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2684">2684</link>: 1132 <emphasis><code>priority_queue</code> lacking comparator typedef 1133 </emphasis> 1134 </term> 1135 <listitem><para>Define the <code>value_compare</code> typedef. 1136 </para></listitem></varlistentry> 1137 1138 <varlistentry xml:id="manual.bugs.dr2770"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2770">2770</link>: 1139 <emphasis><code>tuple_size<const T></code> specialization is not 1140 SFINAE compatible and breaks decomposition declarations 1141 </emphasis> 1142 </term> 1143 <listitem><para>Safely detect <code>tuple_size<T>::value</code> and 1144 only use it if valid. 1145 </para></listitem></varlistentry> 1146 1147 <varlistentry xml:id="manual.bugs.dr2781"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2781">2781</link>: 1148 <emphasis>Contradictory requirements for <code>std::function</code> 1149 and <code>std::reference_wrapper</code> 1150 </emphasis> 1151 </term> 1152 <listitem><para>Remove special handling for <code>reference_wrapper</code> 1153 arguments and store them directly as the target object. 1154 </para></listitem></varlistentry> 1155 1156 <varlistentry xml:id="manual.bugs.dr2802"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2802">2802</link>: 1157 <emphasis>Add noexcept to several <code>shared_ptr</code> related 1158 functions 1159 </emphasis> 1160 </term> 1161 <listitem><para>Add noexcept. 1162 </para></listitem></varlistentry> 1163 1164 <varlistentry xml:id="manual.bugs.dr2873"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2873">2873</link>: 1165 <emphasis><code>shared_ptr</code> constructor requirements for a deleter 1166 </emphasis> 1167 </term> 1168 <listitem><para>Use rvalues for deleters. 1169 </para></listitem></varlistentry> 1170 1171 <varlistentry xml:id="manual.bugs.dr2942"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2942">2942</link>: 1172 <emphasis>LWG 2873's resolution missed 1173 <code>weak_ptr::owner_before</code> 1174 </emphasis> 1175 </term> 1176 <listitem><para>Add noexcept. 1177 </para></listitem></varlistentry> 1178 1179 <varlistentry xml:id="manual.bugs.dr3076"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#3076">3076</link>: 1180 <emphasis><code>basic_string</code> CTAD ambiguity 1181 </emphasis> 1182 </term> 1183 <listitem><para>Change constructors to constrained templates. 1184 </para></listitem></varlistentry> 1185 1186 <varlistentry xml:id="manual.bugs.dr3096"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#3096">3096</link>: 1187 <emphasis><code>path::lexically_relative</code> is confused by trailing slashes 1188 </emphasis> 1189 </term> 1190 <listitem><para>Implement the fix for trailing slashes. 1191 </para></listitem></varlistentry> 1192 1193 </variablelist> 1194 1195 </section> 1196 </section> 1197</chapter> 1198 1199 1200<!-- Chapter 02 : Setup --> 1201<chapter xml:id="manual.intro.setup" xreflabel="Setup"><info><title>Setup</title></info> 1202 <?dbhtml filename="setup.html"?> 1203 1204 1205 <para>To transform libstdc++ sources into installed include files 1206 and properly built binaries useful for linking to other software is 1207 a multi-step process. Steps include getting the sources, 1208 configuring and building the sources, testing, and installation. 1209 </para> 1210 1211 <para>The general outline of commands is something like: 1212 </para> 1213 1214 <programlisting> 1215 <replaceable>get gcc sources</replaceable> 1216 <replaceable>extract into gccsrcdir</replaceable> 1217 mkdir <replaceable>gccbuilddir</replaceable> 1218 cd <replaceable>gccbuilddir</replaceable> 1219 <replaceable>gccsrcdir</replaceable>/configure --prefix=<replaceable>destdir</replaceable> --other-opts... 1220 make 1221 make check 1222 make install 1223 </programlisting> 1224 1225 <para> 1226 Each step is described in more detail in the following sections. 1227 </para> 1228 1229 <!-- Section 01 : Prerequisites --> 1230 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="prerequisites.xml"> 1231 </xi:include> 1232 1233 <!-- Section 02 : Configure --> 1234 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="configure.xml"> 1235 </xi:include> 1236 1237 <!-- Section 03 : Make --> 1238<section xml:id="manual.intro.setup.make" xreflabel="Make"><info><title>Make</title></info> 1239 <?dbhtml filename="make.html"?> 1240 1241 <para>If you have never done this before, you should read the basic 1242 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/install/">GCC Installation 1243 Instructions</link> first. Read <emphasis>all of them</emphasis>. 1244 <emphasis>Twice.</emphasis> 1245 </para> 1246 1247<para>Then type: <command>make</command>, and congratulations, you've 1248started to build. 1249</para> 1250 1251</section> 1252 1253</chapter> 1254 1255<!-- Chapter 03 : Using --> 1256<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="using.xml"> 1257</xi:include> 1258 1259</part> 1260