std::ranges::copy_n, std::ranges::copy_n_result

template< std::input_iterator I, std::weakly_incrementable O >
requires std::indirectly_copyable<I, O>
constexpr copy_n_result<I, O>
    copy_n( I first, std::iter_difference_t<I> n, O result );

template< class I, class O >
using copy_n_result = ranges::in_out_result<I, O>;

Сущности, подобные функциям, описанные на этой странице, являются объектами-функциями алгоритмов (неформально известными как niebloids), а именно:

• Явные списки аргументов шаблона не могут быть указаны при вызове любой из них.
• Ни одна из них не видна для поиска, зависящего от аргументов.
• Когда любая из них найдена обычным неквалифицированным поиском как имя слева от оператора вызова функции, поиск, зависящий от аргументов подавляется.

Параметры

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

ranges :: copy_n_result { first + n, result + n } или, более формально, значение типа ranges::in_out_result содержащее input_iterator итератор равный ranges:: next ( first, n ) и weakly_incrementable итератор равный ranges:: next ( result, n ) .

Сложность

Ровно n присваиваний.

Примечания

На практике реализации std::ranges::copy_n могут избегать множественных присваиваний и использовать массовые функции копирования, такие как std::memmove , если тип значения является TriviallyCopyable и типы итераторов удовлетворяют требованиям contiguous_iterator . Альтернативно, такое ускорение копирования может быть внедрено на фазе оптимизации компилятора.

При копировании перекрывающихся диапазонов, std::ranges::copy_n следует использовать при копировании влево (начало целевого диапазона находится вне исходного диапазона), тогда как std::ranges::copy_backward следует использовать при копировании вправо (конец целевого диапазона находится вне исходного диапазона).

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

struct copy_n_fn
{
    template<std::input_iterator I, std::weakly_incrementable O>
    requires std::indirectly_copyable<I, O>
    constexpr ranges::copy_n_result<I, O>
        operator()(I first, std::iter_difference_t<I> n, O result) const
    {
        for (; n-- > 0; (void)++first, (void)++result)
            *result = *first;
        return {std::move(first), std::move(result)};
    }
};
inline constexpr copy_n_fn copy_n{};

` и `` оставлен без изменений, как и требовалось. HTML-теги и атрибуты также сохранены в оригинальном виде.

Пример

#include <algorithm>
#include <iomanip>
#include <iostream>
#include <iterator>
#include <string>
#include <string_view>
int main()
{
    const std::string_view in{"ABCDEFGH"};
    std::string out;
    std::ranges::copy_n(in.begin(), 4, std::back_inserter(out));
    std::cout << std::quoted(out) << '\n';
    out = "abcdefgh";
    const auto res{std::ranges::copy_n(in.begin(), 5, out.begin())};
    const auto i{std::distance(std::begin(in), res.in)};
    const auto j{std::distance(std::begin(out), res.out)};
    std::cout << "in[" << i << "] = '" << in[i] << "'\n"
              << "out[" << j << "] = '" << out[j] << "'\n";
}

"ABCD"
in[5] = 'F'
out[5] = 'f'

Смотрите также