Namespaces
Variants

std::ranges:: sort

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
Défini dans l'en-tête <algorithm>
Signature d'appel
template < std:: random_access_iterator I, std:: sentinel_for < I > S,

class Comp = ranges:: less , class Proj = std:: identity >
requires std:: sortable < I, Comp, Proj >
constexpr I

sort ( I first, S last, Comp comp = { } , Proj proj = { } ) ;
(1) (depuis C++20)
template < ranges:: random_access_range R, class Comp = ranges:: less ,

class Proj = std:: identity >
requires std:: sortable < ranges:: iterator_t < R > , Comp, Proj >
constexpr ranges:: borrowed_iterator_t < R >

sort ( R && r, Comp comp = { } , Proj proj = { } ) ;
(2) (depuis C++20)

Trie les éléments dans la plage [ first , last ) en ordre non décroissant. L'ordre des éléments équivalents n'est pas garanti d'être préservé.

Une séquence est triée par rapport à un comparateur comp si pour tout itérateur it pointant vers la séquence et tout entier non négatif n tel que it + n soit un itérateur valide pointant vers un élément de la séquence, std:: invoke ( comp, std:: invoke ( proj, * ( it + n ) ) , std:: invoke ( proj, * it ) ) s'évalue à false .

1) Les éléments sont comparés en utilisant la fonction de comparaison binaire donnée comp .
2) Identique à (1) , mais utilise r comme plage source, comme si on utilisait ranges:: begin ( r ) comme first et ranges:: end ( r ) comme last .

Les entités de type fonction décrites sur cette page sont des objets fonction algorithme (informellement appelés niebloids ), c'est-à-dire :

Table des matières

Paramètres

first, last - la paire itérateur-sentinelle définissant la plage des éléments à trier
r - la plage à trier
comp - comparaison à appliquer aux éléments projetés
proj - projection à appliquer aux éléments

Valeur de retour

Un itérateur égal à last .

Complexité

𝓞(N·log(N)) comparaisons et projections, où N = ranges:: distance ( first, last ) .

Implémentation possible

Notez que les implémentations typiques utilisent Introsort . Voir également l'implémentation dans MSVC STL et libstdc++ .

struct sort_fn
{
    template<std::random_access_iterator I, std::sentinel_for<I> S,
             class Comp = ranges::less, class Proj = std::identity>
    requires std::sortable<I, Comp, Proj>
    constexpr I
        operator()(I first, S last, Comp comp = {}, Proj proj = {}) const
    {
        if (first == last)
            return first;
        I last_iter = ranges::next(first, last);
        ranges::make_heap(first, last_iter, std::ref(comp), std::ref(proj));
        ranges::sort_heap(first, last_iter, std::ref(comp), std::ref(proj));
        return last_iter;
    }
    template<ranges::random_access_range R, class Comp = ranges::less,
             class Proj = std::identity>
    requires std::sortable<ranges::iterator_t<R>, Comp, Proj>
    constexpr ranges::borrowed_iterator_t<R>
        operator()(R&& r, Comp comp = {}, Proj proj = {}) const
    {
        return (*this)(ranges::begin(r), ranges::end(r), std::move(comp), std::move(proj));
    }
};
inline constexpr sort_fn sort {};

Notes

std::sort utilise std::iter_swap pour échanger les éléments, tandis que ranges::sort utilise plutôt ranges::iter_swap (qui effectue une ADL pour iter_swap , contrairement à std::iter_swap )

Exemple

#include <algorithm>
#include <array>
#include <functional>
#include <iomanip>
#include <iostream>
void print(auto comment, auto const& seq, char term = ' ')
{
    for (std::cout << comment << '\n'; auto const& elem : seq)
        std::cout << elem << term;
    std::cout << '\n';
}
struct Particle
{
    std::string name; double mass; // MeV
    template<class Os> friend
    Os& operator<<(Os& os, Particle const& p)
    {
        return os << std::left << std::setw(8) << p.name << " : " << p.mass << ' ';
    }
};
int main()
{
    std::array s {5, 7, 4, 2, 8, 6, 1, 9, 0, 3};
    namespace ranges = std::ranges;
    ranges::sort(s);
    print("Tri utilisant l'opérateur < par défaut", s);
    ranges::sort(s, ranges::greater());
    print("Tri utilisant un objet de comparaison de la bibliothèque standard", s);
    struct
    {
        bool operator()(int a, int b) const { return a < b; }
    } customLess;
    ranges::sort(s.begin(), s.end(), customLess);
    print("Tri utilisant un objet fonction personnalisé", s);
    ranges::sort(s, [](int a, int b) { return a > b; });
    print("Tri utilisant une expression lambda", s);
    Particle particles[]
    {
        {"Electron", 0.511}, {"Muon", 105.66}, {"Tau", 1776.86},
        {"Positron", 0.511}, {"Proton", 938.27}, {"Neutron", 939.57}
    };
    ranges::sort(particles, {}, &Particle::name);
    print("\nTri par nom utilisant une projection", particles, '\n');
    ranges::sort(particles, {}, &Particle::mass);
    print("Tri par masse utilisant une projection", particles, '\n');
}

Sortie :

Tri utilisant l'opérateur < par défaut
0 1 2 3 4 5 6 7 8 9
Tri utilisant un objet de comparaison de la bibliothèque standard
9 8 7 6 5 4 3 2 1 0
Tri utilisant un objet fonction personnalisé
0 1 2 3 4 5 6 7 8 9
Tri utilisant une expression lambda
9 8 7 6 5 4 3 2 1 0
Tri par nom utilisant une projection
Electron : 0.511
Muon     : 105.66
Neutron  : 939.57
Positron : 0.511
Proton   : 938.27
Tau      : 1776.86
Tri par masse utilisant une projection
Electron : 0.511
Positron : 0.511
Muon     : 105.66
Proton   : 938.27
Neutron  : 939.57
Tau      : 1776.86

Voir aussi

trie les N premiers éléments d'une plage
(objet fonction algorithme)
trie une plage d'éléments en préservant l'ordre entre les éléments égaux
(objet fonction algorithme)
divise une plage d'éléments en deux groupes
(objet fonction algorithme)
trie une plage en ordre croissant
(modèle de fonction)