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 이후) | |
기본 반복자를 역참조한 결과를 해당 rvalue 참조 타입으로 캐스팅합니다.
함수 본문은 다음과 동일합니다 return ranges:: iter_move ( i. base ( ) ) ; .
이 함수는 일반적인 unqualified lookup 또는 qualified lookup 으로는 보이지 않으며, 인수가 std:: counted_iterator < I > 의 연관 클래스일 때에만 argument-dependent lookup 에 의해 찾을 수 있습니다.
만약 i. count ( ) 가 0 과 같다면, 동작은 정의되지 않습니다.
목차 |
매개변수
| 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 (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)
|
객체를 역참조한 결과를 해당하는 rvalue 참조 타입으로 변환합니다
(커스터마이제이션 포인트 객체) |
|
(C++20)
|
두 기본 반복자가 가리키는 객체를 교환합니다
(함수 템플릿) |
|
(C++11)
|
인수를 xvalue로 변환합니다
(함수 템플릿) |
|
(C++11)
|
이동 생성자가 예외를 던지지 않는 경우 인수를 xvalue로 변환합니다
(함수 템플릿) |
|
(C++11)
|
함수 인수를 전달하고 타입 템플릿 인수를 사용하여 값 범주를 보존합니다
(함수 템플릿) |
|
(C++20)
|
요소들의 범위를 새로운 위치로 이동합니다
(알고리즘 함수 객체) |
|
(C++20)
|
요소들의 범위를 새로운 위치로 역순으로 이동합니다
(알고리즘 함수 객체) |