<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
- <title>Clang - C++14, C++11 and C++98 Status</title>
+ <title>Clang - C++1z, C++14, C++11 and C++98 Status</title>
<link type="text/css" rel="stylesheet" href="menu.css">
<link type="text/css" rel="stylesheet" href="content.css">
<style type="text/css">
<div id="content">
<!--*************************************************************************-->
-<h1>C++14, C++11 and C++98 Support in Clang</h1>
+<h1>C++ Support in Clang</h1>
<!--*************************************************************************-->
<p>Last updated: $Date$</p>
<p>Clang fully implements all published ISO C++ standards including <a
-href="#cxx11">C++11</a>, as well as the upcoming standard provisionally named <a
-href="#cxx14">C++14</a>, and is considered a production-quality C++ compiler.
+href="#cxx11">C++11</a>, as well as the upcoming <a
+href="#cxx14">C++14</a> standard, and some parts of the fledgling <a
+href="#cxx17">C++1z</a> standard,
+and is considered a production-quality C++ compiler.
<p>The Clang community is continually striving to improve C++ standards
compliance between releases by submitting and tracking <a
<p>Clang implements all of the ISO C++ 1998 standard
(including the defects addressed in the ISO C++ 2003 standard)
- except for <tt>export</tt> (which has been removed in C++11).
+ except for <tt>export</tt> (which was removed in C++11).
<h2 id="cxx11">C++11 implementation status</h2>
- <p>Clang
implements all of the <a
+ <p>Clang
3.3 and later implement all of the <a
href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=50372">ISO
C++ 2011 standard</a>. The following table describes the Clang version
in which each feature became available.</p>
work with Clang in C++11 mode. Patches are also needed to make
<a href="libstdc++4.6-clang11.patch">libstdc++-4.6</a>
and <a href="libstdc++4.7-clang11.patch">libstdc++-4.7</a> work with Clang
-releases prior to version 3.2 in C++11 mode. <tt>thread_local</tt> support
-currently requires the C++ runtime library from g++-4.8 or later.</p>
+releases prior to version 3.2 in C++11 mode.
<table width="689" border="1" cellspacing="0">
<tr>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2341.pdf">N2341</a></td>
<td class="full" align="center">Clang 3.3</td>
</tr>
- <!-- Skipped N1627: Conditionally-support behavior -->
- <!-- Skipped N1727: Changing Undefined Behavior into Diagnosable Errors -->
+ <tr>
+ <td>Conditionally-support behavior</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2004/n1627.pdf">N1627</a></td>
+ <td class="full" align="center">Clang 2.9</td>
+ </tr>
+ <tr>
+ <td>Changing undefined behavior into diagnosable errors</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2004/n1727.pdf">N1727</a></td>
+ <td class="full" align="center">Clang 2.9</td>
+ </tr>
<tr>
<td>Delegating constructors</td>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2006/n1986.pdf">N1986</a></td>
<tr>
<td>Minimal support for garbage collection and reachability-based leak detection</td>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2670.htm">N2670</a></td>
- <td class="na" align="center">N/A</td>
+ <td class="na" align="center">N/A <a href="#n2670">(2)</a></td>
</tr>
<tr>
<td>Allowing move constructors to throw [noexcept]</td>
<tr>
<td>Strong Compare and Exchange</td>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2748.html">N2748</a></td>
- <td class="full" align="center">Clang 3.1 <a href="#n2748">(2)</a></td>
+ <td class="full" align="center">Clang 3.1 <a href="#n2748">(3)</a></td>
</tr>
<tr>
<td>Bidirectional Fences</td>
<tr>
<td>Data-dependency ordering: atomics and memory model</td>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2664.htm">N2664</a></td>
- <td class="full" align="center">Clang 3.2 <a href="#n2664">(3)</a></td>
+ <td class="full" align="center">Clang 3.2 <a href="#n2664">(4)</a></td>
</tr>
<tr>
<td>Propagating exceptions</td>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2179.html">N2179</a></td>
<td class="full" align="center">Clang 2.9</td>
</tr>
- <tr>
- <td>Abandoning a process and at_quick_exit</td>
- <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2440.htm">N2440</a></td>
- <td class="na" align="center">N/A</td>
- </tr>
<tr>
<td>Allow atomics use in signal handlers</td>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2547.htm">N2547</a></td>
<tr>
<td>Thread-local storage</td>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2659.htm">N2659</a></td>
- <td class="full" align="center">Clang 3.3</td>
+ <td class="full" align="center">Clang 3.3 <a href="#n2659">(5)</a></td>
</tr>
<tr>
<td>Dynamic initialization and destruction with concurrency</td>
<tr>
<td>Extended integral types</td>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2006/n1988.pdf">N1988</a></td>
- <td class="na" align="center">N/A <a href="#n1988">(4)</a></td>
+ <td class="na" align="center">N/A <a href="#n1988">(6)</a></td>
</tr>
</table>
<p>
<span id="n2761">(1): The <code>[[carries_dependency]]</code> attribute
has no effect.</span><br>
-<span id="n2748">(2): All compare-exchange operations are emitted as
+<span id="n2670">(2): No compiler changes are required for an implementation
+such as Clang that does not provide garbage collection.</span><br>
+<span id="n2748">(3): All compare-exchange operations are emitted as
strong compare-exchanges.</span><br>
-<span id="n2664">(3): <code>memory_order_consume</code> is lowered to
+<span id="n2664">(4): <code>memory_order_consume</code> is lowered to
<code>memory_order_acquire</code>.</span><br>
-<span id="n1988">(4): <code>__int128</code> is not treated as an extended
-integer type, because changing <code>intmax_t</code> would be an
-ABI-incompatible change.</span>
+<span id="n2659">(5): <code>thread_local</code> support
+requires a C++ runtime library providing <code>__cxa_thread_atexit</code>, such
+as <a href="http://libcxxabi.llvm.org">libc++abi</a> 3.6 or later,
+or libsupc++ 4.8 or later.</span><br>
+<span id="n1988">(6): No compiler changes are required for an implementation
+such as Clang that does not provide any extended integer types.
+<code>__int128</code> is not treated as an extended integer type,
+because changing <code>intmax_t</code> would be an ABI-incompatible
+change.</span>
</p>
-<h2 id="cxx14">C++1y implementation status</h2>
+<h2 id="cxx14">C++14 implementation status</h2>
-<p>Clang implements all of the
-<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2013/n3797.pdf">current draft</a>
-of the upcoming C++ language standard, provisionally named C++1y. The following
-table describes the Clang version in which each feature became available.</p>
+<p>Clang 3.4 and later implement all of the Draft International Standard (see <a
+href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2013/n3797.pdf">most
+recent publicly available draft</a>)
+of the upcoming C++14 language standard. The following table describes the
+Clang version in which each feature became available.</p>
-<p>You can use Clang in C++1y mode with the <code>-std=c++1y</code> option.</p>
+<p>You can use Clang in C++14 mode with the <code>-std=c++14</code> option
+(use <code>-std=c++1y</code> in Clang 3.4 and earlier).</p>
<table width="689" border="1" cellspacing="0">
<tr>
<th>Language Feature</th>
- <th>C++1y Proposal</th>
+ <th>C++14 Proposal</th>
<th>Available in Clang?</th>
</tr>
<tr>
<tr>
<td>Binary literals</td>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2012/n3472.pdf">N3472</a></td>
- <td class="full" align="center">Yes</td>
+ <td class="full" align="center">Clang 2.9</td>
</tr>
<tr>
<td>decltype(auto)</td>
<tr>
<td>C++ Sized Deallocation</td>
<td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2013/n3778.html">N3778</a></td>
- <td class="full" align="center">Clang 3.4</td>
+ <td class="full" align="center">Clang 3.4 <a href="#n3778">(7)</a></td>
</tr>
</table>
-<!--
+<p>
+<span id="n3778">(7): In Clang 3.7 and later, sized deallocation is only enabled
+if the user passes the <code>-fsized-deallocation</code> flag. The user must
+supply definitions of the sized deallocation functions, either by providing them
+explicitly or by using a C++ standard library that does. <code>libstdc++</code>
+added these functions in version 5.0, and <code>libc++</code> added them in
+version 3.7.
+</span>
+</p>
+
<h2 id="cxx17">C++1z implementation status</h2>
-<p>Clang implements none of the upcoming C++ language standard,
-provisionally named C++1z. The following table describes which C++1z features
+<p>Clang has <b>experimental</b> support for some proposed features of
+the C++ standard following C++14, provisionally named C++1z.
+The following table describes which C++1z features
have been implemented in Clang and in which Clang version they became
available.</p>
+<p>Note that support for these features may change or be removed without notice,
+as the draft C++1z standard evolves.</p>
+
<p>You can use Clang in C++1z mode with the <code>-std=c++1z</code> option.</p>
--->
+
+<table width="689" border="1" cellspacing="0">
+ <tr>
+ <th>Language Feature</th>
+ <th>C++1z Proposal</th>
+ <th>Available in Clang?</th>
+ </tr>
+ <!-- Issaquah papers -->
+ <tr>
+ <td><tt>static_assert</tt> with no message</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n3928.pdf">N3928</a></td>
+ <td class="full" align="center">Clang 3.5</td>
+ </tr>
+ <!-- Rapperswil papers -->
+ <tr>
+ <td>Disabling trigraph expansion by default</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n4086.html">N4086</a></td>
+ <td class="full" align="center">Clang 3.5</td>
+ </tr>
+ <!--
+ <tr>
+ <td rowspan="2">Terse range-based for loops (removed from C++1z)</td>
+ <td rowspan="2"><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n3994.htm">N3994</a></td>
+ <td class="none" align="center">Clang 3.5: Yes</td>
+ </tr>
+ <tr>
+ <td class="svn" align="center">SVN: No</td>
+ </tr>
+ -->
+ <tr>
+ <td><tt>typename</tt> in a template template parameter</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n4051.html">N4051</a></td>
+ <td class="full" align="center">Clang 3.5</td>
+ </tr>
+ <tr>
+ <td>New <tt>auto</tt> rules for direct-list-initialization
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n3922.html">N3922</a></td>
+ <td class="full" align="center">Clang 3.8 <a href="#n3922">(8)</a></td>
+ </tr>
+ <!-- Urbana papers -->
+ <tr>
+ <td rowspan="2">Fold expressions</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n4295.html">N4295</a></td>
+ <td class="full" align="center">Clang 3.6</td>
+ </tr>
+ <tr> <!-- from Jacksonville -->
+ <td><a href="http://wg21.link/p0036r0">P0036R0</a></td>
+ <td class="svn" align="center">SVN</td>
+ </tr>
+ <tr>
+ <td><tt>u8</tt> character literals</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n4267.html">N4267</a></td>
+ <td class="full" align="center">Clang 3.6</td>
+ </tr>
+ <tr>
+ <td>Nested namespace definition</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n4230.html">N4230</a></td>
+ <td class="full" align="center">Clang 3.6</td>
+ </tr>
+ <tr>
+ <td>Attributes for namespaces and enumerators</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n4266.html">N4266</a></td>
+ <td class="full" align="center">Clang 3.6</td>
+ </tr>
+ <tr>
+ <td>Allow constant evaluation for all non-type template arguments</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n4268.html">N4268</a></td>
+ <td class="full" align="center">Clang 3.6</td>
+ </tr>
+ <!-- Kona papers -->
+ <tr>
+ <td>Remove deprecated <tt>register</tt> storage class</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/p0001r1.html">P0001R1</a></td>
+ <td class="full" align="center">Clang 3.8</td>
+ </tr>
+ <tr>
+ <td>Remove deprecated <tt>bool</tt> increment</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/p0002r1.html">P0002R1</a></td>
+ <td class="full" align="center">Clang 3.8</td>
+ </tr>
+ <tr>
+ <td>Make exception specifications part of the type system</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/p0012r1.html">P0012R1</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+ <tr>
+ <td><tt>__has_include</tt> in preprocessor conditionals</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/p0061.html">P0061R1</a></td>
+ <td class="full" align="center">Yes</td>
+ </tr>
+ <tr>
+ <td>New specification for inheriting constructors (<a href="cxx_dr_status.html#1941">DR1941</a> et al)</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/p0136r1.html">P0136R1</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+ <!-- Jacksonville papers -->
+ <tr>
+ <td><tt>[[fallthrough]]</tt> attribute</td>
+ <td><a href="http://wg21.link/p0188r1">P0188R1</a></td>
+ <td class="svn" align="center">SVN</td>
+ </tr>
+ <tr>
+ <td><tt>[[nodiscard]]</tt> attribute</td>
+ <td><a href="http://wg21.link/p0189r1">P0189R1</a></td>
+ <td class="svn" align="center">SVN</td>
+ </tr>
+ <tr>
+ <td><tt>[[maybe_unused]]</tt> attribute</td>
+ <td><a href="http://wg21.link/p0212r1">P0212R1</a></td>
+ <td class="svn" align="center">SVN</td>
+ </tr>
+ <tr>
+ <td>Aggregate initialization of classes with base classes</td>
+ <td><a href="http://wg21.link/p0017r1">P0017R1</a></td>
+ <td class="svn" align="center">SVN</td>
+ </tr>
+ <tr>
+ <td><tt>constexpr</tt> lambda expressions</td>
+ <td><a href="http://wg21.link/p0170r1">P0170R1</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+ <tr>
+ <td>Differing <tt>begin</tt> and <tt>end</tt> types in range-based <tt>for</tt></td>
+ <td><a href="http://wg21.link/p0184r0">P0184R0</a></td>
+ <td class="svn" align="center">SVN</td>
+ </tr>
+ <tr>
+ <td>Lambda capture of <tt>*this</tt></td>
+ <td><a href="http://wg21.link/p0018r3">P0018R3</a></td>
+ <td class="svn" align="center">SVN</td>
+ </tr>
+ <tr>
+ <td>Direct-list-initialization of <tt>enum</tt>s</td>
+ <td><a href="http://wg21.link/p0138r2">P0138R2</a></td>
+ <td class="svn" align="center">SVN</td>
+ </tr>
+ <tr>
+ <td>Hexadecimal floating-point literals</td>
+ <td><a href="http://wg21.link/p0245r1">P0245R1</a></td>
+ <td class="full" align="center">Yes</td>
+ </tr>
+ <!-- Oulu papers -->
+ <tr>
+ <td>Using attribute namespaces without repetition</td>
+ <td><a href="http://wg21.link/p0028r4">P0028R4</a></td>
+ <td class="svn" align="center">SVN</td>
+ </tr>
+ <tr>
+ <td>Dynamic memory allocation for over-aligned data</td>
+ <td><a href="http://wg21.link/p0035r4">P0035R4</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+ <tr>
+ <td>Template argument deduction for class templates</td>
+ <td><a href="http://wg21.link/p0091r3">P0091R3</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+ <tr>
+ <td>Non-type template parameters with <tt>auto</tt> type</td>
+ <td><a href="http://wg21.link/p0127r2">P0127R2</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+ <tr>
+ <td>Guaranteed copy elision</td>
+ <td><a href="http://wg21.link/p0135r1">P0135R1</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+ <tr>
+ <td>Stricter expression evaluation order (chapter 8 alternative)</td>
+ <td><a href="http://wg21.link/p0145r3">P0145R3</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+ <tr>
+ <td>Requirement to ignore unknown attributes</td>
+ <td><a href="http://wg21.link/p0283r2">P0283R2</a></td>
+ <td class="full" align="center">Yes</td>
+ </tr>
+ <tr>
+ <td><tt>constexpr</tt> <em>if-statement</em>s</td>
+ <td><a href="http://wg21.link/p0292r2">P0292R2</a></td>
+ <td class="svn" align="center">SVN</td>
+ </tr>
+ <tr>
+ <td>Inline variables</td>
+ <td><a href="http://wg21.link/p0386r2">P0386R2</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+ <tr>
+ <td>Structured bindings</td>
+ <td><a href="http://wg21.link/p0217r3">P0217R3</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+ <tr>
+ <td>Separate variable and condition for <tt>if</tt>, <tt>while</tt>, and <tt>switch</tt></td>
+ <td><a href="http://wg21.link/p0305r1">P0305R1</a></td>
+ <td class="none" align="center">No</td>
+ </tr>
+</table>
+
+<p>
+<span id="n3922">(8): This is a backwards-incompatible change that is applied to
+all language versions that allow type deduction from <tt>auto</tt>
+(per the request of the C++ committee).
+In Clang 3.7, a warning is emitted for all cases that would change meaning.
+</span>
+</p>
<h2 id="ts">Technical specifications and standing documents</h2>
<th>Available in Clang?</th>
</tr>
<tr>
- <td>SD-6: SG10 feature test recommendations</td>
- <td><a href="http://isocpp.org/std/standing-documents/sd-6-sg10-feature-test-recommendations">SD-6</a></td>
- <td class="full" align="center">Clang 3.4 (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2013/n3745">N3745</a>)</td>
+ <td rowspan="2">SD-6: SG10 feature test recommendations</td>
+ <td rowspan="2"><a href="http://isocpp.org/std/standing-documents/sd-6-sg10-feature-test-recommendations">SD-6</a></td>
+ <td class="full" align="center">
+ Clang 3.4 (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2013/n3745">N3745</a>)</br>
+ </td>
+ </tr>
+ <tr>
+ <td class="full" align="center">
+ Clang 3.6 (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n4200">N4200</a>)</a>
+ </td>
+ </tr>
+ <!-- FIXME: Implement latest recommendations.
+ <tr>
+ <td class="svn" align="center">
+ SVN (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/p0096r0">P0096R0</a>)</a>
+ </td>
+ </tr>
+ -->
+ <!-- No compiler support is known to be needed for:
+ * Concurrency TS
+ * Parallelism TS
+ * Ranges TS
+ * Networking TS
+ * File System TS
+ -->
+ <tr>
+ <td>[TS] Concepts</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/p0121r0.pdf">P0121R0</a></td>
+ <td class="none" align="center">No</td>
</tr>
<tr>
- <td>[DRAFT TS] Array extensions (arrays of runtime bound)</td>
- <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2013/n3820.html">N3820</a></td>
+ <td>[TS] Library Fundamentals, Version 1 (invocation type traits)</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/n4480.html">N4480</a></td>
<td class="none" align="center">No</td>
</tr>
<tr>
- <td>[DRAFT TS] Library fundamentals (invocation type traits)</td>
- <td><!--a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n3866"-->N3866</a></td>
+ <td>[DRAFT TS] Library Fundamentals, Version 2 (<tt>source_location</tt>)</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/n4529.html">N4529</a></td>
<td class="none" align="center">No</td>
</tr>
<tr>
- <td>[DRAFT TS] Transactional memory</td>
- <td><!--a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/N3919.pdf"-->N3919</a></td>
+ <td>[TS] Modules</td>
+ <td><a href="http://wg21.link/p0143r2">P0143R2</a></td>
<td class="none" align="center">No</td>
</tr>
<tr>
- <td>[DRAFT TS] Concepts</td>
- <td><!--a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n3929.pdf"-->N3929</a></td>
+ <td>[TS] Transactional Memory</td>
+ <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/n4514.pdf">N4514</a></td>
<td class="none" align="center">No</td>
</tr>
</table>
projects / clang / blobdiff