std::rint, std::lrint, std::llrint

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека числовых данных

Общие математические функции

Специальные математические функции(C++17)

Математические константы(C++20)

Среда с плавающей точкой(C++11)

Комплексные числа

Числовые массивы

Генерация псевдослучайных чисел

Рациональная арифметика времени компиляции(C++11)

Факторные операции

gcd (C++17)

lcm (C++17)

Интерполяции

midpoint (C++20)

lerp (C++20)

Общие числовые операции

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)

Операции с битами

bit_cast (C++20)

byteswap (C++23)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

Общие математические функции

Функции
Основные операции
abs(int)labsllabsimaxabs (C++11) abs(float)fabs divldivlldivimaxdiv (C++11) fmod	remainder (C++11) remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
Экспоненциальные функции
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
Степенные функции
sqrt cbrt (C++11)	hypot (C++11) pow
Тригонометрические и гиперболические функции
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)

Ошибка и гамма функции
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)
Операции целочисленного округления с плавающей запятой
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
Функции манипуляции с плавающей запятой
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
Классификация/Сравнение
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
Макро-константы
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) INFINITY (C++11) NAN (C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)	FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

Определено в заголовочном файле <cmath>
float rint(float arg );		(начиная с C++11)
double rint(double arg );		(начиная с C++11)
longdouble rint(longdouble arg );		(начиная с C++11)
double rint( Integral arg );		(начиная с C++11)
long lrint(float arg );		(начиная с C++11)
long lrint(double arg );		(начиная с C++11)
long lrint(longdouble arg );		(начиная с C++11)
long lrint( Integral arg );		(начиная с C++11)
longlong llrint(float arg );		(начиная с C++11)
longlong llrint(double arg );		(начиная с C++11)
longlong llrint(longdouble arg );		(начиная с C++11)
longlong llrint( Integral arg );		(начиная с C++11)

Округляет аргумент — число с плавающей точкой arg до целочисленного значения в формате с плавающей точкой, используя текущий режим округления. Если результат отличается от переданного arg (например, если arg не является целочисленным значением), генерируется исключение с плавающей точкой FE_INEXACT.

Параметры

arg

—

значение плавающей точкой

Возвращаемое значение

Целый результат округления arg

Заметки

Единственное различие между std::nearbyint и std::rint в том, что std::rint может сгенерировать исключение с плавающей точкой FE_INEXACT, а std::nearbyint никогда не генерирует его.

Пример

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

#include <cmath>#include <cfenv>#include <iostream>int main(){#pragma STDC FENV_ACCESS ONstd::fesetround(FE_DOWNWARD);std::cout<<"округление, использующее FE_DOWNWARD:\n"<<std::fixed<<" 12.0 -> "<< std::rint(12.0)<<'\n'<<" 12.1 -> "<< std::rint(12.1)<<'\n'<<"-12.1 -> "<< std::rint(-12.1)<<'\n'<<" 12.5 -> "<< std::rint(12.5)<<'\n'<<" 12.9 -> "<< std::rint(12.9)<<'\n'<<"-12.9 -> "<< std::rint(-12.9)<<'\n'<<" 13.0 -> "<< std::rint(13.0)<<'\n';std::fesetround(FE_TONEAREST);std::cout<<"округление, использующее FE_TONEAREST: \n"<<" 12.0 -> "<< std::rint(12.0)<<'\n'<<" 12.1 -> "<< std::rint(12.1)<<'\n'<<"-12.1 -> "<< std::rint(-12.1)<<'\n'<<" 12.5 -> "<< std::rint(12.5)<<'\n'<<" 12.9 -> "<< std::rint(12.9)<<'\n'<<"-12.9 -> "<< std::rint(-12.9)<<'\n'<<" 13.0 -> "<< std::rint(13.0)<<'\n';   std::cout<<"При округлении 12.0 ";std::feclearexcept(FE_ALL_EXCEPT); std::rint(12.0);if(std::fetestexcept(FE_ALL_EXCEPT)&FE_INEXACT){std::cout<<"сообщается о неточности\n";}else{std::cout<<"о неточности не сообщается\n";}   std::cout<<"При округлении 12.1 "; std::rint(12.1);if(std::fetestexcept(FE_ALL_EXCEPT)&FE_INEXACT){std::cout<<"сообщается о неточности\n";}else{std::cout<<"о неточности не сообщается\n";}}

Вывод:

округление, использующее FE_DOWNWARD: 12.0 -> 12.000000 12.1 -> 12.000000 -12.1 -> -13.000000 12.5 -> 12.000000 12.9 -> 12.000000 -12.9 -> -13.000000 13.0 -> 13.000000 округление, использующее FE_TONEAREST: 12.0 -> 12.000000 12.1 -> 12.000000 -12.1 -> -12.000000 12.5 -> 12.000000 12.9 -> 13.000000 -12.9 -> -13.000000 13.0 -> 13.000000 При округлении 12.0 о неточности не сообщается При округлении 12.1 сообщается о неточности

См. также

nearbyintnearbyintfnearbyintl (C++11)(C++11)(C++11)	ближайшее целое число с использованием текущего режима округления (функция)
trunctruncftruncl (C++11)(C++11)(C++11)	ближайшее целое число, не превышающее по величине заданное значение (функция)
fegetroundfesetround (C++11)(C++11)	получает или устанавливает направление округления (функция)