std:: numeric_limits

From cppreference.net

Определено в заголовочном файле `<limits>`
template < class T > class numeric_limits ;

Класс-шаблон std::numeric_limits предоставляет стандартизированный способ запроса различных свойств арифметических типов (например, наибольшее возможное значение для типа int это std :: numeric_limits < int > :: max ( ) ).

Эта информация предоставляется через специализации шаблона std::numeric_limits . Стандартная библиотека предоставляет специализации для всех арифметических типов (приведены только специализации для cv-неквалифицированных арифметических типов):

**Примечание:** В данном фрагменте нет текста для перевода - все содержимое состоит из HTML-тегов, атрибутов и C++ кода внутри тегов ` `, которые согласно инструкциям не подлежат переводу. **Примечание:** Весь текст в данном HTML-фрагменте находится внутри тегов ` `, которые содержат C++ код. Согласно инструкциям, код C++ не переводится, включая ключевые слова (`template`, `class`, `unsigned`, `char`) и имена классов (`numeric_limits`). Поэтому перевод не требуется, исходный код сохранен без изменений. **Примечание:** Весь текст в данном фрагменте находится внутри тегов ` `, которые относятся к подсветке синтаксиса C++ кода. Согласно инструкциям, код C++ не переводится, включая ключевые слова (`template`, `class`), типы данных (`wchar_t`) и имена шаблонов (`numeric_limits`). Поэтому перевод не требуется, исходный код сохранен без изменений. **Примечание:** В данном фрагменте нет текста для перевода - все содержимое состоит из HTML-тегов, атрибутов и C++ кода внутри тегов ` `, которые согласно инструкциям не подлежат переводу. **Примечание:** Весь текст в данном фрагменте HTML состоит из C++ кода и HTML тегов, которые согласно инструкциям не подлежат переводу. Специфические термины C++ (`template`, `class`, `numeric_limits`, `unsigned short`) сохраняются в оригинале, как и HTML структура. **Примечание:** В данном фрагменте HTML-кода весь текст внутри тегов ` ` представляет собой C++ код, который согласно инструкциям не подлежит переводу. HTML-теги и атрибуты также сохранены в оригинальном виде. **Примечание:** В данном фрагменте HTML не содержится переводимого текста - только HTML-теги, атрибуты и C++ код, которые согласно инструкциям не подлежат переводу. Весь контент внутри тегов ` ` представляет собой C++ код, который должен оставаться без изменений. **Примечание:** В данном фрагменте HTML-кода весь текст внутри тегов ` ` представляет собой C++ код, который согласно инструкциям не подлежит переводу. HTML-теги и атрибуты также сохранены в оригинальном виде. **Примечание:** В данном фрагменте HTML-кода отсутствует переводимый текст - все содержимое состоит из HTML-тегов, атрибутов и C++ кода внутри тегов ` `, которые согласно инструкциям не подлежат переводу. **Примечание:** В данном фрагменте кода не содержится переводимого текста - только HTML-теги, атрибуты и C++ код, которые согласно инструкциям не подлежат переводу. Весь представленный контент сохранен в оригинальном виде. (Примечание: В данном фрагменте HTML отсутствует текстовое содержимое для перевода - присутствуют только HTML-теги и атрибуты, которые согласно инструкциям не подлежат переводу)

Определено в заголовочном файле `<limits>`
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 > ;		(начиная с C++20)
template <> class numeric_limits < char16_t > ;		(начиная с C++11)
template <> class numeric_limits < char32_t > ;		(начиная с C++11)
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 > ;		(начиная с C++11)
template <> class numeric_limits < unsigned long long > ;		(начиная с C++11)
template <> class numeric_limits < float > ;
template <> class numeric_limits < double > ;
template <> class numeric_limits < long double > ;

Значение каждого члена специализации std::numeric_limits для cv-квалифицированного типа cv T равно значению соответствующего члена специализации для неквалифицированного типа T . Например, std :: numeric_limits < int > :: digits равно std :: numeric_limits < const int > :: digits .

Псевдонимы арифметических типов (такие как std::size_t или std::streamsize ) также могут быть исследованы с помощью std::numeric_limits type traits.

Неарифметические стандартные типы, такие как std:: complex < T > или std::nullptr_t , не имеют специализаций.

Если реализация определяет какие-либо integer-class types , специализации std::numeric_limits также должны быть предоставлены для них.

(since C++20)

Реализации могут предоставлять специализации std::numeric_limits для специфичных для реализации типов: например, GCC предоставляет std::numeric_limits<__int128> . Нестандартные библиотеки могут добавлять специализации для предоставляемых библиотекой типов, например, OpenEXR предоставляет std::numeric_limits<half> для 16-битного типа с плавающей запятой.

Содержание

Параметры шаблона

тип, для которого извлекаются числовые свойства

Константы-члены

is_specialized [static]	идентифицирует типы, для которых std::numeric_limits специализирован (публичная статическая константа-член)
is_signed [static]	идентифицирует знаковые типы (публичная статическая константа-член)
is_integer [static]	идентифицирует целочисленные типы (публичная статическая константа-член)
is_exact [static]	идентифицирует точные типы (публичная статическая константа-член)
has_infinity [static]	идентифицирует типы с плавающей запятой, которые могут представлять специальное значение "положительная бесконечность" (public static member constant)
has_quiet_NaN [static]	идентифицирует типы с плавающей запятой, которые могут представлять специальное значение "тихий не-число" (NaN) (публичная статическая константа-член)
has_signaling_NaN [static]	идентифицирует типы с плавающей запятой, которые могут представлять специальное значение "сигнализирующий не-число" (NaN) (публичная статическая константа-член)
has_denorm [static]	идентифицирует стиль денормализации, используемый типом с плавающей запятой (публичная статическая константа-член)
has_denorm_loss [static]	идентифицирует типы с плавающей запятой, которые обнаруживают потерю точности как потерю денормализации, а не как неточный результат (public static member constant)
round_style [static]	идентифицирует стиль округления, используемый типом (публичная статическая константа-член)
is_iec559 [static]	идентифицирует типы с плавающей запятой IEC 559/IEEE 754 (public static member constant)
is_bounded [static]	идентифицирует типы, которые представляют конечное множество значений (публичная статическая константа-член)
is_modulo [static]	идентифицирует типы, которые обрабатывают переполнения с помощью модульной арифметики (public static member constant)
digits [static]	количество `radix` цифр, которые могут быть представлены без изменения (публичная статическая константа-член)
digits10 [static]	количество десятичных цифр, которые могут быть представлены без изменения (публичная статическая константа-член)
max_digits10 [static] (C++11)	количество десятичных цифр, необходимое для различения всех значений данного типа (публичная статическая константа-член)
radix [static]	основание системы счисления, используемое для представления данного типа (публичная статическая константа-член)
min_exponent [static]	на единицу больше наименьшей отрицательной степени основания системы счисления, которая является допустимым нормализованным значением с плавающей запятой (публичная статическая константа-член)
min_exponent10 [static]	наименьшая отрицательная степень десяти, которая является допустимым нормализованным значением с плавающей точкой (публичная статическая константа-член)
max_exponent [static]	на единицу больше наибольшей целой степени основания системы счисления, которая является допустимым конечным значением с плавающей точкой (публичная статическая константа-член)
max_exponent10 [static]	наибольшая целочисленная степень 10, которая является допустимым конечным значением с плавающей точкой (публичная статическая константа-член)
traps [static]	идентифицирует типы, которые могут вызывать прерывание арифметических операций (public static member constant)
tinyness_before [static]	идентифицирует типы с плавающей точкой, которые обнаруживают потерю точности до округления (публичная статическая константа-член)

Функции-члены

min [static]	возвращает наименьшее конечное значение для заданного не-вещественного типа или наименьшее положительное нормализованное значение для заданного вещественного типа (public static member function)
lowest [static] (C++11)	возвращает наименьшее конечное значение для заданного типа, т.е. наиболее отрицательное значение для знаковых типов, 0 для беззнаковых типов (public static member function)
max [static]	возвращает наибольшее конечное значение для заданного типа (public static member function)
epsilon [static]	возвращает разницу между `1.0` и следующим представимым значением для заданного вещественного типа (public static member function)
round_error [static]	возвращает максимальную ошибку округления для заданного вещественного типа (public static member function)
infinity [static]	возвращает значение положительной бесконечности для заданного вещественного типа (public static member function)
quiet_NaN [static]	возвращает тихий NaN для заданного вещественного типа (public static member function)
signaling_NaN [static]	возвращает сигнальный NaN для заданного вещественного типа (public static member function)
denorm_min [static]	возвращает наименьшее положительное денормализованное значение для заданного вещественного типа (public static member function)

Вспомогательные классы

float_round_style	указывает режимы округления чисел с плавающей точкой (enum)
float_denorm_style	указывает режимы денормализации чисел с плавающей точкой (enum)

Связь с макроконстантами библиотеки C

**Примечание:** В данном фрагменте HTML весь текст уже находится внутри тегов ` `, которые содержат код на C++. Согласно вашим инструкциям, текст внутри таких тегов не подлежит переводу, так как это C++ специфические термины и ключевые слова языка. Поэтому перевод не требуется, исходный код сохранен без изменений. **Примечание:** В данном фрагменте HTML не содержится переводимого текста, так как: - Все элементы внутри тегов ` ` являются C++ ключевыми словами и терминами, которые не подлежат переводу - Остальной текст представляет собой макросы C++ (`SCHAR_MIN`, `SCHAR_MAX`) и числовые значения - HTML-теги и атрибуты сохранены без изменений **Примечание:** В данном HTML-фрагменте весь текст уже находится внутри тегов `


        `, `
        ` или является C++ специфическими терминами (`wchar_t`, `WCHAR_MIN`, `WCHAR_MAX`), поэтому перевод не требуется согласно указанным правилам. Форматирование и структура полностью сохранены.

**Примечание:** В данном HTML-фрагменте нет текста для перевода, требующего локализации на русский язык. Все элементы содержат либо: - HTML-теги и атрибуты (не подлежат переводу) - Код C++ (`char8_t`, `UCHAR_MAX`) и числовые значения (не подлежат переводу) - Специальные символы (неразрывные пробелы ``) Форматирование и структура полностью сохранены в соответствии с требованиями. **Примечание:** В данном HTML-фрагменте нет текста для перевода, который требовал бы локализации на русский язык. Все содержимое состоит из: - HTML-тегов и атрибутов (не подлежат переводу) - C++ ключевых слов и терминов (`char16_t`, `UINT_LEAST16_MAX` - не подлежат переводу) - Числовых значений (0, 2 - не требуют перевода) - Специальных символов ( - неразрывные пробелы) Форматирование и структура HTML полностью сохранены в соответствии с требованиями. **Примечание:** В данном HTML-фрагменте нет текста для перевода, так как: - `char32_t` и `UINT_LEAST32_MAX` являются терминами C++ и не подлежат переводу - Остальное содержимое состоит из HTML-тегов, атрибутов и числовых значений - Внутри тегов ` ` содержатся только технические элементы языка C++ **Примечание:** В данном HTML-фрагменте отсутствует текст для перевода на русский язык. Все содержимое состоит из: - HTML-тегов и атрибутов (не подлежат переводу) - C++ ключевых слов и идентификаторов (`short`, `SHRT_MIN`, `SHRT_MAX` - не подлежат переводу) - Числовых значений (`2` - не требует перевода) - Тегов `


        ` и `
        
         ` с классами, указывающими на код
Структура полностью сохранена в оригинальном формате.

**Примечание:** В данном фрагменте HTML не содержится переводимого текста, так как: - `int`, `INT_MIN`, `INT_MAX` - это термины C++, которые не подлежат переводу согласно требованиям - Число `2` находится внутри тега ` `, что классифицирует его как код - Все остальные элементы являются HTML-тегами и атрибутами, которые должны сохраняться без изменений **Примечание:** В данном фрагменте HTML все текстовые элементы уже являются техническими терминами C++ (unsigned, int, UINT_MAX) или числовыми значениями (0, 2), которые не подлежат переводу согласно вашим требованиям. HTML-теги и атрибуты сохранены в оригинальном виде. **Примечание:** В данном фрагменте HTML не содержится переводимого текста, так как: - `long` является C++ ключевым словом (не переводится) - `LONG_MIN`, `LONG_MAX` - это C++ макросы (не переводятся) - `2` - числовое значение (не переводится) - Весь остальной текст находится внутри HTML тегов и атрибутов **Примечание:** В данном фрагменте HTML не содержится переводимого текста, так как: - `long long` является C++ специфическим термином и не переводится - `LLONG_MIN`, `LLONG_MAX` - это макросы C++ и сохраняются без изменений - Число `2` является числовым значением и не требует перевода - Весь текст находится внутри тегов ` ` и ` `, которые считаются аналогичными `


          ` тегам для целей перевода

**Примечание:** В данном фрагменте HTML весь текст уже находится внутри тегов `


        `, `
        ` или является C++ специфическими терминами, поэтому перевод не требуется. Весь контент сохранен в оригинальном виде в соответствии с инструкциями.

Специализация `std::numeric_limits<T>` где `T` является	Члены
Специализация `std::numeric_limits<T>` где `T` является	`min()`	`lowest()` (C++11)	`max()`	`radix`
bool	false	false	true	2
char	CHAR_MIN	CHAR_MIN	CHAR_MAX	2
signed char	SCHAR_MIN	SCHAR_MIN	SCHAR_MAX	2
unsigned char	0	0	UCHAR_MAX	2
wchar_t	WCHAR_MIN	WCHAR_MIN	WCHAR_MAX	2
char8_t	0	0	UCHAR_MAX	2
char16_t	0	0	UINT_LEAST16_MAX	2
char32_t	0	0	UINT_LEAST32_MAX	2
short	SHRT_MIN	SHRT_MIN	SHRT_MAX	2
signed short	SHRT_MIN	SHRT_MIN	SHRT_MAX	2
unsigned short	0	0	USHRT_MAX	2
int	INT_MIN	INT_MIN	INT_MAX	2
signed int	INT_MIN	INT_MIN	INT_MAX	2
unsigned int	0	0	UINT_MAX	2
long	LONG_MIN	LONG_MIN	LONG_MAX	2
signed long	LONG_MIN	LONG_MIN	LONG_MAX	2
unsigned long	0	0	ULONG_MAX	2
long long	LLONG_MIN	LLONG_MIN	LLONG_MAX	2
signed long long	LLONG_MIN	LLONG_MIN	LLONG_MAX	2
unsigned long long	0	0	ULLONG_MAX	2

Специализация `std::numeric_limits<T>` где `T` это	Члены
Специализация `std::numeric_limits<T>` где `T` это	`denorm_min()`	`min()`	`lowest()` (C++11)	`max()`	`epsilon()`	`digits`	`digits10`
float	FLT_TRUE_MIN	FLT_MIN	- FLT_MAX	FLT_MAX	FLT_EPSILON	FLT_MANT_DIG	FLT_DIG
double	DBL_TRUE_MIN	DBL_MIN	- DBL_MAX	DBL_MAX	DBL_EPSILON	DBL_MANT_DIG	DBL_DIG
long double	LDBL_TRUE_MIN	LDBL_MIN	- LDBL_MAX	LDBL_MAX	LDBL_EPSILON	LDBL_MANT_DIG	LDBL_DIG

Специализация `std::numeric_limits<T>` где `T` это	Члены (продолжение)
Специализация `std::numeric_limits<T>` где `T` это	`min_exponent`	`min_exponent10`	`max_exponent`	`max_exponent10`	`radix`
float	FLT_MIN_EXP	FLT_MIN_10_EXP	FLT_MAX_EXP	FLT_MAX_10_EXP	FLT_RADIX
double	DBL_MIN_EXP	DBL_MIN_10_EXP	DBL_MAX_EXP	DBL_MAX_10_EXP	FLT_RADIX
long double	LDBL_MIN_EXP	LDBL_MIN_10_EXP	LDBL_MAX_EXP	LDBL_MAX_10_EXP	FLT_RADIX

Пример

Запустить этот код

#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

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены задним числом к ранее опубликованным стандартам C++.

DR	Applied to	Behavior as published	Correct behavior
LWG 201	C++98	specializations for all fundamental types need to be provided	excluded non-arithmetic types
LWG 559	C++98	it was unclear whether the `std::numeric_limits` specialization for a cv-qualified type behaves as the same as the corresponding specialization for the cv-unqualified type	they have the same behavior

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros (C++20)
Language support library
Concepts library (C++20)
Diagnostics library
Memory management library
Metaprogramming library (C++11)
General utilities library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Technical specifications
Symbols index
External libraries

Static constants
numeric_limits::is_specialized
numeric_limits::is_signed
numeric_limits::is_integer
numeric_limits::is_exact
numeric_limits::has_infinity
numeric_limits::has_quiet_NaN
numeric_limits::has_signaling_NaN
numeric_limits::has_denorm
numeric_limits::has_denorm_loss
numeric_limits::round_style
numeric_limits::is_iec559
numeric_limits::is_bounded
numeric_limits::is_modulo
numeric_limits::digits
numeric_limits::digits10
numeric_limits::max_digits10 (C++11)
numeric_limits::radix
numeric_limits::min_exponent
numeric_limits::min_exponent10
numeric_limits::max_exponent
numeric_limits::max_exponent10
numeric_limits::traps
numeric_limits::tinyness_before
Static member functions
numeric_limits::min
numeric_limits::lowest (C++11)
numeric_limits::max
numeric_limits::epsilon
numeric_limits::round_error
numeric_limits::infinity
numeric_limits::quiet_NaN
numeric_limits::signaling_NaN
numeric_limits::denorm_min
Helper types
float_round_style
float_denorm_style

cppreference.net

Namespaces

Variants