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

出自cppreference.com
 
C++
 
範圍庫
範圍適配器
 
std::ranges::view_interface
 
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) 令 derived 為 static_cast<D&>(*this)。等價於 return std::to_address(ranges::begin(derived));。
2) 同 (1)，但 derived 為 static_cast<const D&>(*this)。

返回值

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

註解

下列派生類型可能使用 data 的默認實現：

  • ranges::common_view
  • 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

下列類型派生自 ranges::view_interface 並且不聲明其自身的 data 成員函數，但它們無法使用默認實現，因為其迭代器類型決不滿足 contiguous_iterator：

  • ranges::basic_istream_view
  • ranges::elements_view
  • std::ranges::filter_view
  • std::ranges::iota_view
  • ranges::join_view
  • ranges::lazy_split_view
  • std::ranges::reverse_view
  • 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)
 獲得指向底層數組的指針
(函數模板) [編輯]
(C++20)
 獲得指向連續範圍的起始的指針
(定製點對象) [編輯]
(C++20)
 獲得指向只讀連續範圍的起始的指針
(定製點對象) [編輯]
(C++20)
 從指針式類型獲得裸指針
(函數模板) [編輯]