Namespaces
Variants

std::is_permutation

Depuis fr.cppreference.net
 
 
Bibliothèque d’algorithmes
Algorithmes contraints et algorithmes sur les plages (C++20)
Algorithmes contraints, par ex. ranges::copy, ranges::sort, ...
Opérations de séquence non modificatrices    
Opérations par lots
(C++17)
Opérations de recherche
Opérations de séquence modificatrices
Opérations de copie
(C++11)
(C++11)
Opérations d’échange
Opérations de transformation
Opérations de génération
Opérations de suppression
Opérations de changement d’ordre
(jusqu’à C++17)(C++11)
(C++20)(C++20)
Opérations d’échantillonnage
(C++17)

Opérations de tri et apparentées
Opérations de partitionnement
(C++11)    

Opérations de tri
Opérations de recherche binaire
(sur des plages partitionnées)
Opérations d’ensemble (sur des plages triées)
Opérations de fusion (sur des plages triées)
Opérations de tas
Opérations de minimum/maximum
(C++11)
(C++17)
Opérations de comparaison lexicographique
Opérations de permutation


 
Défini dans l’en‑tête <algorithm>
template< class ForwardIt1, class ForwardIt2 >
bool is_permutation( ForwardIt1 first1, ForwardIt1 last1,
                     ForwardIt2 first2 );
(1) (depuis C++11)
(constexpr depuis C++20)
template< class ForwardIt1, class ForwardIt2,
          class BinaryPredicate >
bool is_permutation( ForwardIt1 first1, ForwardIt1 last1,
                     ForwardIt2 first2, BinaryPredicate p );
(2) (depuis C++11)
(constexpr depuis C++20)
template< class ForwardIt1, class ForwardIt2 >
bool is_permutation( ForwardIt1 first1, ForwardIt1 last1,
                     ForwardIt2 first2, ForwardIt2 last2 );
(3) (depuis C++14)
(constexpr depuis C++20)
template< class ForwardIt1, class ForwardIt2,
          class BinaryPredicate >
bool is_permutation( ForwardIt1 first1, ForwardIt1 last1,
                     ForwardIt2 first2, ForwardIt2 last2,
                     BinaryPredicate p );
(4) (depuis C++14)
(constexpr depuis C++20)

Vérifie si [first1last1) est une permutation d’une plage commençant à first2:

  • Pour les surcharges (1,2), la deuxième plage a std::distance(first1, last1) éléments.
  • Pour les surcharges (3,4), la deuxième plage est [first2last2).
1,3) Les éléments sont comparés en utilisant operator==.
2,4) Les éléments sont comparés en utilisant le prédicat binaire donné p.

Si ForwardIt1 et ForwardIt2 ont des types de valeur différents, le programme est mal formé.

Si la fonction de comparaison n’est pas une relation d’équivalence, le comportement est indéfini.

Paramètres

first1, last1 - la paire d’itérateurs définissant la première plage d’éléments à comparer
first2, last2 - la paire d’itérateurs définissant la deuxième plage d’éléments à comparer
p - prédicat binaire qui renvoie ​true si les éléments doivent être considérés comme égaux.

La signature du prédicat doit être équivalente à ce qui suit :

bool pred(const Type1 &a, const Type2 &b);

Bien que la signature n’ait pas besoin d’avoir const &, la fonction ne doit pas modifier les objets qui lui sont passés et doit pouvoir accepter toutes les valeurs de type (éventuellement const) Type1 et Type2 indépendamment de la catégorie de valeur (ainsi, Type1 & n’est pas autorisé, ni Type1 sauf si pour Type1 un déplacement est équivalent à une copie(depuis C++11)).
Les types Type1 et Type2 doivent être tels que les objets de types InputIt1 et InputIt2 puissent être déréférencés puis implicitement convertis en Type1 et Type2 respectivement. ​

Exigences de type
-
ForwardIt1, ForwardIt2 doit satisfaire les exigences de LegacyForwardIterator.

Valeur de retour

true si la plage [first1last1) est une permutation de la plage [first2last2), false sinon.

Complexité

Étant donné N comme std::distance(first1, last1):

1) Exactement N comparaisons en utilisant operator== si les deux plages sont égales, sinon O(N2
)
comparaisons dans le pire des cas.
2) Exactement N applications du prédicat p si les deux plages sont égales, sinon O(N2
)
applications dans le pire des cas.
3,4) Si ForwardIt1 et ForwardIt2 sont tous deux des LegacyRandomAccessIterator, et que last1 - first1 != last2 - first2 est true, aucune comparaison ne sera effectuée.
Sinon :
3) Exactement N comparaisons en utilisant operator== si les deux plages sont égales, sinon O(N2
)
comparaisons dans le pire des cas.
4) Exactement N applications du prédicat p si les deux plages sont égales, sinon O(N2
)
applications dans le pire des cas.

Implémentation possible

template<class ForwardIt1, class ForwardIt2>
bool is_permutation(ForwardIt1 first, ForwardIt1 last,
                    ForwardIt2 d_first)
{
    // skip common prefix
    std::tie(first, d_first) = std::mismatch(first, last, d_first);
    
    // iterate over the rest, counting how many times each element
    // from [first, last) appears in [d_first, d_last)
    if (first != last)
    {
        ForwardIt2 d_last = std::next(d_first, std::distance(first, last));
        for (ForwardIt1 i = first; i != last; ++i)
        {
            if (i != std::find(first, i, *i))
                continue; // this *i has been checked
            
            auto m = std::count(d_first, d_last, *i);
            if (m == 0 || std::count(i, last, *i) != m)
                return false;
        }
    }
    return true;
}

Note

La std::is_permutation peut être utilisée dans les tests, à savoir pour vérifier la correction des algorithmes de réarrangement (par ex. tri, mélange, partitionnement). Si x est une plage d’origine et y est une plage permutée, alors std::is_permutation(x, y) == true signifie que y consistent en "les mêmes" éléments, peut-être situés à d’autres positions.

Exemple

#include <algorithm>
#include <iostream>

template<typename Os, typename V>
Os& operator<<(Os& os, const V& v)
{
    os << "{ ";
    for (const auto& e : v)
        os << e << ' ';
    return os << '}';
}

int main()
{
    static constexpr auto v1 = {1, 2, 3, 4, 5};
    static constexpr auto v2 = {3, 5, 4, 1, 2};
    static constexpr auto v3 = {3, 5, 4, 1, 1};
    
    std::cout << v2 << " is a permutation of " << v1 << ": " << std::boolalpha
              << std::is_permutation(v1.begin(), v1.end(), v2.begin()) << '\n'
              << v3 << " is a permutation of " << v1 << ": "
              << std::is_permutation(v1.begin(), v1.end(), v3.begin()) << '\n';
}

Sortie :

{ 3 5 4 1 2 } is a permutation of { 1 2 3 4 5 }: true
{ 3 5 4 1 1 } is a permutation of { 1 2 3 4 5 }: false

Voir aussi

génère la prochaine permutation lexicographique plus grande d’une plage d’éléments
(modèle de fonction & objet fonction d’algorithme)
génère la prochaine permutation lexicographique plus petite d’une plage d’éléments
(modèle de fonction & objet fonction d’algorithme)
spécifie qu’une relation impose une relation d’équivalence
(concept)
détermine si une séquence est une permutation d’une autre séquence
(objet fonction d’algorithme)