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

CKTIS / C++

std::views::chunk — dividir um intervalo em grupos

C++23 std::views::chunk cria um intervalo lazy de vistas sobre grupos sucessivos e não sobrepostos de n elementos. O último grupo pode ser mais curto; n tem de ser positivo.

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

Sintaxe

#include <ranges>
std::views::chunk(range, n)
range | std::views::chunk(n)

std::views::chunk, disponível em <ranges> desde C++23, é um adaptador de intervalos que cria uma std::ranges::chunk_view. A escrita std::views::chunk(range, n) corresponde à forma em pipeline range | std::views::chunk(n). Os elementos mantêm a sua ordem; os grupos não se sobrepõem e o último pode conter menos de n elementos. Um intervalo vazio não produz grupos.

A precondição é n > 0: não passe zero nem um valor negativo. A vista forma os grupos de forma lazy, sem copiar os elementos para contentores separados. Se a origem for um contentor passado como lvalue, tem de continuar a existir enquanto a vista estiver a ser usada; operações que invalidem os seus iteradores também põem em risco as vistas dos grupos.

A origem tem de poder ser adaptada a uma vista e satisfazer, pelo menos, input_range. Para uma origem de passagem única, os grupos partilham o estado de travessia: processe o grupo atual antes de avançar para o seguinte. Uma origem que satisfaça forward_range permite travessias repetidas.

O exemplo soma os grupos {1, 2}, {3, 4} e {5}, apresentando 3, 7 e 5 em linhas separadas. Selecionar o modo C++23, por si só, não comprova o suporte da biblioteca padrão nem o funcionamento num ambiente de produção.

Exemplos

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

int main() {
    std::array<int, 5> values{1, 2, 3, 4, 5};

    for (auto chunk : values | std::views::chunk(2)) {
        int sum = 0;
        for (int value : chunk) {
            sum += value;
        }
        std::cout << sum << '\n';
    }
}

Resultado

3
7
5

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