relnotes.html 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
  4. <title>Release Notes</title>
  5. <link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
  6. <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
  7. <link rel="home" href="../index.html" title="Boost.Optional">
  8. <link rel="up" href="../index.html" title="Boost.Optional">
  9. <link rel="prev" href="dependencies_and_portability/optional_reference_binding.html" title="Optional Reference Binding">
  10. <link rel="next" href="acknowledgements.html" title="Acknowledgements">
  11. </head>
  12. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  13. <table cellpadding="2" width="100%"><tr>
  14. <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
  15. <td align="center"><a href="../../../../../index.html">Home</a></td>
  16. <td align="center"><a href="../../../../../libs/libraries.htm">Libraries</a></td>
  17. <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
  18. <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
  19. <td align="center"><a href="../../../../../more/index.htm">More</a></td>
  20. </tr></table>
  21. <hr>
  22. <div class="spirit-nav">
  23. <a accesskey="p" href="dependencies_and_portability/optional_reference_binding.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="acknowledgements.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
  24. </div>
  25. <div class="section">
  26. <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  27. <a name="boost_optional.relnotes"></a><a class="link" href="relnotes.html" title="Release Notes">Release Notes</a>
  28. </h2></div></div></div>
  29. <h4>
  30. <a name="boost_optional.relnotes.h0"></a>
  31. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_69"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_69">Boost
  32. Release 1.69</a>
  33. </h4>
  34. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  35. <li class="listitem">
  36. Remove deprecation mark from <code class="computeroutput"><span class="identifier">reset</span><span class="special">()</span></code> method (without arguments).
  37. </li>
  38. <li class="listitem">
  39. Fixed <a href="https://github.com/boostorg/optional/issues/59" target="_top">issue
  40. #59</a>.
  41. </li>
  42. <li class="listitem">
  43. Fixed bug with initialization of certain wrapper types in clang with -std=c++03.
  44. See <a href="https://github.com/boostorg/optional/pull/64" target="_top">pr #64</a>.
  45. </li>
  46. </ul></div>
  47. <h4>
  48. <a name="boost_optional.relnotes.h1"></a>
  49. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_68"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_68">Boost
  50. Release 1.68</a>
  51. </h4>
  52. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  53. <li class="listitem">
  54. Added member function <code class="computeroutput"><span class="identifier">has_value</span><span class="special">()</span></code> for compatibility with <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">optional</span></code> (<a href="https://github.com/boostorg/optional/issues/52" target="_top">issue
  55. #52</a>).
  56. </li>
  57. <li class="listitem">
  58. Added member function <code class="computeroutput"><span class="identifier">map</span><span class="special">()</span></code> for transforming <code class="computeroutput"><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span></code> into <code class="computeroutput"><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">U</span><span class="special">&gt;</span></code> using a function of type <code class="computeroutput"><span class="identifier">T</span> <span class="special">-&gt;</span> <span class="identifier">U</span></code>.
  59. </li>
  60. <li class="listitem">
  61. Added member function <code class="computeroutput"><span class="identifier">flat_map</span><span class="special">()</span></code> for transforming <code class="computeroutput"><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span></code> into <code class="computeroutput"><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">U</span><span class="special">&gt;</span></code> using a function of type <code class="computeroutput"><span class="identifier">T</span> <span class="special">-&gt;</span> <span class="identifier">optonal</span><span class="special">&lt;</span><span class="identifier">U</span><span class="special">&gt;</span></code>.
  62. </li>
  63. </ul></div>
  64. <h4>
  65. <a name="boost_optional.relnotes.h2"></a>
  66. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_67"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_67">Boost
  67. Release 1.67</a>
  68. </h4>
  69. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  70. <li class="listitem">
  71. Fixed <a href="https://github.com/boostorg/optional/issues/46" target="_top">issue
  72. #46</a>.
  73. </li>
  74. <li class="listitem">
  75. Fixed <code class="computeroutput"><span class="special">-</span><span class="identifier">Wzero</span><span class="special">-</span><span class="identifier">as</span><span class="special">-</span><span class="identifier">null</span><span class="special">-</span><span class="identifier">pointer</span><span class="special">-</span><span class="identifier">constant</span></code> warnings.
  76. </li>
  77. </ul></div>
  78. <h4>
  79. <a name="boost_optional.relnotes.h3"></a>
  80. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_66"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_66">Boost
  81. Release 1.66</a>
  82. </h4>
  83. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  84. <li class="listitem">
  85. On newer compilers <code class="computeroutput"><span class="identifier">optional</span></code>
  86. is now trivially-copyable for scalar <code class="computeroutput"><span class="identifier">T</span></code>s.
  87. This uses a different storage (just <code class="computeroutput"><span class="identifier">T</span></code>
  88. rather than <code class="computeroutput"><span class="identifier">aligned_storage</span></code>).
  89. We require the compiler to support defaulted functions.
  90. </li>
  91. <li class="listitem">
  92. Changed the implementation of <code class="computeroutput"><span class="keyword">operator</span><span class="special">==</span></code> to get rid of the <code class="computeroutput"><span class="special">-</span><span class="identifier">Wmaybe</span><span class="special">-</span><span class="identifier">uninitialized</span></code> false-positive warning
  93. from GCC.
  94. </li>
  95. </ul></div>
  96. <h4>
  97. <a name="boost_optional.relnotes.h4"></a>
  98. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_63"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_63">Boost
  99. Release 1.63</a>
  100. </h4>
  101. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  102. <li class="listitem">
  103. Added two new in-place constructors. They work similarly to <code class="computeroutput"><span class="identifier">emplace</span><span class="special">()</span></code>
  104. functions: they initialize the contained value by perfect-forwarding the
  105. obtained arguments. One constructor always initializes the contained value,
  106. the other based on a boolean condition.
  107. </li>
  108. <li class="listitem">
  109. Syntax <code class="computeroutput"><span class="identifier">o</span> <span class="special">=</span>
  110. <span class="special">{}</span></code> now correctly un-initializes
  111. optional, just like in <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">optional</span></code>.
  112. </li>
  113. <li class="listitem">
  114. Fixed <a href="https://svn.boost.org/trac/boost/ticket/12203" target="_top">Trac #12203</a>.
  115. </li>
  116. <li class="listitem">
  117. Fixed <a href="https://svn.boost.org/trac/boost/ticket/12563" target="_top">Trac #12563</a>.
  118. </li>
  119. </ul></div>
  120. <h4>
  121. <a name="boost_optional.relnotes.h5"></a>
  122. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_62"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_62">Boost
  123. Release 1.62</a>
  124. </h4>
  125. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
  126. Fixed <a href="https://svn.boost.org/trac/boost/ticket/12179" target="_top">Trac #12179</a>.
  127. </li></ul></div>
  128. <h4>
  129. <a name="boost_optional.relnotes.h6"></a>
  130. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_61"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_61">Boost
  131. Release 1.61</a>
  132. </h4>
  133. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  134. <li class="listitem">
  135. Now <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span></code> is specialized for reference
  136. parameters. This addresses a couple of issues:
  137. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; ">
  138. <li class="listitem">
  139. the <code class="computeroutput"><span class="keyword">sizeof</span></code> of optional
  140. reference is that of a pointer,
  141. </li>
  142. <li class="listitem">
  143. some bugs connected to copying optional references are gone,
  144. </li>
  145. <li class="listitem">
  146. all run-time bugs caused by incorrect reference binding on some compilers
  147. are now turned into compile-time errors,
  148. </li>
  149. <li class="listitem">
  150. you can swap optional references: it is like swapping pointers: shalow,
  151. underlying objects are not affected,
  152. </li>
  153. <li class="listitem">
  154. optional references to abstract types work.
  155. </li>
  156. </ul></div>
  157. </li>
  158. <li class="listitem">
  159. Documented nested typedefs (<a href="https://svn.boost.org/trac/boost/ticket/5193" target="_top">Trac
  160. #5193</a>).
  161. </li>
  162. <li class="listitem">
  163. Made the perfect-forwarding constructor SFINAE-friendly, which fixes <a href="https://svn.boost.org/trac/boost/ticket/12002" target="_top">Trac #12002</a>.
  164. However, this only works in the newer platforms that correctly implement
  165. C++11 <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">type_traits</span><span class="special">&gt;</span></code>.
  166. </li>
  167. <li class="listitem">
  168. Fixed <a href="https://svn.boost.org/trac/boost/ticket/10445" target="_top">Trac #10445</a>.
  169. </li>
  170. </ul></div>
  171. <h4>
  172. <a name="boost_optional.relnotes.h7"></a>
  173. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_60"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_60">Boost
  174. Release 1.60</a>
  175. </h4>
  176. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
  177. Changed the implementation of <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">none</span></code>
  178. again. Now it is a const object with internal linkage (as any other tag).
  179. This fixes <a href="https://svn.boost.org/trac/boost/ticket/11203" target="_top">Trac
  180. #11203</a>.
  181. </li></ul></div>
  182. <h4>
  183. <a name="boost_optional.relnotes.h8"></a>
  184. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_59"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_59">Boost
  185. Release 1.59</a>
  186. </h4>
  187. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  188. <li class="listitem">
  189. For C++03 compilers, added 0-argument overload for member function <code class="computeroutput"><span class="identifier">emplace</span><span class="special">()</span></code>,
  190. and therewith removed the dependency on <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">utility</span><span class="special">/</span><span class="identifier">in_place_factory</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>.
  191. </li>
  192. <li class="listitem">
  193. Fixed <a href="https://svn.boost.org/trac/boost/ticket/11241" target="_top">Trac #11241</a>.
  194. </li>
  195. </ul></div>
  196. <h4>
  197. <a name="boost_optional.relnotes.h9"></a>
  198. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_58"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_58">Boost
  199. Release 1.58</a>
  200. </h4>
  201. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  202. <li class="listitem">
  203. <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">none_t</span></code> is no longer convertible from
  204. literal <code class="computeroutput"><span class="number">0</span></code>. This avoids a bug
  205. where <code class="computeroutput"><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">rational</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;&gt;</span> <span class="identifier">oi</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span></code> would
  206. initialize an optional object with no contained value.
  207. </li>
  208. <li class="listitem">
  209. Improved the trick that prevents streaming out <code class="computeroutput"><span class="identifier">optional</span></code>
  210. without header <code class="computeroutput"><span class="identifier">optional_io</span><span class="special">.</span><span class="identifier">hpp</span></code>
  211. by using safe-bool idiom. This addresses <a href="https://svn.boost.org/trac/boost/ticket/10825" target="_top">Trac
  212. #10825</a>.
  213. </li>
  214. <li class="listitem">
  215. IOStream operators are now mentioned in documentation.
  216. </li>
  217. <li class="listitem">
  218. Added a way to manually disable move semantics: just define macro <code class="computeroutput"><span class="identifier">BOOST_OPTIONAL_CONFIG_NO_RVALUE_REFERENCES</span></code>.
  219. This can be used to work around <a href="https://svn.boost.org/trac/boost/ticket/10399" target="_top">Trac
  220. #10399</a>.
  221. </li>
  222. <li class="listitem">
  223. It is no longer possible to assign <code class="computeroutput"><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">U</span><span class="special">&gt;</span></code> to <code class="computeroutput"><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span></code> when <code class="computeroutput"><span class="identifier">U</span></code>
  224. is not assignable or convertible to <code class="computeroutput"><span class="identifier">T</span></code>
  225. (<a href="https://svn.boost.org/trac/boost/ticket/11087" target="_top">Trac #11087</a>).
  226. </li>
  227. <li class="listitem">
  228. Value accessors now work correctly on rvalues of <code class="computeroutput"><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&amp;&gt;</span></code> (<a href="https://svn.boost.org/trac/boost/ticket/10839" target="_top">Trac
  229. #10839</a>).
  230. </li>
  231. </ul></div>
  232. <h4>
  233. <a name="boost_optional.relnotes.h10"></a>
  234. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_57"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_57">Boost
  235. Release 1.57</a>
  236. </h4>
  237. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
  238. <a href="https://github.com/boostorg/optional/pull/9" target="_top">Git pull #9</a>:
  239. <span class="emphasis"><em>"Supply <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">string</span><span class="special">&gt;</span></code>
  240. to fix C++03 compile error on <code class="computeroutput"><span class="identifier">logic_error</span><span class="special">(</span><span class="string">"..."</span><span class="special">)</span></code>"</em></span>.
  241. </li></ul></div>
  242. <h4>
  243. <a name="boost_optional.relnotes.h11"></a>
  244. <span class="phrase"><a name="boost_optional.relnotes.boost_release_1_56"></a></span><a class="link" href="relnotes.html#boost_optional.relnotes.boost_release_1_56">Boost
  245. Release 1.56</a>
  246. </h4>
  247. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  248. <li class="listitem">
  249. Added support for rvalue references. Now <code class="computeroutput"><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span></code> works with moveable but non-copyable
  250. <code class="computeroutput"><span class="identifier">T</span></code>'s,
  251. </li>
  252. <li class="listitem">
  253. Improved <code class="computeroutput"><span class="identifier">swap</span></code> (now uses
  254. move operations),
  255. </li>
  256. <li class="listitem">
  257. Added function <code class="computeroutput"><span class="identifier">emplace</span><span class="special">()</span></code>. This is the last of the requests from
  258. <a href="https://svn.boost.org/trac/boost/ticket/1841" target="_top">Trac #1841</a>,
  259. </li>
  260. <li class="listitem">
  261. <code class="computeroutput"><span class="identifier">optional</span></code> is moveable, including
  262. conditional <code class="computeroutput"><span class="keyword">noexcept</span></code> specifications,
  263. which make it <code class="computeroutput"><span class="identifier">move_if_noexcept</span></code>-friendly,
  264. </li>
  265. <li class="listitem">
  266. Using explicit operator bool() on platforms that support it (<a href="https://svn.boost.org/trac/boost/ticket/4227" target="_top">Trac
  267. #4227</a>) (breaking change),
  268. </li>
  269. <li class="listitem">
  270. Forward declaration of <code class="computeroutput"><span class="keyword">operator</span><span class="special">&lt;&lt;(</span><span class="identifier">ostream</span><span class="special">&amp;,</span> <span class="identifier">optional</span>
  271. <span class="keyword">const</span><span class="special">&amp;)</span></code>
  272. to prevent inadvertent incorrect serialization of optional objects,
  273. </li>
  274. <li class="listitem">
  275. Removed deprecated function <code class="computeroutput"><span class="identifier">reset</span><span class="special">()</span></code> from examples (<a href="https://svn.boost.org/trac/boost/ticket/9005" target="_top">Trac
  276. #9005</a>),
  277. </li>
  278. <li class="listitem">
  279. Equality comparison with <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">none</span></code>
  280. does not require that <code class="computeroutput"><span class="identifier">T</span></code>
  281. be EqualityComparable,
  282. </li>
  283. <li class="listitem">
  284. Optional rvalue references are explicitly disallowed,
  285. </li>
  286. <li class="listitem">
  287. Binding temporaries to optional references is explicitly disallowed (breaking
  288. change),
  289. </li>
  290. <li class="listitem">
  291. More ways to access the contained value, functions <code class="computeroutput"><span class="identifier">value</span><span class="special">()</span></code>, <code class="computeroutput"><span class="identifier">value_or</span><span class="special">()</span></code>, <code class="computeroutput"><span class="identifier">value_or_eval</span><span class="special">()</span></code>,
  292. </li>
  293. <li class="listitem">
  294. Updated and reorganized documentation, added tutorial and quick guide sections.
  295. </li>
  296. </ul></div>
  297. </div>
  298. <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
  299. <td align="left"></td>
  300. <td align="right"><div class="copyright-footer">Copyright &#169; 2003-2007 Fernando Luis Cacciola Carballal<br>Copyright &#169; 2014-2018 Andrzej Krzemie&#324;ski<p>
  301. Distributed under the Boost Software License, Version 1.0. (See accompanying
  302. file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
  303. </p>
  304. </div></td>
  305. </tr></table>
  306. <hr>
  307. <div class="spirit-nav">
  308. <a accesskey="p" href="dependencies_and_portability/optional_reference_binding.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="acknowledgements.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
  309. </div>
  310. </body>
  311. </html>