std::make_move_iterator - cppreference.com (original) (raw)

| | | | | ---------------------------------------------------------------------------------------------------------- | | ------------------------------------- | | template< class Iter > std::move_iterator<Iter> make_move_iterator( Iter i ); | | (since C++11) (constexpr since C++17) |

make_move_iterator is a convenience function template that constructs a std::move_iterator for the given iterator i with the type deduced from the type of the argument.

[edit] Parameters

i - input iterator to be converted to move iterator

[edit] Return value

std::move_iterator<Iter>(std::move(i))

[edit] Example

#include #include #include #include #include #include   auto print = [](const auto rem, const auto& seq) { for (std::cout << rem; const auto& str : seq) std::cout << std::quoted(str) << ' '; std::cout << '\n'; };   int main() { std::list<std::string> s{"one", "two", "three"};   std::vector<std::string> v1(s.begin(), s.end()); // copy   std::vector<std::string> v2(std::make_move_iterator(s.begin()), std::make_move_iterator(s.end())); // move   print("v1 now holds: ", v1); print("v2 now holds: ", v2); print("original list now holds: ", s); }

Possible output:

v1 now holds: "one" "two" "three" v2 now holds: "one" "two" "three" original list now holds: "" "" ""

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR Applied to Behavior as published Correct behavior
LWG 2061 C++11 make_move_iterator did not convert array arguments to pointers made to convert

[edit] See also

| | iterator adaptor which dereferences to an rvalue (class template) [edit] | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | converts the argument to an xvalue (function template) [edit] |