Пространства имён
Варианты
Действия

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

Материал из cppreference.com
< cpp‎ | numeric‎ | math
 
 
 
Общие математические функции
Функции
Основные операции
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
Экспоненциальные функции
(C++11)
(C++11)
(C++11)
(C++11)
Степенные функции
(C++11)
(C++11)
Тригонометрические и гиперболические функции
(C++11)
(C++11)
(C++11)
Ошибка и гамма функции
(C++11)
(C++11)
(C++11)
(C++11)
Операции целочисленного округления с плавающей запятой
(C++11)(C++11)(C++11)
(C++11)
(C++11)
rintlrintllrint
(C++11)(C++11)(C++11)
Функции манипуляции с плавающей запятой
(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)
Классификация/Сравнение
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Макро-константы
(C++11)(C++11)(C++11)(C++11)(C++11)
 
Определено в заголовочном файле <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 сообщается о неточности

[править] См. также

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