Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::views::transform — transformação lazy de um intervalo

std::views::transform cria uma vista que calcula o resultado de uma função para um elemento apenas quando este é acedido. Não cria um contentor de resultados; pode ser usada diretamente ou numa sequência com o operador |.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <ranges>
std::views::transform(range, callable)
range | std::views::transform(callable)

std::views::transform, declarado em <ranges>, é um adaptador de intervalos que cria uma std::ranges::transform_view. Tanto std::views::transform(range, callable) como range | std::views::transform(callable) expõem os elementos transformados pela ordem da origem, sem os filtrar.

A avaliação é lazy: a função é chamada quando um iterador é desreferenciado, não quando a vista é criada. Os resultados não são armazenados em cache, pelo que um acesso repetido pode chamar a função novamente. A própria vista não cria um contentor de resultados nem substitui automaticamente a origem. No entanto, a função pode devolver uma referência em vez de um valor.

A função tem de satisfazer regular_invocable para a referência ao elemento: argumentos equivalentes devem produzir resultados equivalentes, sem modificar os argumentos nem o estado próprio do objeto função. O resultado não pode ter o tipo void. Por isso, evita contadores de chamadas e lambdas mutáveis como funções de transformação.

Se um contentor for passado como lvalue, a vista refere-se a esse contentor: este tem de permanecer válido enquanto a vista for usada. As referências capturadas pela função também têm de continuar válidas. Além disso, um iterador depende do objeto vista; não o conserves depois de a vista ser destruída.

O exemplo altera numbers[0] depois de criar doubled. O resultado 8 4 6 mostra que a vista lê os elementos atuais, em vez de armazenar uma cópia calculada anteriormente. Usa o modo de compilação -std=c++23; as fontes fornecidas são um projeto de norma em evolução, não um texto C++23 fixo.

Exemplos

#include <array>
#include <iostream>
#include <ranges>

int main() {
    std::array<int, 3> numbers{1, 2, 3};
    auto doubled = numbers | std::views::transform([](int n) {
        return n * 2;
    });

    numbers[0] = 4;
    bool first = true;
    for (int value : doubled) {
        if (!first) std::cout << ' ';
        std::cout << value;
        first = false;
    }
    std::cout << '\n';
}

Resultado

8 4 6

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes