CKTIS / C++
std::ranges::subrange — uma vista de iterador e sentinela
std::ranges::subrange de <ranges> combina um iterador inicial e uma sentinela final para formar uma vista de [first, last). Não copia elementos para um novo contentor; permite passar uma parte selecionada dos dados como um único objeto.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <ranges>
std::ranges::subrange r(first, last);
r.begin();
r.end();std::ranges::subrange<I, S, K> guarda um iterador e uma sentinela, formando uma vista de [first, last): o início está incluído e o fim está excluído. Os tipos I e S podem ser diferentes; o armazenamento não tem de ser contíguo. Inclua <ranges>. Ao construir std::ranges::subrange(first, last), os argumentos do modelo são deduzidos.
std::ranges::subrange::begin devolve uma cópia do iterador guardado quando I satisfaz copyable. Caso contrário, só está disponível a sobrecarga não-const, que move o iterador guardado; nesse caso, não presuma que chamadas repetidas reproduzem o mesmo início. std::ranges::subrange::end devolve uma cópia da sentinela. Compare um iterador com end() antes de o desreferenciar; a sentinela não tem de permitir a desreferenciação.
K seleciona subrange_kind::sized ou subrange_kind::unsized. Só a variante sized disponibiliza size(): calcula o resultado subtraindo os extremos ou guarda um tamanho quando essa subtração não está disponível. O construtor que recebe o argumento n exige que n corresponda ao comprimento efetivo do intervalo válido [first, last).
A vista não copia elementos nem prolonga, por si só, o tempo de vida dos dados. Não a utilize depois de os dados serem destruídos ou de os seus iteradores serem invalidados. Uma modificação através de um iterador gravável altera os dados originais; tornar a própria vista const não torna constantes os seus elementos.
O exemplo abrange values[1], values[2] e values[3]. Depois de alterar o primeiro destes elementos para 21, imprime exatamente sum=91 e values[1]=21, cada um na sua própria linha. Âmbito das informações do ambiente: C++23; opção do compilador do repositório, compatibilidade do ambiente de produção não atestada. A norma online é um projeto em evolução, não uma publicação C++23 congelada.
Exemplos
#include <iostream>
#include <ranges>
int main() {
int values[] = {10, 20, 30, 40, 50};
auto middle = std::ranges::subrange(values + 1, values + 4);
*middle.begin() = 21;
int sum = 0;
for (auto it = middle.begin(); it != middle.end(); ++it) {
sum += *it;
}
std::cout << "sum=" << sum << '\n';
std::cout << "values[1]=" << values[1] << '\n';
}
Resultado
sum=91 values[1]=21
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.