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

CKTIS / C++

std::views::join — achatamento preguiçoso de intervalos

std::views::join cria uma vista preguiçosa dos elementos de um intervalo de intervalos. Achata um nível, preserva a ordem e ignora os intervalos internos vazios sem construir um novo contentor.

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

Sintaxe

#include <ranges>
std::views::join(r)
r | std::views::join

std::views::join, declarado em <ranges>, é um adaptador de intervalos que cria uma std::ranges::join_view. Escrever r | std::views::join corresponde a chamar std::views::join(r). O intervalo externo e os seus intervalos internos têm de permitir, pelo menos, a leitura sequencial exigida por input_range.

A vista achata exatamente um nível: percorre os elementos dos intervalos internos sucessivos e ignora os intervalos vazios. Não insere separadores nem cria um contentor de resultado. No exemplo, os espaços são escritos pelo ciclo, não pelo adaptador.

Para um contentor passado como lvalue, a vista referencia os dados existentes. O tempo de vida do contentor não pode terminar enquanto a vista estiver a ser usada; evita alterações que invalidem iteradores. Quando a desreferenciação produz uma referência modificável, escrever através dessa referência altera o elemento de origem.

Não pressuponhas acesso aleatório nem a disponibilidade de size(), mesmo quando a origem usa vetores. A capacidade do iterador depende dos intervalos e da forma como os respetivos elementos são expostos; join_view permite, no máximo, iteração bidirecional. O projeto de trabalho citado é atualizado ao longo do tempo e não é uma especificação C++23 fixa.

Exemplos

#include <iostream>
#include <ranges>
#include <vector>

int main() {
    std::vector<std::vector<int>> rows{{1, 2}, {}, {3, 4}};
    auto flat = rows | std::views::join;

    bool first = true;
    for (int value : flat) {
        if (!first) std::cout << ' ';
        std::cout << value;
        first = false;
    }
    std::cout << '\n';
}

Resultado

1 2 3 4

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