iter_move (std::common_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)
|
||||
|
iter_move
(C++20)
|
||||
|
(C++20)
|
||||
| Helper classes | ||||
|
friend
constexpr
decltype
(
auto
)
iter_move
(
const
std::
common_iterator
&
i
)
noexcept
(
noexcept
(
ranges::
iter_move
(
std::
declval
<
const
I
&
>
(
)
)
)
|
(C++20부터) | |
기본 반복자를 역참조한 결과를 해당 rvalue 참조 타입으로 캐스팅합니다.
함수 본문은 다음과 동일합니다: return std :: ranges:: iter_move ( std :: get < I > ( i. var ) ) ; .
이 함수는 일반적인 unqualified 또는 qualified lookup 으로는 보이지 않으며, 인수가 std:: common_iterator < I, S > 의 연관 클래스일 때에만 argument-dependent lookup 에 의해 찾을 수 있습니다.
만약
i.
var
가
I
객체(즉, iterator)를 보유하고 있지 않다면, 동작은 정의되지 않습니다.
목차 |
매개변수
| i | - | 소스 반복자 어댑터 |
반환값
rvalue 참조 또는 prvalue 임시 객체.
복잡도
상수.
예제
#include <iomanip> #include <iostream> #include <iterator> #include <string> #include <vector> void print(auto const& rem, auto const& v) { std::cout << rem << '[' << size(v) << "] { "; for (int o{}; auto const& s : v) std::cout << (o++ ? ", " : "") << std::quoted(s); std::cout << " }\n"; } int main() { std::vector<std::string> p{"Andromeda", "Cassiopeia", "Phoenix"}, q; print("p", p); print("q", q); using CTI = std::counted_iterator<std::vector<std::string>::iterator>; using CI = std::common_iterator<CTI, std::default_sentinel_t>; CI last{std::default_sentinel}; for (CI first{{p.begin(), 2}}; first != last; ++first) q.emplace_back(/* ADL */ iter_move(first)); print("p", p); print("q", q); }
가능한 출력:
p[3] { "Andromeda", "Cassiopeia", "Phoenix" }
q[0] { }
p[3] { "", "", "Phoenix" }
q[2] { "Andromeda", "Cassiopeia" }
결함 보고서
다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.
| DR | 적용 대상 | 게시된 동작 | 올바른 동작 |
|---|---|---|---|
| LWG 3953 | C++20 | 반환 타입이 std:: iter_rvalue_reference_t < I > 였음 | 다음으로 변경됨 decltype ( auto ) |
참고 항목
|
(C++20)
|
객체를 역참조한 결과를 해당 rvalue 참조 타입으로 캐스팅합니다
(커스터마이제이션 포인트 객체) |
|
(C++20)
|
기본 반복자를 역참조한 결과를 해당 rvalue 참조 타입으로 캐스팅합니다
(함수) |
|
(C++11)
|
인수를 xvalue로 변환합니다
(함수 템플릿) |
|
(C++11)
|
이동 생성자가 예외를 던지지 않는 경우 인수를 xvalue로 변환합니다
(함수 템플릿) |
|
(C++11)
|
함수 인수를 전달하고 타입 템플릿 인수를 사용하여 값 카테고리를 보존합니다
(함수 템플릿) |
|
(C++20)
|
요소들의 범위를 새로운 위치로 이동합니다
(알고리즘 함수 객체) |
|
(C++20)
|
요소들의 범위를 새로운 위치로 역순으로 이동합니다
(알고리즘 함수 객체) |