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

CKTIS / C++

std::views::take — uma vista dos primeiros elementos de um intervalo

std::views::take, disponibilizado por <ranges>, cria uma vista de, no máximo, count elementos iniciais de um intervalo. Mantém a ordem, não cria um contentor separado e permite tanto a chamada direta como a notação em pipeline.

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

Sintaxe

#include <ranges>
std::views::take(range, count)
range | std::views::take(count)

std::views::take é um objeto adaptador de intervalos disponibilizado por <ranges>. A expressão std::views::take(range, count) corresponde a range | std::views::take(count). Se count for não negativo e representável no tipo de diferença dos iteradores do intervalo, o resultado expõe os primeiros count elementos pela ordem original ou o intervalo inteiro, caso contenha menos elementos. Se count for 0, o resultado é vazio.

Trata-se de uma vista, não de um contentor copiado: aplicar o adaptador não copia os elementos para uma nova coleção nem remove os elementos finais da origem. Os elementos são lidos durante a iteração. O resultado não tem necessariamente o tipo std::ranges::take_view; para certos tipos de intervalos, a norma prevê outras representações de vista equivalentes, pelo que, em geral, é adequado usar auto.

O argumento count tem de ser convertível para o tipo de diferença dos iteradores do intervalo. Deve usar-se um valor não negativo e representável nesse tipo, mesmo quando o adaptador não constrói uma std::ranges::take_view. Por exemplo, no caso otimizado de std::span, o adaptador converte count para esse tipo antes de determinar o mínimo entre o valor convertido e o comprimento do intervalo. Um valor de um tipo sem sinal demasiado grande para ser representado pode dar -1 após a conversão e levar a operações aritméticas inválidas com iteradores, em vez de selecionar o intervalo inteiro. Quando o adaptador constrói uma std::ranges::take_view, o construtor exige que o valor convertido seja não negativo. Um valor negativo não significa contar a partir do fim. Se o tipo do intervalo de entrada for uma especialização de std::ranges::empty_view, o adaptador avalia o argumento count e descarta o seu valor sem construir uma std::ranges::take_view, pelo que um valor negativo não viola essa precondição.

Ao adaptar um contentor existente através de um lvalue, a vista refere-se a esse contentor. Por isso, a origem tem de continuar válida enquanto a vista for utilizada, e operações que invalidem iteradores também podem invalidar o acesso através da vista. No exemplo, a alteração de values[0] depois de criar first reflete-se no resultado: 11 20 30. O código apresentado foi executado sem alterações num ambiente isolado. A saída padrão coincidiu exatamente com a saída indicada.

Exemplos

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

int main() {
    std::array<int, 5> values{10, 20, 30, 40, 50};
    auto first = values | std::views::take(3);
    values[0] = 11;

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

Resultado

11 20 30

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