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

CKTIS / C++

std::ranges::view_interface — interface para vistas personalizadas

std::ranges::view_interface é uma classe-base CRTP para vistas personalizadas. Fornece membros auxiliares com base nas operações do intervalo, mas a sua disponibilidade depende das capacidades do iterador e do sentinela.

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

Sintaxe

#include <ranges>

class D : public std::ranges::view_interface<D> {
public:
    // Provide begin() and end().
};

std::ranges::view_interface<D> utiliza CRTP: D herda publicamente da especialização com o seu próprio tipo. Implementa begin() e end(); a classe-base deriva deles operações auxiliares. A herança, por si só, não substitui os requisitos de std::ranges::view, incluindo os requisitos semânticos. Uma vista não tem de ser não proprietária.

Os membros estão disponíveis condicionalmente: front() requer forward_range, back() requer também bidirectional_range e common_range, e operator[] requer random_access_range. size() requer forward_range e sized_sentinel_for; data() requer um iterador contíguo. empty() funciona para sized_range ou forward_range. O operator bool explícito testa se o intervalo não está vazio quando ranges::empty é válido. As sobrecargas const verificam os requisitos correspondentes para const D.

front() e back() requerem um intervalo não vazio. operator[] não verifica os limites; o índice tem de designar um elemento existente. O int_view do exemplo não é proprietário dos dados: o array tem de continuar vivo durante o acesso através da vista. Uma vista const não implica que os elementos sejam imutáveis, pois o seu begin() devolve int*.

Esta entrada tem como referência C++23. O documento fornecido é um projeto de trabalho em evolução e pode incluir adições posteriores, como at(); não o considere uma especificação C++23 imutável. Uma opção do compilador no repositório não atesta o comportamento num ambiente de produção.

Exemplos

#include <iostream>
#include <ranges>

class int_view : public std::ranges::view_interface<int_view> {
    int* first_;
    int* last_;

public:
    int_view(int* first, int* last) : first_(first), last_(last) {}

    int* begin() const { return first_; }
    int* end() const { return last_; }
};

static_assert(std::ranges::view<int_view>);
static_assert(std::ranges::contiguous_range<int_view>);

int main() {
    int values[] = {10, 20, 30};
    int_view v(values, values + 3);

    std::cout << std::boolalpha << v.empty() << ' ' << v.size() << '\n';
    std::cout << v.front() << ' ' << v.back() << ' ' << v[1] << '\n';
    v.front() = 11;
    std::cout << values[0] << '\n';
}

Resultado

false 3
10 30 20
11

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