Namespaces
Variants

iter_move (std::common_iterator)

From cppreference.net
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
friend constexpr decltype ( auto ) iter_move ( const std:: common_iterator & i )

noexcept ( noexcept ( ranges:: iter_move ( std:: declval < const I & > ( ) ) )

requires std:: input_iterator < 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로 변환합니다
(함수 템플릿)
이동 생성자가 예외를 던지지 않는 경우 인수를 xvalue로 변환합니다
(함수 템플릿)
(C++11)
함수 인수를 전달하고 타입 템플릿 인수를 사용하여 값 카테고리를 보존합니다
(함수 템플릿)
요소들의 범위를 새로운 위치로 이동합니다
(알고리즘 함수 객체)
요소들의 범위를 새로운 위치로 역순으로 이동합니다
(알고리즘 함수 객체)