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 );

Schätzt die Anzahl der Elemente in t in konstanter Zeit.

Gegeben der Teilausdruck, von dem t das (möglicherweise materialisierte) Ergebnisobjekt als E bezeichnet, und der Typ von E als T:

• Falls ranges::size(E) ein gültiger Ausdruck ist, ist ranges::reserve_hint(E) ausdrucksäquivalent zu ranges::size(E).
• Andernfalls, falls auto(t.reserve_hint()) ein gültiger Ausdruck von ganzzahligem Typ ist, ist ranges::reserve_hint(E) ausdrucksäquivalent zu auto(t.reserve_hint()).
• Andernfalls, falls alle folgenden Bedingungen erfüllt sind, dann ist ranges::reserve_hint(E) ausdrucksäquivalent zu auto(reserve_hint(t)):
  • T ist ein Klassen- oder Aufzählungstyp.
  • auto(reserve_hint(t)) ist ein gültiger Ausdruck von ganzzahligem Typ, wobei die Bedeutung von reserve_hint wie durch ausschließliche argumentabhängige Namenssuche ermittelt festgelegt wird.
• Andernfalls ist ranges::reserve_hint(E) fehlerhaft.

Diagnostizierbare fehlerhafte Fälle oben führen zu Substitutionsfehler, wenn ranges::reserve_hint(E) im unmittelbaren Kontext einer Template-Instantiierung erscheint.

Customization Point Objects

Der Name ranges::reserve_hint bezeichnet ein Customization Point Object , welches ein konstantes Function Object eines Literal semiregular Klassentyps ist. Weitere Details finden Sie unter CustomizationPointObject .

Hinweise

Immer wenn ranges :: reserve_hint ( e ) für einen Ausdruck e gültig ist, ist der Rückgabetyp integer-like .

Beispiel

Siehe auch