Interface des limites numériques C
Voir aussi std::numeric_limits interface.
Caractéristiques des types entiers
Caractéristiques des types entiers du langage de base | |
Défini dans l'en-tête
<climits> | |
BOOL_WIDTH (C++26) |
largeur en bits de bool (constante macro) |
CHAR_BIT |
largeur en bits d'un octet (constante macro) |
MB_LEN_MAX |
nombre maximal d'octets dans un caractère multi-octets (constante macro) |
CHAR_WIDTH (C++26) |
largeur en bits de char (constante macro) |
CHAR_MIN |
valeur minimale de char (constante macro) |
CHAR_MAX |
valeur maximale de char (constante macro) |
SCHAR_WIDTHSHRT_WIDTHINT_WIDTHLONG_WIDTHLLONG_WIDTH (C++26)(C++26)(C++26)(C++26)(C++26) |
largeur en bits de signed char, short, int, long et long long respectivement (constante macro) |
SCHAR_MINSHRT_MININT_MINLONG_MINLLONG_MIN (C++11) |
valeur minimale de signed char, short, int, long et long long respectivement (constante macro) |
SCHAR_MAXSHRT_MAXINT_MAXLONG_MAXLLONG_MAX (C++11) |
valeur maximale de signed char, short, int, long et long long respectivement (constante macro) |
UCHAR_WIDTHUSHRT_WIDTHUINT_WIDTHULONG_WIDTHULLONG_WIDTH (C++26)(C++26)(C++26)(C++26)(C++26) |
largeur en bits de unsigned char, unsigned short, unsigned int, unsigned long et unsigned long long respectivement (constante macro) |
UCHAR_MAXUSHRT_MAXUINT_MAXULONG_MAXULLONG_MAX (C++11) |
valeur maximale de unsigned char, unsigned short, unsigned int,unsigned long et unsigned long long respectivement (constante macro) |
Défini dans l'en-tête
<cwchar> | |
Défini dans l'en-tête
<cstdint> | |
WCHAR_WIDTH (C++26) |
largeur en bits de wchar_t (constante macro) |
WCHAR_MIN (C++11) |
valeur minimale de wchar_t (constante macro) |
WCHAR_MAX (C++11) |
valeur maximale de wchar_t (constante macro) |
Caractéristiques des alias de types de la bibliothèque | |
Défini dans l'en‑tête
<cstdint> | |
PTRDIFF_WIDTH (C++26) |
largeur en bits de std::ptrdiff_t (constante macro) |
PTRDIFF_MIN (C++11) |
valeur minimale de std::ptrdiff_t (constante macro) |
PTRDIFF_MAX (C++11) |
valeur maximale de std::ptrdiff_t (constante macro) |
SIZE_WIDTH (C++26) |
largeur en bits de std::size_t (constante macro) |
SIZE_MAX (C++11) |
valeur maximale de std::size_t (constante macro) |
SIG_ATOMIC_WIDTH (C++26) |
largeur en bits de std::sig_atomic_t (constante macro) |
SIG_ATOMIC_MIN (C++11) |
valeur minimale de std::sig_atomic_t (constante macro) |
SIG_ATOMIC_MAX (C++11) |
valeur maximale de std::sig_atomic_t (constante macro) |
WINT_WIDTH (C++26) |
largeur en bits de std::wint_t (constante macro) |
WINT_MIN (C++11) |
valeur minimale de std::wint_t (constante macro) |
WINT_MAX (C++11) |
valeur maximale de std::wint_t (constante macro) |
Exigences de valeur
|
|
(depuis C++26) |
Chacune des *_WIDTH macros (autres que BOOL_WIDTH),(depuis C++26) CHAR_BIT et MB_LEN_MAX se développe en une valeur définie par l'implémentation. Les valeurs minimales autorisées sont listées ci-dessous, où chaque groupe de macros séparé par / se développe toujours en la même valeur :
- au moins
1:MB_LEN_MAX - au moins
8:CHAR_BIT/CHAR_WIDTH/SCHAR_WIDTH/UCHAR_WIDTH,WCHAR_WIDTH,SIG_ATOMIC_WIDTH - au moins
16:SHRT_WIDTH/USHRT_WIDTH,INT_WIDTH/UINT_WIDTH,PTRDIFF_WIDTH,SIZE_WIDTH,WINT_WIDTH - au moins
32:LONG_WIDTH/ULONG_WIDTH - au moins
64:LLONG_WIDTH/ULLONG_WIDTH
Notes
Les types de ces constantes, à l'exception de CHAR_BIT et MB_LEN_MAX , doivent correspondre aux résultats des promotions entières telles qu'appliquées aux objets des types qu'elles décrivent : CHAR_MAX peut avoir le type int ou unsigned int , mais jamais char . De même, USHRT_MAX ne peut pas être d'un type non signé : son type peut être int .
Une
implémentation autonome
peut ne pas disposer des noms de typedef
std::sig_atomic_t
et/ou
std::wint_t
, auquel cas les macros
SIG_ATOMIC_*
et/ou
WINT_*
sont respectivement absentes.
Exemple
#include <climits>
#include <cstdint>
#include <iomanip>
#include <iostream>
#include <locale>
int main()
{
constexpr int w = 14;
(std::cout << std::left).imbue(std::locale("en_US.UTF-8"));
# define COUT(x) std::cout << std::setw(w) << #x << " = " << x << '\n'
COUT( BOOL_WIDTH );
COUT( CHAR_BIT );
COUT( CHAR_MAX );
COUT( CHAR_MIN );
COUT( CHAR_WIDTH );
COUT( INT_MAX );
COUT( INT_MIN );
COUT( INT_WIDTH );
COUT( LLONG_MAX );
COUT( LLONG_MIN );
COUT( LLONG_WIDTH );
COUT( LONG_MAX );
COUT( LONG_MIN );
COUT( LONG_WIDTH );
COUT( MB_LEN_MAX );
COUT( PTRDIFF_MAX );
COUT( PTRDIFF_MIN );
COUT( SCHAR_MAX );
COUT( SCHAR_MIN );
COUT( SCHAR_WIDTH );
COUT( SHRT_MAX );
COUT( SHRT_MIN );
COUT( SHRT_WIDTH );
COUT( SIG_ATOMIC_MAX );
COUT( SIG_ATOMIC_MIN );
COUT( SIZE_MAX );
COUT( UCHAR_MAX );
COUT( UCHAR_WIDTH );
COUT( UINT_MAX );
COUT( UINT_WIDTH );
COUT( ULLONG_MAX );
COUT( ULLONG_WIDTH );
COUT( ULONG_MAX );
COUT( ULONG_WIDTH );
COUT( USHRT_MAX );
COUT( USHRT_WIDTH );
COUT( WCHAR_MAX );
COUT( WCHAR_MIN );
COUT( WINT_MAX );
COUT( WINT_MIN );
}
Sortie possible :
BOOL_WIDTH = 1
CHAR_BIT = 8
CHAR_MAX = 127
CHAR_MIN = -128
CHAR_WIDTH = 8
INT_MAX = 2,147,483,647
INT_MIN = -2,147,483,648
INT_WIDTH = 32
LLONG_MAX = 9,223,372,036,854,775,807
LLONG_MIN = -9,223,372,036,854,775,808
LLONG_WIDTH = 64
LONG_MAX = 9,223,372,036,854,775,807
LONG_MIN = -9,223,372,036,854,775,808
LONG_WIDTH = 64
MB_LEN_MAX = 16
PTRDIFF_MAX = 9,223,372,036,854,775,807
PTRDIFF_MIN = -9,223,372,036,854,775,808
SCHAR_MAX = 127
SCHAR_MIN = -128
SCHAR_WIDTH = 8
SHRT_MAX = 32,767
SHRT_MIN = -32,768
SHRT_WIDTH = 16
SIG_ATOMIC_MAX = 2,147,483,647
SIG_ATOMIC_MIN = -2,147,483,648
SIZE_MAX = 18,446,744,073,709,551,615
UCHAR_MAX = 255
UCHAR_WIDTH = 8
UINT_MAX = 4,294,967,295
UINT_WIDTH = 32
ULLONG_MAX = 18,446,744,073,709,551,615
ULLONG_WIDTH = 64
ULONG_MAX = 18,446,744,073,709,551,615
ULONG_WIDTH = 64
USHRT_MAX = 65,535
USHRT_WIDTH = 16
WCHAR_MAX = 2,147,483,647
WCHAR_MIN = -2,147,483,648
WINT_MAX = 4,294,967,295
WINT_MIN = 0
Caractéristiques et valeurs spéciales des types à virgule flottante
Caractéristiques des types à virgule flottante | |
Défini dans l'en-tête
<cfloat> | |
| mode d'arrondi par défaut de l'arithmétique à virgule flottante (constante macro) | |
(C++11) |
spécifie avec quelle précision toutes les opérations arithmétiques sont effectuées (constante macro) |
FLT_HAS_SUBNORMDBL_HAS_SUBNORMLDBL_HAS_SUBNORM (C++17)(obsolète en C++26) |
spécifie si le type prend en charge les nombres sous-normaux (dénormaux) : -1 – indéterminable, 0 – absent, 1 – présent (constante macro) |
FLT_RADIX |
la base (base entière) utilisée par la représentation des trois types à virgule flottante (constante macro) |
FLT_MANT_DIGDBL_MANT_DIGLDBL_MANT_DIG |
nombre de chiffres en base FLT_RADIX pouvant être représentés sans perte de précision pour float, double et long double respectivement (constante macro) |
FLT_DECIMAL_DIGDBL_DECIMAL_DIGLDBL_DECIMAL_DIG (C++17) |
conversion de float/double/long double en décimal avec au moins FLT_DECIMAL_DIG/DBL_DECIMAL_DIG/LDBL_DECIMAL_DIG chiffres et inversement est la conversion identité : c'est la précision décimale nécessaire pour sérialiser/désérialiser une valeur à virgule flottante (constante macro) |
DECIMAL_DIG (C++11)(obsolète en C++26) |
conversion de long double en décimal avec au moins DECIMAL_DIG chiffres et inversement en long double est la conversion identité : c'est la précision décimale nécessaire pour sérialiser/désérialiser un long double (constante macro) |
FLT_DIGDBL_DIGLDBL_DIG |
nombre de chiffres décimaux garantis d'être préservés lors d'un aller-retour texte → float/double/long double → texte sans changement dû à l'arrondi ou au débordement (constante macro) |
FLT_MIN_EXPDBL_MIN_EXPLDBL_MIN_EXP |
plus petit entier négatif tel que FLT_RADIX élevé à la puissance un de moins que cet entier soit un float, double et long double normalisé respectivement (constante macro) |
FLT_MIN_10_EXPDBL_MIN_10_EXPLDBL_MIN_10_EXP |
plus petit entier négatif tel que 10 élevé à cette puissance soit un float, double et long double normalisé respectivement (constante macro) |
FLT_MAX_EXPDBL_MAX_EXPLDBL_MAX_EXP |
plus grand entier positif tel que FLT_RADIX élevé à la puissance un de moins que cet entier soit un float, double et long double fini représentable respectivement (constante macro) |
FLT_MAX_10_EXPDBL_MAX_10_EXPLDBL_MAX_10_EXP |
plus grand entier positif tel que 10 élevé à cette puissance soit un float, double et long double fini représentable respectivement (constante macro) |
FLT_MAXDBL_MAXLDBL_MAX |
valeur finie maximale de float, double et long double respectivement (constante macro) |
FLT_EPSILONDBL_EPSILONLDBL_EPSILON |
différence entre 1.0 et la valeur représentable suivante pour float, double et long double respectivement (constante macro) |
FLT_MINDBL_MINLDBL_MIN |
valeur positive normalisée minimale de float, double et long double respectivement (constante macro) |
FLT_TRUE_MINDBL_TRUE_MINLDBL_TRUE_MIN (C++17) |
valeur positive minimale de float, double et long double respectivement (constante macro) |
Valeurs spéciales des types à virgule flottante | |
Défini dans l'en-tête
<cmath> (obsolète en C++26) | |
Défini dans l'en-tête
<cfloat> (depuis C++26) | |
(C++11) |
évalue à l'infini positif (s'il existe) (constante macro) |
(C++11) |
évalue à un NaN silencieux de type float (s'il existe) (constante macro) |
Défini dans l'en-tête
<cfloat> | |
(C++26) |
évalue à un NaN signalant de float, double et long double respectivement (s'il existe) (constante macro) |
Exemple
#include <cfloat>
#include <iomanip>
#include <iostream>
int main()
{
int w = 16;
std::cout << std::left; // std::cout << std::setprecision(53);
# define COUT(x) std::cout << std::setw(w) << #x << " = " << x << '\n'
COUT( FLT_RADIX );
COUT( DECIMAL_DIG );
COUT( FLT_DECIMAL_DIG );
COUT( DBL_DECIMAL_DIG );
COUT( LDBL_DECIMAL_DIG );
COUT( FLT_MIN );
COUT( DBL_MIN );
COUT( LDBL_MIN );
COUT( FLT_TRUE_MIN );
COUT( DBL_TRUE_MIN );
COUT( LDBL_TRUE_MIN );
COUT( FLT_MAX );
COUT( DBL_MAX );
COUT( LDBL_MAX );
COUT( FLT_EPSILON );
COUT( DBL_EPSILON );
COUT( LDBL_EPSILON );
COUT( FLT_DIG );
COUT( DBL_DIG );
COUT( LDBL_DIG );
COUT( FLT_MANT_DIG );
COUT( DBL_MANT_DIG );
COUT( LDBL_MANT_DIG );
COUT( FLT_MIN_EXP );
COUT( DBL_MIN_EXP );
COUT( LDBL_MIN_EXP );
COUT( FLT_MIN_10_EXP );
COUT( DBL_MIN_10_EXP );
COUT( LDBL_MIN_10_EXP );
COUT( FLT_MAX_EXP );
COUT( DBL_MAX_EXP );
COUT( LDBL_MAX_EXP );
COUT( FLT_MAX_10_EXP );
COUT( DBL_MAX_10_EXP );
COUT( LDBL_MAX_10_EXP );
COUT( FLT_ROUNDS );
COUT( FLT_EVAL_METHOD );
COUT( FLT_HAS_SUBNORM );
COUT( DBL_HAS_SUBNORM );
COUT( LDBL_HAS_SUBNORM );
}Sortie possible :
FLT_RADIX = 2
DECIMAL_DIG = 21
FLT_DECIMAL_DIG = 9
DBL_DECIMAL_DIG = 17
LDBL_DECIMAL_DIG = 21
FLT_MIN = 1.17549e-38
DBL_MIN = 2.22507e-308
LDBL_MIN = 3.3621e-4932
FLT_TRUE_MIN = 1.4013e-45
DBL_TRUE_MIN = 4.94066e-324
LDBL_TRUE_MIN = 3.6452e-4951
FLT_MAX = 3.40282e+38
DBL_MAX = 1.79769e+308
LDBL_MAX = 1.18973e+4932
FLT_EPSILON = 1.19209e-07
DBL_EPSILON = 2.22045e-16
LDBL_EPSILON = 1.0842e-19
FLT_DIG = 6
DBL_DIG = 15
LDBL_DIG = 18
FLT_MANT_DIG = 24
DBL_MANT_DIG = 53
LDBL_MANT_DIG = 64
FLT_MIN_EXP = -125
DBL_MIN_EXP = -1021
LDBL_MIN_EXP = -16381
FLT_MIN_10_EXP = -37
DBL_MIN_10_EXP = -307
LDBL_MIN_10_EXP = -4931
FLT_MAX_EXP = 128
DBL_MAX_EXP = 1024
LDBL_MAX_EXP = 16384
FLT_MAX_10_EXP = 38
DBL_MAX_10_EXP = 308
LDBL_MAX_10_EXP = 4932
FLT_ROUNDS = 1
FLT_EVAL_METHOD = 0
FLT_HAS_SUBNORM = 1
DBL_HAS_SUBNORM = 1
LDBL_HAS_SUBNORM = 1Rapports 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.
| DR | Applicable à | Comportement publié | Comportement corrigé |
|---|---|---|---|
| LWG 416 | C++98 |
il n'était pas clair si les types des macros dans
<climits>
sont garantis
de correspondre au type auquel elles se réfèrent (C++ fait référence à C, et C dit non) |
clarifié comme non
garanti |
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)
|
Documentation C
pour
Limites numériques
|