std::numeric_limits

template< class T > class numeric_limits;

Le std::numeric_limits modèle de classe fournit une méthode standardisée pour interroger diverses propriétés des types arithmétiques (par exemple, la plus grande valeur possible pour le type int est std::numeric_limits<int>::max()).

Cette information est fournie via des spécialisations du modèle std::numeric_limits. La bibliothèque standard met à disposition des spécialisations pour tous les types arithmétiques (liste uniquement les spécialisations pour les types arithmétiques non qualifiés cv) :

template<> class numeric_limits<bool>;

template<> class numeric_limits<char>;

template<> class numeric_limits<signed char>;

template<> class numeric_limits<unsigned char>;

template<> class numeric_limits<wchar_t>;

template<> class numeric_limits<char8_t>;

template<> class numeric_limits<char16_t>;

template<> class numeric_limits<char32_t>;

template<> class numeric_limits<short>;

template<> class numeric_limits<unsigned short>;

template<> class numeric_limits<int>;

template<> class numeric_limits<unsigned int>;

template<> class numeric_limits<long>;

template<> class numeric_limits<unsigned long>;

template<> class numeric_limits<long long>;

template<> class numeric_limits<unsigned long long>;

template<> class numeric_limits<float>;

template<> class numeric_limits<double>;

template<> class numeric_limits<long double>;

La valeur de chaque membre d'une spécialisation de std::numeric_limits sur un type qualifié cv cv T est égale à la valeur du membre correspondant de la spécialisation sur le type non qualifié T. Par exemple, std::numeric_limits<int>::digits est égal à std::numeric_limits<const int>::digits.

Les alias de types arithmétiques (tels que std::size_t ou std::streamsize) peuvent également être examinés avec les traits de type std::numeric_limits.

Les types standard non arithmétiques, tels que std::complex<T> ou std::nullptr_t, n'ont pas de spécialisations.

Les implémentations peuvent fournir des spécialisations de std::numeric_limits pour des types spécifiques à l'implémentation : par exemple, GCC fournit std::numeric_limits<__int128>. Les bibliothèques non standard peuvent ajouter des spécialisations pour les types fournis par la bibliothèque, par exemple, OpenEXR fournit std::numeric_limits<half> pour un type à virgule flottante 16 bits.

Paramètres du modèle

Constantes membres

Fonctions membres

Classes d'assistance

Relation avec les constantes de macro de la bibliothèque C

Exemple

#include <iostream>
#include <limits>
int main() 
{
    std::cout << "type\t│ lowest()\t│ min()\t\t│ max()\n"
              << "bool\t│ "
              << std::numeric_limits<bool>::lowest() << "\t\t│ "
              << std::numeric_limits<bool>::min() << "\t\t│ "
              << std::numeric_limits<bool>::max() << '\n'
              << "uchar\t│ "
              << +std::numeric_limits<unsigned char>::lowest() << "\t\t│ "
              << +std::numeric_limits<unsigned char>::min() << "\t\t│ "
              << +std::numeric_limits<unsigned char>::max() << '\n'
              << "int\t│ "
              << std::numeric_limits<int>::lowest() << "\t│ "
              << std::numeric_limits<int>::min() << "\t│ "
              << std::numeric_limits<int>::max() << '\n'
              << "float\t│ "
              << std::numeric_limits<float>::lowest() << "\t│ "
              << std::numeric_limits<float>::min() << "\t│ "
              << std::numeric_limits<float>::max() << '\n'
              << "double\t│ "
              << std::numeric_limits<double>::lowest() << "\t│ "
              << std::numeric_limits<double>::min() << "\t│ "
              << std::numeric_limits<double>::max() << '\n';
}

type	│ lowest()	│ min()		│ max()
bool	│ 0		│ 0		│ 1
uchar	│ 0		│ 0		│ 255
int	│ -2147483648	│ -2147483648	│ 2147483647
float	│ -3.40282e+38	│ 1.17549e-38	│ 3.40282e+38
double	│ -1.79769e+308	│ 2.22507e-308	│ 1.79769e+308

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi

• Types entiers de largeur fixe
• Types arithmétiques
• Vue d'ensemble du système de types C++
• Support des types (types de base, RTTI, traits de type)
• Interface des limites numériques C