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.