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)

 

<tbody> </tbody>

Определено в заголовочном файле <cmath>
float rint( float arg );		(начиная с C++11)
double rint( double arg );		(начиная с C++11)
long double rint( long double arg );		(начиная с C++11)
double rint( Integral arg );		(начиная с C++11)
long lrint( float arg );		(начиная с C++11)
long lrint( double arg );		(начиная с C++11)
long lrint( long double arg );		(начиная с C++11)
long lrint( Integral arg );		(начиная с C++11)
long long llrint( float arg );		(начиная с C++11)
long long llrint( double arg );		(начиная с C++11)
long long llrint( long double arg );		(начиная с C++11)
long long 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 ON
    std::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)	получает или устанавливает направление округления (функция)