std::ranges::reserve_hint

inline namespace /* unspecified */ {
    inline constexpr auto reserve_hint = /* unspecified */;
}

template< class T >
    requires /* see below */
constexpr auto reserve_hint( T&& t );

Оценивает количество элементов в t за постоянное время.

Пусть t обозначает подвыражение, результатом которого является (возможно, материализованный) объект результата, обозначенный как E, а тип E — T:

• Если ranges::size(E) является допустимым выражением, ranges::reserve_hint(E) эквивалентно выражению ranges::size(E).
• В противном случае, если auto(t.reserve_hint()) является допустимым выражением целочисленного типа, ranges::reserve_hint(E) эквивалентно выражению auto(t.reserve_hint()).
• В противном случае, если выполнены все следующие условия, ranges::reserve_hint(E) эквивалентно выражению auto(reserve_hint(t)):
  • T является типом класса или перечисления.
  • auto(reserve_hint(t)) является допустимым выражением целочисленного типа, причём смысл reserve_hint определяется так, как если бы выполнялся только поиск, зависящий от аргументов.
• В противном случае ranges::reserve_hint(E) некорректно.

Диагностируемые некорректные случаи, описанные выше, приводят к ошибке подстановки, если ranges::reserve_hint(E) появляется в непосредственном контексте инстанцирования шаблона.

Объекты точек настройки

Имя ranges::reserve_hint обозначает объект точки настройки — константный функциональный объект типа класса литерального semiregular. Подробности см. в разделе CustomizationPointObject.

Примечания

Если ranges::reserve_hint(e) допустимо для выражения e, возвращаемый тип является целочисленным.

Пример

См. также