Namespaces
Variants

std::next_permutation

С ru.cppreference.net
 
 
Библиотека алгоритмов
Ограниченные алгоритмы и алгоритмы по диапазонам (C++20)
Ограниченные алгоритмы, например ranges::copy, ranges::sort, ...
Не изменяющие последовательность операции    
Пакетные операции
(C++17)
Операции поиска
Изменяющие последовательность операции
Операции копирования
(C++11)
(C++11)
Операции обмена
Операции преобразования
Операции генерации
Операции удаления
Операции изменения порядка
(до C++17)(C++11)
(C++20)(C++20)
Операции выборки
(C++17)

Сортировка и связанные операции
Операции разделения
(C++11)    

Операции сортировки
Операции бинарного поиска
(по разделенным диапазонам)
Операции над множествами (по отсортированным диапазонам)
Операции слияния (по отсортированным диапазонам)
Операции с кучей
Операции минимума/максимума
(C++11)
(C++17)
Операции лексикографического сравнения
Операции перестановок


Политики выполнения (C++17)
(только для пояснения*)(C++26)

Численные операции
(C++11)
(C++17)
(C++17)    

Специализированные <memory> алгоритмы

Специализированные <random> алгоритмы
Библиотека C









 
Определён в заголовке <algorithm>
template< class BidirIt >
bool next_permutation( BidirIt first, BidirIt last );
(1) (constexpr начиная с C++20)
template< class BidirIt, class Compare >
bool next_permutation( BidirIt first, BidirIt last, Compare comp );
(2) (constexpr начиная с C++20)

Преобразует диапазон [first, last) в следующую перестановку. Возвращает true если такая «следующая перестановка» существует; в противном случае преобразует диапазон в лексикографически первую перестановку (по возрастанию) и возвращает false.

1) Множество всех перестановок упорядочено лексикографически относительно operator<(до C++20)std::less{}(начиная с C++20).
2) Множество всех перестановок упорядочено лексикографически относительно comp.

Если тип *first не является Swappable(до C++11)BidirIt не является ValueSwappable(начиная с C++11), поведение не определено.

Параметры

first, last - пара итераторов, определяющая диапазон элементов для перестановки
comp - объект функции сравнения (т.е. объект, удовлетворяющий требованиям Compare), который возвращает true если первый аргумент меньше второго.

Сигнатура функции сравнения должна быть эквивалентна следующей:

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

Хотя сигнатура не обязательно должна содержать const&, функция не должна изменять переданные ей объекты и должна принимать все значения типа (возможно, const) Type1 и Type2 независимо от категории значения (таким образом, Type1& не допускается, как и Type1 если только для Type1 перемещение эквивалентно копированию(начиная с C++11)).
Типы Type1 и Type2 должны быть такими, что объект типа BidirIt можно разыменовать и затем неявно преобразовать к каждому из них.

Требования к типам
-
BidirIt должен соответствовать требованиям LegacyBidirectionalIterator.

Возвращаемое значение

true true, если новая перестановка лексикографически больше старой. false false, если достигнута последняя перестановка и диапазон сброшен к первой перестановке.

Сложность

Пусть N равно std::distance(first, last):

1,2) Не более
N
2
обменов.

Исключения

Любые исключения, генерируемые операциями с итераторами или обменом элементов.

Возможная реализация

template<class BidirIt>
bool next_permutation(BidirIt first, BidirIt last)
{
    auto r_first = std::make_reverse_iterator(last);
    auto r_last = std::make_reverse_iterator(first);
    auto left = std::is_sorted_until(r_first, r_last);
    
    if (left != r_last)
    {
        auto right = std::upper_bound(r_first, left, *left);
        std::iter_swap(left, right);
    }
    
    std::reverse(left.base(), last);
    return left != r_last;
}

Примечания

В среднем по всей последовательности перестановок типичные реализации используют около 3 сравнений и 1,5 обменов на вызов.

Реализации (например, MSVC STL) могут включать векторизацию, когда тип итератора удовлетворяет LegacyContiguousIterator и обмен его типа значения не вызывает ни нетривиальную специальную функцию-член, ни ADL-найденный swap.

Пример

Следующий код выводит все перестановки строки.

#include <algorithm>
#include <cassert>
#include <iostream>
#include <string>

int main()
{
    std::string s = "ABBA";
    std::sort(s.begin(), s.end());
    
    do
        std::cout << s << '\n';
    while (std::next_permutation(s.begin(), s.end()));

    assert(std::is_sorted(s.begin(), s.end()));
}

Вывод:

AABB
ABAB
ABBA
BAAB
BABA
BBAA

См. также

определяет, является ли последовательность перестановкой другой последовательности
(шаблон функции & объект функции алгоритма)
генерирует следующую меньшую лексикографическую перестановку диапазона элементов
(шаблон функции & объект функции алгоритма)
генерирует следующую большую лексикографическую перестановку диапазона элементов
(объект функции алгоритма)