iter_move (std::counted_iterator)
| Iterator concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator primitives | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Algorithm concepts and utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Indirect callable concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Common algorithm requirements | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator adaptors | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||
| Non-member functions | ||||
|
(C++20)
(C++20)
|
||||
|
(C++20)
|
||||
|
(C++20)
|
||||
|
(C++20)
|
||||
|
(C++20)
|
||||
|
iter_move
(C++20)
|
||||
|
(C++20)
|
||||
| Helper classes | ||||
|
friend
constexpr
decltype
(
auto
)
iter_move
(
const
std::
counted_iterator
&
i
)
noexcept
(
noexcept
(
ranges::
iter_move
(
i.
base
(
)
)
)
)
|
(C++20以降) | |
基盤となるイテレータのデリファレンス結果を、関連する右辺値参照型にキャストします。
この関数の本体は以下と等価です: return ranges:: iter_move ( i. base ( ) ) ; 。
この関数は通常の unqualified lookup または qualified lookup では可視化されず、 argument-dependent lookup によってのみ発見可能であり、その際 std:: counted_iterator < I > が引数の関連クラスである場合に限ります。
i. count ( ) が 0 に等しい場合、動作は未定義です。
目次 |
パラメータ
| i | - | ソースイテレータアダプタ |
戻り値
右辺値参照または純粋右辺値一時オブジェクト。
計算量
定数。
例
#include <iomanip> #include <iostream> #include <iterator> #include <string> #include <vector> void print(auto const& rem, auto const& v) { std::cout << rem << '[' << size(v) << "] {"; for (char comma[]{0, ' ', 0}; auto const& s : v) std::cout << comma << std::quoted(s), *comma = ','; std::cout << "}\n"; } int main() { std::vector<std::string> p{"Alpha", "Bravo", "Charlie"}, q; print("p", p); print("q", q); using RI = std::counted_iterator<std::vector<std::string>::iterator>; for (RI iter{p.begin(), 2}; iter != std::default_sentinel; ++iter) q.emplace_back(/* ADL */ iter_move(iter)); print("p", p); print("q", q); }
出力例:
p[3] {"Alpha", "Bravo", "Charlie"}
q[0] {}
p[3] {"", "", "Charlie"}
q[2] {"Alpha", "Bravo"}
不具合報告
以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。
| DR | 適用対象 | 公開時の動作 | 正しい動作 |
|---|---|---|---|
| LWG 3953 | C++20 | 戻り値の型は std:: iter_rvalue_reference_t < I > であった | decltype ( auto ) に変更 |
関連項目
|
(C++20)
|
オブジェクトをデリファレンスした結果を、関連付けられた右辺値参照型にキャストする
(カスタマイゼーションポイントオブジェクト) |
|
(C++20)
|
2つの基盤となるイテレータが指すオブジェクトを交換する
(関数テンプレート) |
|
(C++11)
|
引数をxvalueに変換する
(関数テンプレート) |
|
(C++11)
|
ムーブコンストラクタが例外を投げない場合、引数をxvalueに変換する
(関数テンプレート) |
|
(C++11)
|
関数引数を転送し、型テンプレート引数を使用してその値カテゴリを保持する
(関数テンプレート) |
|
(C++20)
|
要素の範囲を新しい位置にムーブする
(アルゴリズム関数オブジェクト) |
|
(C++20)
|
要素の範囲を新しい位置に逆順でムーブする
(アルゴリズム関数オブジェクト) |