std::ranges::view_interface<D>::data

来自cppreference.com
 
 
范围库
范围访问
范围转换器
(C++23)
范围原语



悬垂迭代器处理
范围概念
视图

范围工厂
适配器
范围生成器
范围适配器对象
范围适配器闭包对象
辅助项
 
std::ranges::view_interface
成员函数
(C++20)
(C++23)
(C++23)
data
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
 
constexpr auto data()
    requires std::contiguous_iterator<ranges::iterator_t<D>>;
(1) (C++20 起)
constexpr bool data() const
    requires std::contiguous_iterator<ranges::iterator_t<const D>>;
(2) (C++20 起)

data 成员函数的默认实现经由 std::to_address 获得起始迭代器所代表的地址,在派生类型的视图非空时,它亦是视图所引用的连续存储(为 contiguous_iterator 所蕴含)的最低地址。

1)derivedstatic_cast<D&>(*this) 。等价于 return std::to_address(ranges::begin(derived));
2)(1) ,除了 derivedstatic_cast<const D&>(*this)

参数

(无)

返回值

起始迭代器所代表的地址。

注解

下列派生类型可能使用 data 的默认实现:

  • std::ranges::drop_view
  • std::ranges::drop_while_view
  • std::ranges::ref_view
  • std::ranges::subrange
  • std::ranges::take_view
  • std::ranges::take_while_view

下列类型派生自 std::ranges::view_interface 并且不声明其自身的 data 成员函数,但它们无法使用默认实现,因为其迭代器类型决不满足 contiguous_iterator

  • std::ranges::basic_istream_view
  • std::ranges::common_view
  • std::ranges::elements_view
  • std::ranges::filter_view
  • std::ranges::iota_view
  • std::ranges::join_view
  • std::ranges::reverse_view
  • std::ranges::split_view
  • std::ranges::transform_view

示例

#include <array>
#include <iostream>
#include <ranges>
#include <string_view>
 
int main() {
    constexpr std::string_view str { "Hello, C++20!" };
    std::cout << (str | std::views::drop(7)).data() << '\n';
    constexpr static std::array a { 1,2,3,4,5 };
    constexpr auto v { a | std::views::take(3) };
    static_assert( &a[0] == v.data() );
}

输出:

C++20!

参阅

(C++17)
获得指向底层数组的指针
(函数模板)
获得指向连续范围的起始的指针
(定制点对象)
获得指向只读连续范围的起始的指针
(定制点对象)
从指针式类型获得裸指针
(函数模板)