std::ranges::view_interface<D>::size

来自cppreference.com
 
 
范围库
范围适配器
 
 
constexpr auto size() requires ranges::forward_range<D> &&

    std::sized_sentinel_for<ranges::sentinel_t<D>,

                            ranges::iterator_t<D>>;
(1) (C++20 起)
constexpr auto size() const requires ranges::forward_range<const D> &&

    std::sized_sentinel_for<ranges::iterator_t<const D>,

                            ranges::sentinel_t<const D>>;
(2) (C++20 起)

size() 成员函数的默认实现通过计算哨位与起始迭代器间的差获得范围的大小。

返回值

1) to-unsigned-like (ranges::end(static_cast<D&>(this)) -
                     ranges::begin(static_cast<D&>(this)))
2) to-unsigned-like (ranges::end(static_cast<const D&>(this)) -
                     ranges::begin(static_cast<const D&>(this)))

注解

下列派生类型能使用 size() 的默认实现:

  • std::ranges::drop_while_view

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

  • std::ranges::basic_istream_view
  • std::ranges::filter_view
  • std::ranges::join_view
  • std::ranges::lazy_split_view
  • std::ranges::split_view
  • std::ranges::take_while_view

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
LWG 3646 C++20 size 函数的默认实现返回有符号类型 返回无符号类型

参阅

(C++17)(C++20)
返回容器或数组的大小
(函数模板)
返回等于范围大小的整数
(定制点对象)
返回等于范围大小的有符号整数
(定制点对象)