Interfaz de límites numéricos de C
Véase también std::numeric_limits.
Características de los tipos enteros
Características de los tipos enteros del lenguaje central | |
Definido en el encabezado
<climits> | |
BOOL_WIDTH (C++26) |
ancho en bits de bool (constante de macro) |
CHAR_BIT |
ancho en bits de un byte (constante de macro) |
MB_LEN_MAX |
número máximo de bytes en un carácter multibyte (constante de macro) |
CHAR_WIDTH (C++26) |
ancho en bits de char (constante de macro) |
CHAR_MIN |
valor mínimo de char (constante de macro) |
CHAR_MAX |
valor máximo de char (constante de macro) |
SCHAR_WIDTHSHRT_WIDTHINT_WIDTHLONG_WIDTHLLONG_WIDTH (C++26)(C++26)(C++26)(C++26)(C++26) |
ancho en bits de signed char, short, int, long y long long respectivamente (constante de macro) |
SCHAR_MINSHRT_MININT_MINLONG_MINLLONG_MIN (C++11) |
valor mínimo de signed char, short, int, long y long long respectivamente (constante de macro) |
SCHAR_MAXSHRT_MAXINT_MAXLONG_MAXLLONG_MAX (C++11) |
valor máximo de signed char, short, int, long y long long respectivamente (constante de macro) |
UCHAR_WIDTHUSHRT_WIDTHUINT_WIDTHULONG_WIDTHULLONG_WIDTH (C++26)(C++26)(C++26)(C++26)(C++26) |
ancho en bits de unsigned char, unsigned short, unsigned int, unsigned long y unsigned long long respectivamente (constante de macro) |
UCHAR_MAXUSHRT_MAXUINT_MAXULONG_MAXULLONG_MAX (C++11) |
valor máximo de unsigned char, unsigned short, unsigned int, unsigned long y unsigned long long respectivamente (constante de macro) |
Definido en el encabezado
<cwchar> | |
Definido en el encabezado
<cstdint> | |
WCHAR_WIDTH (C++26) |
ancho en bits de wchar_t (constante de macro) |
WCHAR_MIN (C++11) |
valor mínimo de wchar_t (constante de macro) |
WCHAR_MAX (C++11) |
valor máximo de wchar_t (constante de macro) |
Características de los alias de tipos de la biblioteca | |
Definido en el encabezado
<cstdint> | |
PTRDIFF_WIDTH (C++26) |
ancho en bits de std::ptrdiff_t (macro constante) |
PTRDIFF_MIN (C++11) |
valor mínimo de std::ptrdiff_t (macro constante) |
PTRDIFF_MAX (C++11) |
valor máximo de std::ptrdiff_t (macro constante) |
SIZE_WIDTH (C++26) |
ancho en bits de std::size_t (macro constante) |
SIZE_MAX (C++11) |
valor máximo de std::size_t (macro constante) |
SIG_ATOMIC_WIDTH (C++26) |
ancho en bits de std::sig_atomic_t (macro constante) |
SIG_ATOMIC_MIN (C++11) |
valor mínimo de std::sig_atomic_t (macro constante) |
SIG_ATOMIC_MAX (C++11) |
valor máximo de std::sig_atomic_t (macro constante) |
WINT_WIDTH (C++26) |
ancho en bits de std::wint_t (macro constante) |
WINT_MIN (C++11) |
valor mínimo de std::wint_t (macro constante) |
WINT_MAX (C++11) |
valor máximo de std::wint_t (macro constante) |
Requisitos de valor
|
|
(desde C++26) |
Cada uno de las *_WIDTH macros (excepto BOOL_WIDTH),(desde C++26) CHAR_BIT y MB_LEN_MAX se expande a un valor definido por la implementación. Los valores mínimos permitidos se enumeran a continuación, donde cada grupo de macros separado por / siempre se expande al mismo valor:
- al menos
1:MB_LEN_MAX - al menos
8:CHAR_BIT/CHAR_WIDTH/SCHAR_WIDTH/UCHAR_WIDTH,WCHAR_WIDTH,SIG_ATOMIC_WIDTH - al menos
16:SHRT_WIDTH/USHRT_WIDTH,INT_WIDTH/UINT_WIDTH,PTRDIFF_WIDTH,SIZE_WIDTH,WINT_WIDTH - al menos
32:LONG_WIDTH/ULONG_WIDTH - al menos
64:LLONG_WIDTH/ULLONG_WIDTH
Notas
Los tipos de estas constantes, excepto CHAR_BIT y MB_LEN_MAX , deben coincidir con los resultados de las promociones integrales aplicadas a objetos de los tipos que describen: CHAR_MAX puede tener tipo int o unsigned int , pero nunca char . Similarmente, USHRT_MAX no puede ser de un tipo sin signo: su tipo puede ser int .
Una
implementación independiente
puede carecer de los
typedef names std::sig_atomic_t
y/o
std::wint_t
, en cuyo caso las macros
SIG_ATOMIC_*
y/o
WINT_*
están correspondientemente ausentes.
Ejemplo
#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 );
}
Salida posible:
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
Características y valores especiales de los tipos de punto flotante
Características de los tipos de punto flotante | |
Definido en el encabezado
<cfloat> | |
| modo de redondeo predeterminado de la aritmética de punto flotante (constante de macro) | |
(C++11) |
especifica con qué precisión se realizan todas las operaciones aritméticas (constante de macro) |
FLT_HAS_SUBNORMDBL_HAS_SUBNORMLDBL_HAS_SUBNORM (C++17)(obsoleto en C++26) |
especifica si el tipo admite números subnormales (desnormalizados):-1 – indeterminable, 0 – ausente, 1 – presente (constante de macro) |
FLT_RADIX |
la base (base entera) utilizada por la representación de los tres tipos de punto flotante (constante de macro) |
FLT_MANT_DIGDBL_MANT_DIGLDBL_MANT_DIG |
número de dígitos en base FLT_RADIX que se pueden representar sin perder precisión para float, double y long double respectivamente (constante de macro) |
FLT_DECIMAL_DIGDBL_DECIMAL_DIGLDBL_DECIMAL_DIG (C++17) |
la conversión de float/double/long double a decimal con al menos FLT_DECIMAL_DIG/DBL_DECIMAL_DIG/LDBL_DECIMAL_DIG dígitos y viceversa es la conversión identidad: esta es la precisión decimal necesaria para serializar/deserializar un valor de punto flotante (constante de macro) |
DECIMAL_DIG (C++11)(obsoleto en C++26) |
la conversión de long double a decimal con al menos DECIMAL_DIG dígitos y viceversa a long double es la conversión identidad: esta es la precisión decimal necesaria para serializar/deserializar un long double (constante de macro) |
FLT_DIGDBL_DIGLDBL_DIG |
número de dígitos decimales que se garantiza que se conservan en un viaje de ida y vuelta texto → float/double/long double → texto sin cambios debido a redondeo o desbordamiento (constante de macro) |
FLT_MIN_EXPDBL_MIN_EXPLDBL_MIN_EXP |
entero negativo mínimo tal que FLT_RADIX elevado a la potencia uno menos que ese entero es un float, double y long double normalizados respectivamente (constante de macro) |
FLT_MIN_10_EXPDBL_MIN_10_EXPLDBL_MIN_10_EXP |
entero negativo mínimo tal que 10 elevado a esa potencia es un float, double y long double normalizados respectivamente (constante de macro) |
FLT_MAX_EXPDBL_MAX_EXPLDBL_MAX_EXP |
entero positivo máximo tal que FLT_RADIX elevado a la potencia uno menos que ese entero es un float, double y long double finitos representables respectivamente (constante de macro) |
FLT_MAX_10_EXPDBL_MAX_10_EXPLDBL_MAX_10_EXP |
entero positivo máximo tal que 10 elevado a esa potencia es un float, double y long double finitos representables respectivamente (constante de macro) |
FLT_MAXDBL_MAXLDBL_MAX |
valor finito máximo de float, double y long double respectivamente (constante de macro) |
FLT_EPSILONDBL_EPSILONLDBL_EPSILON |
diferencia entre 1.0 y el siguiente valor representable para float, double y long double respectivamente (constante de macro) |
FLT_MINDBL_MINLDBL_MIN |
valor positivo normalizado mínimo de float, double y long double respectivamente (constante de macro) |
FLT_TRUE_MINDBL_TRUE_MINLDBL_TRUE_MIN (C++17) |
valor positivo mínimo de float, double y long double respectivamente (constante de macro) |
Valores especiales de los tipos de punto flotante | |
Definido en el encabezado
<cmath> (obsoleto en C++26) | |
Definido en el encabezado
<cfloat> (desde C++26) | |
(C++11) |
se evalúa como infinito positivo (si existe) (constante de macro) |
(C++11) |
se evalúa como un NaN silencioso de tipo float (si existe) (constante de macro) |
Definido en el encabezado
<cfloat> | |
(C++26) |
se evalúa como un NaN de señalización de float, double y long double respectivamente (si existe) (constante de macro) |
Ejemplo
#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 );
}Posible salida:
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 = 1Informes de defectos
Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.
| DR | Aplicado a | Comportamiento publicado | Comportamiento correcto |
|---|---|---|---|
| LWG 416 | C++98 |
no estaba claro si los tipos de las macros en
<climits>
están garantizados
para coincidir con el tipo al que se refieren (C++ se refiere a C, y C dice que no) |
aclarado como no
garantizado |
Véase también
- Tipos de enteros de ancho fijo
- Tipos aritméticos
- Resumen del sistema de tipos de C++
- Soporte de tipos (tipos básicos, RTTI, rasgos de tipo)
|
Documentación de C
para
Límites numéricos
|