Пространства имён
Варианты
Действия

std::rotate

Материал из cppreference.com
< cpp‎ | algorithm
 
 
Алгоритмы
Функции
Немодифицирующие линейные операции
Модифицирующие линейные операции
Разделение
Сортировка (на отсортированных промежутках)
Бинарный поиск (на отсортированных промежутках)
Множества (на отсортированных промежутках)
Куча
Минимум/максимум
Числовые операции
Библиотека C
 
Определено в заголовочном файле <algorithm>
template< class ForwardIt >

void rotate( ForwardIt first, ForwardIt n_first, ForwardIt last );
template< class ForwardIt >

ForwardIt rotate( ForwardIt first, ForwardIt n_first, ForwardIt last );
(до C++11)

(начиная с C++11)

Меняет местами элементы в диапазоне [first, last) таким образом, что элемент n_first становится первым в новом диапазоне, а n_first-1 — последним.

Содержание

[править] Параметры

first, last - диапазон элементов для изменения их порядка
n_first - элемент, который должен стать первым в новом диапазоне
Требования к типам
-
ForwardIt должен соответствовать требованиям ValueSwappable and ForwardIterator.
-
The type of dereferenced ForwardIt must meet the requirements of MoveAssignable and MoveConstructible.

[править] Возвращаемое значение

(Нет) (до C++11)

Итератор, равный first + (last - n_first). (начиная с C++11)

[править] Сложность

Линейная по расстоянию между first и last.

[править] Возможная реализация

template<class ForwardIt>
void rotate(ForwardIt first, ForwardIt n_first, ForwardIt last)
{
    ForwardIt next = n_first;
    while (first != next) {
        std::swap(*first++, *next++);
        if (next == last) {
            next = n_first;
        } else if (first == n_first) {
            n_first = next;
        }
    }
}

[править] Пример

std::rotate — распространённый "строительный кирпичик" во многих алгоритмах. Этот пример демонстрирует сортировку вставками в C++.

#include <vector>
#include <iostream>
#include <algorithm>
 
int main()
{
    std::vector<int> v{2, 4, 2, 0, 5, 10, 7, 3, 7, 1};
 
    std::cout << "до сортировки   :      ";
    for(int n: v)
        std::cout << n << ' ';
    std::cout << '\n';
 
    // сортировка вставками
    for (auto i = v.begin(); i != v.end(); ++i) {
        std::rotate(std::upper_bound(v.begin(), i, *i), i, i+1);
    }
 
    std::cout << "после сортировки:      ";
    for(int n: v)
        std::cout << n << ' ';
    std::cout << '\n';
 
    // вращение влево
    std::rotate(v.begin(), v.begin() + 1, v.end());
 
    std::cout << "после вращения влево : ";
    for(int n: v)
        std::cout << n << ' ';
    std::cout << '\n';
 
    // вращение вправо
    std::rotate(v.rbegin(), v.rbegin() + 1, v.rend());
 
    std::cout << "после вращения вправо: ";
    for(int n: v)
        std::cout << n << ' ';
    std::cout << '\n';
 
}

Вывод:

до сортировки   :      2 4 2 0 5 10 7 3 7 1
после сортировки:      0 1 2 2 3 4 5 7 7 10
после вращения влево : 1 2 2 3 4 5 7 7 10 0
после вращения вправо: 0 1 2 2 3 4 5 7 7 10

[править] См. также

копии и вращать в диапазоне элементов
Оригинал:
copies and rotate a range of elements
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

(шаблон функции) [edit]