std::ranges:: borrowed_range, std::ranges:: enable_borrowed_range

Семантические требования

Пусть U будет std:: remove_reference_t < T > если T является типом rvalue-ссылки, и T в противном случае. Для переменной u типа U , T моделирует borrowed_range только если валидность итераторов, полученных из u не зависит от времени жизни этой переменной.

Специализации

Программа может специализировать enable_borrowed_range как true для cv-неквалифицированных программно-определенных типов , которые моделируют borrowed_range , и как false для типов, которые не моделируют. Такие специализации должны быть пригодны для использования в константных выражениях и иметь тип const bool .

Безусловно заимствованные диапазоны в стандартной библиотеке

Специализации enable_borrowed_range для всех специализаций следующих стандартных шаблонов определены как true :

• std::basic_string_view
• std::span
• std::ranges::subrange
• std::ranges::ref_view
• std::ranges::empty_view
• std::ranges::iota_view

Условно заимствованные диапазоны в стандартной библиотеке

Специализация enable_borrowed_range для следующих стандартных адаптеров диапазонов определена как true тогда и только тогда, когда std :: ranges :: enable_borrowed_range < V > имеет значение true , где V является базовым типом представления:

• std::ranges::common_view
• std::ranges::drop_view
• std::ranges::drop_while_view
• std::ranges::elements_view

• std::ranges::owning_view
• std::ranges::reverse_view

• std::ranges::take_view

1. ↑ Базовое представление V также должно удовлетворять требованиям forward_range .

Пример

#include <algorithm>
#include <array>
#include <cstddef>
#include <iostream>
#include <ranges>
#include <span>
#include <type_traits>
template<typename T, std::size_t N>
struct MyRange : std::array<T, N> {};
template<typename T, std::size_t N>
constexpr bool std::ranges::enable_borrowed_range<MyRange<T, N>> = false;
template<typename T, std::size_t N>
struct MyBorrowedRange : std::span<T, N> {};
template<typename T, std::size_t N>
constexpr bool std::ranges::enable_borrowed_range<MyBorrowedRange<T, N>> = true;
int main()
{
    static_assert(std::ranges::range<MyRange<int, 8>>);
    static_assert(std::ranges::borrowed_range<MyRange<int, 8>> == false);
    static_assert(std::ranges::range<MyBorrowedRange<int, 8>>);
    static_assert(std::ranges::borrowed_range<MyBorrowedRange<int, 8>> == true);
    auto getMyRangeByValue = []{ return MyRange<int, 4>{{1, 2, 42, 3}}; };
    auto dangling_iter = std::ranges::max_element(getMyRangeByValue());
    static_assert(std::is_same_v<std::ranges::dangling, decltype(dangling_iter)>);
    // *dangling_iter; // compilation error (i.e. dangling protection works.)
    auto my = MyRange<int, 4>{{1, 2, 42, 3}};
    auto valid_iter = std::ranges::max_element(my);
    std::cout << *valid_iter << ' '; // OK: 42
    auto getMyBorrowedRangeByValue = []
    {
        static int sa[4]{1, 2, 42, 3};
        return MyBorrowedRange<int, std::size(sa)>{sa};
    };
    auto valid_iter2 = std::ranges::max_element(getMyBorrowedRangeByValue());
    std::cout << *valid_iter2 << '\n'; // OK: 42
}

42 42

Смотрите также