CKTIS / C++
std::views::drop — ignorar os primeiros N elementos
std::views::drop cria uma vista de um intervalo sem os seus primeiros N elementos, sem os remover do contentor. Pode usar-se a chamada com dois argumentos ou a sintaxe de pipeline. O número de elementos a ignorar tem de ser não negativo.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <ranges>
std::views::drop(range, count)
range | std::views::drop(count)std::views::drop, disponível através de <ranges>, é um objeto adaptador de intervalos. Tanto std::views::drop(range, count) como range | std::views::drop(count) produzem uma vista que ignora elementos no início do intervalo. O número de posições a ignorar é determinado pelo valor de count após a conversão para o tipo de diferença dos iteradores do intervalo. Se o valor convertido for zero, a vista inclui todos os elementos; se for igual ou superior ao comprimento de um intervalo finito, o resultado é vazio.
O adaptador não remove elementos do contentor nem cria um novo contentor com cópias dos valores restantes. O resultado é normalmente uma std::ranges::drop_view, mas a norma especifica outra vista equivalente para certos tipos de intervalo. Por isso, não pressuponha um tipo de resultado específico; use auto.
count tem de ser convertível para o tipo de diferença dos iteradores do intervalo. Tanto o valor fornecido como o valor convertido têm de ser não negativos. Um valor negativo não significa ignorar elementos a partir do fim. Se a vista fizer referência a um contentor existente, esse contentor tem de continuar a existir enquanto a vista for utilizada; operações que invalidem os seus iteradores também podem impedir a utilização segura da vista.
Ignorar elementos nem sempre tem custo constante: encontrar o início pode exigir percorrer os elementos ignorados. Para um intervalo que satisfaça forward_range, drop_view guarda em cache o início calculado quando tal é necessário para cumprir os requisitos de complexidade. No exemplo, values continua a conter cinco elementos, enquanto a iteração sobre tail imprime 30 40 50.
Exemplos
#include <array>
#include <iostream>
#include <ranges>
int main() {
std::array<int, 5> values{10, 20, 30, 40, 50};
auto tail = values | std::views::drop(2);
bool first = true;
for (int value : tail) {
if (!first) std::cout << ' ';
std::cout << value;
first = false;
}
std::cout << '\n';
}
Resultado
30 40 50
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.