std::swap_ranges

From Cppreference

Exchanges elements between range [first1, last1) and another range starting at first2.

[edit] Parameters

[edit] Return value

iterator to the element past the last element exchanged in the range beginning with first2.

[edit] Equivalent function

template<class ForwardIterator1, class ForwardIterator2>
ForwardIterator1 swap_ranges(ForwardIterator1 first1, 
                             ForwardIterator1 last1, 
                             ForwardIterator2 first2)
{
    while (first1 != last1) {
        std::iter_swap(first1++, first2++);
    }
    return first2;
}

[edit] Example

[edit] Complexity

linear in the distance between first and last

[edit] See also