| Index: styleguide/c++/c++11.html
|
| diff --git a/styleguide/c++/c++11.html b/styleguide/c++/c++11.html
|
| index 8c3cbc0426634f5be32e0a81cdbeeddda577b3ba..2776be9feedafe784cac2e3b82c9dd65729047a8 100644
|
| --- a/styleguide/c++/c++11.html
|
| +++ b/styleguide/c++/c++11.html
|
| @@ -363,6 +363,38 @@
|
| </tr>
|
|
|
| <tr>
|
| +<td>Lexicographical struct comparison</td>
|
| +<td><code>tie(a, b, c) <<br> tie(rhs.a, rhs.b, rhs.c)</code></td>
|
| +<td>Idiom for <code>operator<</code> implementation</td>
|
| +<td><a href="http://en.cppreference.com/w/cpp/utility/tuple/tie">std::tie</a></td>
|
| +<td>General use of <code>std::tuple</code>, and <code>std::tie</code> for unpacking or multiple assignments is still not allowed. <a href="https://groups.google.com/a/chromium.org/d/topic/cxx/3DZ64dIMRTY/discussion">Discussion thread</a></td>
|
| +</tr>
|
| +
|
| +<tr>
|
| +<td>Move Iterator Adaptor</td>
|
| +<td><code>std::make_move_iterator()</code></td>
|
| +<td>Wraps an iterator so that it moves objects instead of copying them.</td>
|
| +<td><a href="http://en.cppreference.com/w/cpp/iterator/make_move_iterator">std::make_move_iterator</a></td>
|
| +<td>Useful to move objects between containers that contain move-only types like <code>scoped_ptr</code>. <a href="https://groups.google.com/a/chromium.org/forum/#!topic/cxx/lccnUljOHQU">Discussion thread</a></td>
|
| +</tr>
|
| +
|
| +<tr>
|
| +<td>Move Semantics</td>
|
| +<td><code>std::move()</code></td>
|
| +<td>Facilitates efficient move operations</td>
|
| +<td><a href="http://en.cppreference.com/w/cpp/utility/move"><code>std::move</code> reference</a></td>
|
| +<td><a href='https://groups.google.com/a/chromium.org/forum/#!topic/cxx/x_dWFxJFdbM'>Discussion thread</a></td>
|
| +</tr>
|
| +
|
| +<tr>
|
| +<td>Range Move</td>
|
| +<td><code>std::move()</code></td>
|
| +<td>Moves contents of an iterator range to a different iterator. This is a counterpart of std::copy that applies std::move() to each element.</td>
|
| +<td><a href="http://en.cppreference.com/w/cpp/algorithm/move"><code>std::move</code> reference</a></td>
|
| +<td>This is allowed, but there is almost always a way to write code without using this version of std::move. Not using it usually results in cleaner, easier to read, and less confusing code. <a href='https://groups.google.com/a/chromium.org/forum/#!topic/cxx/8WzmtYrZvQ8'>Discussion thread</a></td>
|
| +</tr>
|
| +
|
| +<tr>
|
| <td>Forwarding references</td>
|
| <td><code>std::forward()</code></td>
|
| <td>Perfectly forwards arguments (including rvalues)</td>
|
| @@ -374,38 +406,6 @@
|
| </tr>
|
|
|
| <tr>
|
| -<td>Lexicographical struct comparison</td>
|
| -<td><code>tie(a, b, c) <<br> tie(rhs.a, rhs.b, rhs.c)</code></td>
|
| -<td>Idiom for <code>operator<</code> implementation</td>
|
| -<td><a href="http://en.cppreference.com/w/cpp/utility/tuple/tie">std::tie</a></td>
|
| -<td>General use of <code>std::tuple</code>, and <code>std::tie</code> for unpacking or multiple assignments is still not allowed. <a href="https://groups.google.com/a/chromium.org/d/topic/cxx/3DZ64dIMRTY/discussion">Discussion thread</a></td>
|
| -</tr>
|
| -
|
| -<tr>
|
| -<td>Move Iterator Adaptor</td>
|
| -<td><code>std::make_move_iterator()</code></td>
|
| -<td>Wraps an iterator so that it moves objects instead of copying them.</td>
|
| -<td><a href="http://en.cppreference.com/w/cpp/iterator/make_move_iterator">std::make_move_iterator</a></td>
|
| -<td>Useful to move objects between containers that contain move-only types like <code>scoped_ptr</code>. <a href="https://groups.google.com/a/chromium.org/forum/#!topic/cxx/lccnUljOHQU">Discussion thread</a></td>
|
| -</tr>
|
| -
|
| -<tr>
|
| -<td>Move Semantics</td>
|
| -<td><code>std::move()</code></td>
|
| -<td>Facilitates efficient move operations</td>
|
| -<td><a href="http://en.cppreference.com/w/cpp/utility/move"><code>std::move</code> reference</a></td>
|
| -<td><a href='https://groups.google.com/a/chromium.org/forum/#!topic/cxx/x_dWFxJFdbM'>Discussion thread</a></td>
|
| -</tr>
|
| -
|
| -<tr>
|
| -<td>Range Move</td>
|
| -<td><code>std::move()</code></td>
|
| -<td>Moves contents of an iterator range to a different iterator. This is a counterpart of std::copy that applies std::move() to each element.</td>
|
| -<td><a href="http://en.cppreference.com/w/cpp/algorithm/move"><code>std::move</code> reference</a></td>
|
| -<td>This is allowed, but there is almost always a way to write code without using this version of std::move. Not using it usually results in cleaner, easier to read, and less confusing code. <a href='https://groups.google.com/a/chromium.org/forum/#!topic/cxx/8WzmtYrZvQ8'>Discussion thread</a></td>
|
| -</tr>
|
| -
|
| -<tr>
|
| <td>Type Traits</td>
|
| <td>Class templates within <code><type_traits></code></td>
|
| <td>Allows compile-time inspection of the properties of types</td>
|
| @@ -420,17 +420,6 @@
|
| <td>Useful for math-related code</td>
|
| <td><a href="http://en.cppreference.com/w/cpp/header/cmath"><code><cmath></code></a></td>
|
| <td>Anything in <code><cmath></code> is allowed. <a href="https://groups.google.com/a/chromium.org/forum/#!topic/cxx/P-1bFBXMeUk">Discussion thread</a></td>
|
| -</tr>
|
| -
|
| -<tr>
|
| -<td>Unordered Associative Containers</td>
|
| -<td><code>std::unordered_set</code>, <code>std::unordered_map</code>,
|
| -<code>std::unordered_multiset</code>, and <code>std::unordered_multimap</code></td>
|
| -<td>Allows efficient containers of key/value pairs</td>
|
| -<td><a href="http://en.cppreference.com/w/cpp/container/unordered_map">std::unordered_map</a>
|
| -and <a href="http://en.cppreference.com/w/cpp/container/unordered_set">std::unordered_set</a>
|
| -</td>
|
| -<td>Per the <a href="https://google.github.io/styleguide/cppguide.html#std_hash">Google style guide</a>, specify custom hashers instead of specializing <code>std::hash</code> for custom types. <a href="https://groups.google.com/a/chromium.org/forum/#!topic/cxx/nCdjQqnouO4">Discussion thread</a>.</td>
|
| </tr>
|
|
|
| </tbody>
|
| @@ -1066,6 +1055,17 @@
|
| <td>TODO: documentation link</td>
|
| <td><a href="https://google.github.io/styleguide/cppguide.html#Ownership_and_Smart_Pointers">
|
| Ownership and Smart Pointers</a></td>
|
| +</tr>
|
| +
|
| +<tr>
|
| +<td>Unordered Associative Containers</td>
|
| +<td><code>std::unordered_set</code>, <code>std::unordered_map</code>,
|
| +<code>std::unordered_multiset</code>, and <code>std::unordered_multimap</code></td>
|
| +<td>Allows efficient containers of key/value pairs</td>
|
| +<td><a href="http://en.cppreference.com/w/cpp/container/unordered_map">std::unordered_map</a>
|
| +and <a href="http://en.cppreference.com/w/cpp/container/unordered_set">std::unordered_set</a>
|
| +</td>
|
| +<td></td>
|
| </tr>
|
|
|
| <tr>
|
|
|