Namespaces
Variants

std::ranges:: swap_ranges, std::ranges:: swap_ranges_result

From cppreference.net
Algorithm library
Constrained algorithms and algorithms on ranges (C++20)
Constrained algorithms, e.g. ranges::copy , ranges::sort , ...
Execution policies (C++17)
Non-modifying sequence operations
Batch operations
(C++17)
Search operations
Modifying sequence operations
Copy operations
(C++11)
(C++11)
Swap operations
Transformation operations
Generation operations
Removing operations
Order-changing operations
(until C++17) (C++11)
(C++20) (C++20)
Sampling operations
(C++17)

Sorting and related operations
Partitioning operations
Sorting operations
Binary search operations
(on partitioned ranges)
Set operations (on sorted ranges)
Merge operations (on sorted ranges)
Heap operations
Minimum/maximum operations
Lexicographical comparison operations
Permutation operations
C library
Numeric operations
Operations on uninitialized memory
Constrained algorithms
All names in this menu belong to namespace std::ranges
Non-modifying sequence operations
Modifying sequence operations
Partitioning operations
Sorting operations
Binary search operations (on sorted ranges)
Set operations (on sorted ranges)
Heap operations
Minimum/maximum operations
Permutation operations
Fold operations
Operations on uninitialized storage
Return types
Definido en el encabezado <algorithm>
Firma de llamada
template < std:: input_iterator I1, std:: sentinel_for < I1 > S1,

std:: input_iterator I2, std:: sentinel_for < I2 > S2 >
requires std:: indirectly_swappable < I1, I2 >
constexpr swap_ranges_result < I1, I2 >

swap_ranges ( I1 first1, S1 last1, I2 first2, S2 last2 ) ;
(1) (desde C++20)
template < ranges:: input_range R1, ranges:: input_range R2 >

requires std:: indirectly_swappable < ranges:: iterator_t < R1 > , ranges:: iterator_t < R2 >>
constexpr swap_ranges_result < ranges:: borrowed_iterator_t < R1 > ,
ranges:: borrowed_iterator_t < R2 >>

swap_ranges ( R1 && r1, R2 && r2 ) ;
(2) (desde C++20)
Tipos auxiliares
template < class I1, class I2 >
using swap_ranges_result = ranges:: in_in_result < I1, I2 > ;
(3) (desde C++20)
1) Intercambia elementos entre el primer rango [ first1 , first1 + M ) y el segundo rango [ first2 , first2 + M ) mediante ranges:: iter_swap ( first1 + i, first2 + i ) , donde M = ranges:: min ( ranges:: distance ( first1, last1 ) , ranges:: distance ( first2, last2 ) ) .
Los rangos [ first1 , last1 ) y [ first2 , last2 ) no deben superponerse.
2) Igual que (1) , pero utiliza r1 como el primer rango y r2 como el segundo rango, como si se usara ranges:: begin ( r1 ) como first1 , ranges:: end ( r1 ) como last1 , ranges:: begin ( r2 ) como first2 , y ranges:: end ( r2 ) como last2 .

Las entidades similares a funciones descritas en esta página son algorithm function objects (conocidas informalmente como niebloids ), es decir:

Contenidos

Parámetros

first1, last1 - el par iterador-centinela que define el primer rango de elementos a intercambiar
first2, last2 - el par iterador-centinela que define el segundo rango de elementos a intercambiar
r1 - el primer rango de elementos a intercambiar
r2 - el segundo rango de elementos a intercambiar

Valor de retorno

{ first1 + M, first2 + M } .

Complejidad

Exactamente M intercambios.

Notas

Las implementaciones (por ejemplo, MSVC STL ) pueden habilitar la vectorización cuando el tipo de iterador modela contiguous_iterator y el intercambio de su tipo de valor no llama ni a funciones miembro especiales no triviales ni a ADL -encontrado swap .

Implementación posible

struct swap_ranges_fn
{
    template<std::input_iterator I1, std::sentinel_for<I1> S1,
             std::input_iterator I2, std::sentinel_for<I2> S2>
    requires std::indirectly_swappable<I1, I2>
    constexpr ranges::swap_ranges_result<I1, I2>
        operator()(I1 first1, S1 last1, I2 first2, S2 last2) const
    {
        for (; !(first1 == last1 or first2 == last2); ++first1, ++first2)
            ranges::iter_swap(first1, first2);
        return {std::move(first1), std::move(first2)};
    }
    template<ranges::input_range R1, ranges::input_range R2>
    requires std::indirectly_swappable<ranges::iterator_t<R1>, ranges::iterator_t<R2>>
    constexpr ranges::swap_ranges_result<ranges::borrowed_iterator_t<R1>,
                                         ranges::borrowed_iterator_t<R2>>
        operator()(R1&& r1, R2&& r2) const
    {
        return (*this)(ranges::begin(r1), ranges::end(r1),
                       ranges::begin(r2), ranges::end(r2));
    }
};
inline constexpr swap_ranges_fn swap_ranges {};

Ejemplo

#include <algorithm>
#include <iostream>
#include <list>
#include <string_view>
#include <vector>
auto print(std::string_view name, auto const& seq, std::string_view term = "\n")
{
    std::cout << name << " : ";
    for (const auto& elem : seq)
        std::cout << elem << ' ';
    std::cout << term;
}
int main()
{
    std::vector<char> p {'A', 'B', 'C', 'D', 'E'};
    std::list<char> q {'1', '2', '3', '4', '5', '6'};
    print("p", p);
    print("q", q, "\n\n");
    // intercambiar p[0, 2) y q[1, 3):
    std::ranges::swap_ranges(p.begin(),
                             p.begin() + 4,
                             std::ranges::next(q.begin(), 1),
                             std::ranges::next(q.begin(), 3));
    print("p", p);
    print("q", q, "\n\n");
    // intercambiar p[0, 5) y q[0, 5):
    std::ranges::swap_ranges(p, q);
    print("p", p);
    print("q", q);
}

Salida:

p : A B C D E
q : 1 2 3 4 5 6
p : 2 3 C D E
q : 1 A B 4 5 6
p : 1 A B 4 5
q : 2 3 C D E 6

Véase también

(C++20)
intercambia los valores referenciados por dos objetos desreferenciables
(objeto de punto de personalización)
intercambia los valores de dos objetos
(objeto de punto de personalización)
intercambia dos rangos de elementos
(plantilla de función)
intercambia los elementos apuntados por dos iteradores
(plantilla de función)
intercambia los valores de dos objetos
(plantilla de función)