8252588: HotSpot Style Guide should permit uniform initialization
Reviewed-by: jrose, dholmes, dcubed, tschatzl, kvn
This commit is contained in:
parent
c35e1a284b
commit
537b40e013
@ -49,6 +49,7 @@
|
|||||||
<li><a href="#thread_local">thread_local</a></li>
|
<li><a href="#thread_local">thread_local</a></li>
|
||||||
<li><a href="#nullptr">nullptr</a></li>
|
<li><a href="#nullptr">nullptr</a></li>
|
||||||
<li><a href="#atomic"><atomic></a></li>
|
<li><a href="#atomic"><atomic></a></li>
|
||||||
|
<li><a href="#uniform-initialization">Uniform Initialization</a></li>
|
||||||
<li><a href="#additional-permitted-features">Additional Permitted Features</a></li>
|
<li><a href="#additional-permitted-features">Additional Permitted Features</a></li>
|
||||||
<li><a href="#excluded-features">Excluded Features</a></li>
|
<li><a href="#excluded-features">Excluded Features</a></li>
|
||||||
<li><a href="#undecided-features">Undecided Features</a></li>
|
<li><a href="#undecided-features">Undecided Features</a></li>
|
||||||
@ -275,6 +276,17 @@ while ( test_foo(args...) ) { // No, excess spaces around control</code></pre></
|
|||||||
<p>Do not use facilities provided by the <code><atomic></code> header (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2427.html">n2427</a>), (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2752.htm">n2752</a>); instead, use the HotSpot <code>Atomic</code> class and related facilities.</p>
|
<p>Do not use facilities provided by the <code><atomic></code> header (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2427.html">n2427</a>), (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2752.htm">n2752</a>); instead, use the HotSpot <code>Atomic</code> class and related facilities.</p>
|
||||||
<p>Atomic operations in HotSpot code must have semantics which are consistent with those provided by the JDK's compilers for Java. There are platform-specific implementation choices that a C++ compiler might make or change that are outside the scope of the C++ Standard, and might differ from what the Java compilers implement.</p>
|
<p>Atomic operations in HotSpot code must have semantics which are consistent with those provided by the JDK's compilers for Java. There are platform-specific implementation choices that a C++ compiler might make or change that are outside the scope of the C++ Standard, and might differ from what the Java compilers implement.</p>
|
||||||
<p>In addition, HotSpot <code>Atomic</code> has a concept of "conservative" memory ordering, which may differ from (may be stronger than) sequentially consistent. There are algorithms in HotSpot that are believed to rely on that ordering.</p>
|
<p>In addition, HotSpot <code>Atomic</code> has a concept of "conservative" memory ordering, which may differ from (may be stronger than) sequentially consistent. There are algorithms in HotSpot that are believed to rely on that ordering.</p>
|
||||||
|
<h3 id="uniform-initialization">Uniform Initialization</h3>
|
||||||
|
<p>The use of <em>uniform initialization</em> (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2672.htm">n2672</a>), also known as <em>brace initialization</em>, is permitted.</p>
|
||||||
|
<p>Some relevant sections from cppreference.com:</p>
|
||||||
|
<ul>
|
||||||
|
<li><a href="https://en.cppreference.com/w/cpp/language/initialization">initialization</a></li>
|
||||||
|
<li><a href="https://en.cppreference.com/w/cpp/language/value_initialization">value initialization</a></li>
|
||||||
|
<li><a href="https://en.cppreference.com/w/cpp/language/direct_initialization">direct initialization</a></li>
|
||||||
|
<li><a href="https://en.cppreference.com/w/cpp/language/list_initialization">list initialization</a></li>
|
||||||
|
<li><a href="https://en.cppreference.com/w/cpp/language/aggregate_initialization">aggregate initialization</a></li>
|
||||||
|
</ul>
|
||||||
|
<p>Although related, the use of <code>std::initializer_list</code> remains forbidden, as part of the avoidance of the C++ Standard Library in HotSpot code.</p>
|
||||||
<h3 id="additional-permitted-features">Additional Permitted Features</h3>
|
<h3 id="additional-permitted-features">Additional Permitted Features</h3>
|
||||||
<ul>
|
<ul>
|
||||||
<li><p><code>constexpr</code> (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2235.pdf">n2235</a>) (<a href="https://isocpp.org/files/papers/N3652.html">n3652</a>)</p></li>
|
<li><p><code>constexpr</code> (<a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2235.pdf">n2235</a>) (<a href="https://isocpp.org/files/papers/N3652.html">n3652</a>)</p></li>
|
||||||
|
@ -681,6 +681,23 @@ ordering, which may differ from (may be stronger than) sequentially
|
|||||||
consistent. There are algorithms in HotSpot that are believed to rely
|
consistent. There are algorithms in HotSpot that are believed to rely
|
||||||
on that ordering.
|
on that ordering.
|
||||||
|
|
||||||
|
### Uniform Initialization
|
||||||
|
|
||||||
|
The use of _uniform initialization_
|
||||||
|
([n2672](http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2672.htm)),
|
||||||
|
also known as _brace initialization_, is permitted.
|
||||||
|
|
||||||
|
Some relevant sections from cppreference.com:
|
||||||
|
|
||||||
|
* [initialization](https://en.cppreference.com/w/cpp/language/initialization)
|
||||||
|
* [value initialization](https://en.cppreference.com/w/cpp/language/value_initialization)
|
||||||
|
* [direct initialization](https://en.cppreference.com/w/cpp/language/direct_initialization)
|
||||||
|
* [list initialization](https://en.cppreference.com/w/cpp/language/list_initialization)
|
||||||
|
* [aggregate initialization](https://en.cppreference.com/w/cpp/language/aggregate_initialization)
|
||||||
|
|
||||||
|
Although related, the use of `std::initializer_list` remains forbidden, as
|
||||||
|
part of the avoidance of the C++ Standard Library in HotSpot code.
|
||||||
|
|
||||||
### Additional Permitted Features
|
### Additional Permitted Features
|
||||||
|
|
||||||
* `constexpr`
|
* `constexpr`
|
||||||
|
Loading…
Reference in New Issue
Block a user