std::saturate_cast

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Numerik-Bibliothek

Allgemeine mathematische Funktionen
Mathematische Spezialfunktionen (C++17)
Mathematische Konstanten (C++20)
Grundlegende lineare Algebra-Algorithmen (C++26)
Datenparallele Typen (SIMD) (C++26)
Gleitkomma-Umgebung (C++11)
Komplexe Zahlen
Numerische Arrays (valarray)
Pseudozufallszahlengenerierung
Bit-Manipulation (C++20)
Faktoroperationen
gcd (C++17)	lcm (C++17)
Interpolationen
midpoint (C++20)	lerp (C++20)
Sättigungsarithmetik
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
Generische numerische Operationen
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

Definiert in der Header-Datei <numeric>
template< class T, class U > constexpr T saturate_cast( U x ) noexcept;		(seit C++26)

Konvertiert den Wert x in einen Wert vom Typ T und klemmt x zwischen dem minimalen und maximalen Wert des Typs T ein.

Das Programm ist schlecht geformt, wenn entweder T oder U kein vorzeichenbehafteter oder vorzeichenloser Ganzzahltyp ist (einschließlich Standard-Ganzzahltyp und erweiterter Ganzzahltyp).

Parameter

x

-

ein Ganzzahlwert

Rückgabewert

• x, wenn x als Wert vom Typ T darstellbar ist. Andernfalls,
• entweder der größte oder kleinste darstellbare Wert vom Typ T, je nachdem, welcher Wert näher an dem Wert von x liegt.

Hinweise

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_saturation_arithmetic	202311L	(C++26)	Sättigungsarithmetik

Mögliche Implementierung

Siehe libstdc++ (GCC).

Beispiel

Kann auf Compiler Explorer in der Vorschau angezeigt werden.

Führen Sie diesen Code aus

#include <cstdint>
#include <limits>
#include <numeric>
 
int main()
{
    constexpr std::int16_t x1{696};
 
    constexpr std::int8_t x2 = std::saturate_cast<std::int8_t>(x1);
    static_assert(x2 == std::numeric_limits<std::int8_t>::max());
 
    constexpr std::uint8_t x3 = std::saturate_cast<std::uint8_t>(x1);
    static_assert(x3 == std::numeric_limits<std::uint8_t>::max());
 
    constexpr std::int16_t y1{-696};
 
    constexpr std::int8_t y2 = std::saturate_cast<std::int8_t>(y1);
    static_assert(y2 == std::numeric_limits<std::int8_t>::min());
 
    constexpr std::uint8_t y3 = std::saturate_cast<std::uint8_t>(y1);
    static_assert(y3 == 0);
}

Siehe auch

bit_cast (C++20)	interpretiert die Objekt-Repräsentation eines Typs als die eines anderen Typs neu (Funktion-Template)
clamp (C++17)	klemmt einen Wert zwischen einem Paar von Grenzwerte (Funktionsvorlage)
in_range (C++20)	prüft, ob ein Ganzzahlwert im Bereich eines gegebenen Ganzzahltyps liegt (Funktionsvorlage)