База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::ranges::transform — преобразуване на елементи към изход

std::ranges::transform изчислява стойности от един диапазон или от съответстващи елементи на два диапазона и ги записва чрез изходен итератор. Това е алгоритъм, който действа веднага, а не ленив изглед.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#include <algorithm>
std::ranges::transform(r, out, op);
std::ranges::transform(r, out, op, proj);
std::ranges::transform(first, last, out, op, proj);
std::ranges::transform(r1, r2, out, binary_op);
std::ranges::transform(r1, r2, out, binary_op, proj1, proj2);
std::ranges::transform(first1, last1, first2, last2, out, binary_op, proj1, proj2);

std::ranges::transform от <algorithm> приема диапазони или двойки итератор–страж. Унарната форма преобразува всеки елемент; бинарната комбинира съответстващите елементи и спира при по-късия входен диапазон. Незадължителните проекции proj, proj1, proj2 се прилагат преди операцията; по подразбиране не променят аргументите.

Изходът трябва да позволява записването на всички резултати. Алгоритъмът не увеличава контейнер: само reserve() не създава елементи. Осигурете съществуващи елементи или използвайте std::back_inserter с подходящ контейнер. Преобразуване на място е разрешено, когато изходът започва от началото на някой вход. Самата операция не трябва да променя елементите на диапазоните или да обезсилва итератори.

Резултатът предоставя крайните позиции като .in и .out или като .in1, .in2 и .out. За временен диапазон, който не е borrowed range, входно поле може да бъде от тип std::ranges::dangling. При N записани резултата операцията и всяка проекция се извикват точно N пъти.

За разлика от ленивия изглед std::views::transform, този алгоритъм записва резултатите, преди да се върне. Тази статия описва употребата в C++23; текущият работен проект съдържа и по-късни разширения. Флаг за компилатора в хранилището не удостоверява съвместимостта на продукционната среда за изпълнение.

Примери

#include <algorithm>
#include <array>
#include <iostream>

int main() {
    const std::array<int, 4> input{1, 2, 3, 4};
    std::array<int, 4> output{};

    auto result = std::ranges::transform(
        input, output.begin(), [](int x) { return x * x; });

    for (auto it = output.begin(); it != result.out; ++it) {
        if (it != output.begin()) std::cout << ' ';
        std::cout << *it;
    }
    std::cout << '\n';
}

Резултат

1 4 9 16

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници