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::joinstd::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.