Spec-Zone.ru › C++

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

constexpr auto size() requires ranges::forward_range<D> &&
    std::sized_sentinel_for<ranges::sentinel_t<D>, 
                            ranges::iterator_t<D>>;
(1) (since C++20)
constexpr auto size() const requires ranges::forward_range<const D> &&
    std::sized_sentinel_for<ranges::sentinel_t<const D>,
                            ranges::iterator_t<const D>>;
(2) (since C++20)

Реализация по умолчанию функции-члена size() получает размер диапазона, вычислив разность между конечным итератором и начальным итератором.

1) Пусть derived будет static_cast<D&>(*this). Эквивалентно return /*to-unsigned-like*/(ranges::end(derived) - ranges::begin(derived));, где шаблон функции to-unsigned-like выполняет явное преобразование типа аргумента к соответствующему беззнаковому типу.
2) Аналогично (1), за исключением того, что derived равно 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++.

DR Применено к Поведение, как опубликовано Правильное поведение
LWG 3646 C++20 реализации по умолчанию функций size возвращали тип со знаком они возвращают тип без знака

См. также

sizessize
(C++17)(C++20)
возвращает размер контейнера или массива
(шаблон функции)
ranges::size
(C++20)
возвращает целое число, равное размеру диапазона
(объект точки кастомизации)
ranges::ssize
(C++20)
возвращает целое число со знаком, равное размеру диапазона
(объект точки кастомизации)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/ranges/view_interface/size

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API