std:: rint, std:: rintf, std:: rintl, std:: lrint, std:: lrintf, std:: lrintl, std:: llrint, std:: llrintf

From cppreference.net

헤더 파일에 정의됨 `<cmath>`
부동 소수점 타입으로 반올림
	(1)
float rint ( float num ) ; double rint ( double num ) ; long double rint ( long double num ) ;			(C++11 이후) (C++23 이전)
/* floating-point-type / rint ( / floating-point-type */ num ) ;			(C++23 이후)
float rintf ( float num ) ;		(2)	(C++11 이후)
long double rintl ( long double num ) ;		(3)	(C++11 이후)
long 으로 반올림
		(4)
long lrint ( float num ) ; long lrint ( double num ) ; long lrint ( long double num ) ;				(C++11부터) (C++23 이전까지)
long lrint ( /* floating-point-type */ num ) ;				(C++23부터)
long lrintf ( float num ) ;			(5)	(C++11 이후)
long lrintl ( long double num ) ;			(6)	(C++11 이후)
long long 으로 반올림
			(7)
long long llrint ( float num ) ; long long llrint ( double num ) ; long long llrint ( long double num ) ;					(C++11부터) (C++23 이전까지)
long long llrint ( /* floating-point-type */ num ) ;					(C++23부터)
long long llrintf ( float num ) ;				(8)	(C++11 이후)
long long llrintl ( long double num ) ;				(9)	(C++11 이후)
추가 오버로드
헤더에 정의됨 `<cmath>`
template < class Integer > double rint ( Integer num ) ;				(A)	(C++11 이후)
template < class Integer > long lrint ( Integer num ) ;				(B)	(C++11 이후)
template < class Integer > long long llrint ( Integer num ) ;				(C)	(C++11 이후)

1-3) 부동 소수점 인수 num 을 현재 반올림 모드 를 사용하여 정수 값(부동 소수점 형식)으로 반올림합니다. 라이브러리는 모든 cv-한정되지 않은 부동 소수점 타입에 대한


          std::rint

의 오버로드를 매개변수 num 의 타입으로 제공합니다. (C++23부터)

4-9) 부동 소수점 인수 num 을 현재 반올림 모드 를 사용하여 정수 값으로 반올림합니다. 라이브러리는 모든 cv-한정되지 않은 부동 소수점 타입에 대해


          std::lrint

와


          std::llrint

의 오버로드를 매개변수 num 의 타입으로 제공합니다. (C++23부터)

A-C) 모든 정수 타입에 대해 추가적인 오버로드가 제공되며, 이들은 double 로 처리됩니다.

만약 num 이 ±∞이면, FE_INVALID 이 발생하고 구현에서 정의된 값이 반환됩니다.
만약 반올림 결과가 반환 타입의 범위를 벗어나면, FE_INVALID 이 발생하고 구현에서 정의된 값이 반환됩니다.
만약 num 이 NaN이면, FE_INVALID 이 발생하고 구현에서 정의된 값이 반환됩니다.

참고 사항

POSIX는 std::lrint 또는 std::llrint 가 FE_INEXACT 를 발생시키는 모든 경우가 도메인 오류라고 명시합니다.

math_errhandling 에 명시된 바와 같이, 정수가 아닌 유한 값을 반올림할 때 std::rint 에 의해 FE_INEXACT 가 발생할 수 있습니다(비 IEEE 부동 소수점 플랫폼에서는 필수 사항이 아닙니다).

std::rint 와 std::nearbyint 사이의 유일한 차이점은 std::nearbyint 가 절대로 FE_INEXACT 를 발생시키지 않는다는 것입니다.

표준 부동 소수점 형식에서 가장 큰 표현 가능한 부동 소수점 값들은 모두 정확한 정수이므로, std::rint 는 자체적으로는 절대 오버플로우를 일으키지 않습니다; 그러나 결과를 정수 변수(예: std::intmax_t 를 포함한 모든 정수 타입)에 저장할 때는 오버플로우가 발생할 수 있습니다.

현재 반올림 모드가 다음과 같을 경우:

FE_DOWNWARD 인 경우, std::rint 는 std::floor 와 동일합니다.
FE_UPWARD 인 경우, std::rint 는 std::ceil 와 동일합니다.
FE_TOWARDZERO 인 경우, std::rint 는 std::trunc 와 동일합니다.
FE_TONEAREST 인 경우, std::rint 는 std::round 와 달리 중간값 케이스에서 0에서 멀어지는 방향이 아닌 짝수로 반올림됩니다.

추가 오버로드는 반드시 (A-C) 와 정확히 동일하게 제공될 필요가 없습니다. 이들은 정수 타입의 인수 num 에 대해 다음을 보장하기에 충분하기만 하면 됩니다:

std :: rint ( num ) 는 std :: rint ( static_cast < double > ( num ) ) 와 동일한 효과를 가집니다.
std :: lrint ( num ) 는 std :: lrint ( static_cast < double > ( num ) ) 와 동일한 효과를 가집니다.
std :: llrint ( num ) 는 std :: llrint ( static_cast < double > ( num ) ) 와 동일한 효과를 가집니다.

예제

이 코드 실행

#include <cfenv>
#include <climits>
#include <cmath>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::fesetround(FE_TONEAREST);
    std::cout << "가장 가까운 값으로 반올림 (중간값은 짝수로):\n"
              << "  rint(+2.3) = " << std::rint(2.3) << '\n'
              << "  rint(+2.5) = " << std::rint(2.5) << '\n'
              << "  rint(+3.5) = " << std::rint(3.5) << '\n'
              << "  rint(-2.3) = " << std::rint(-2.3) << '\n'
              << "  rint(-2.5) = " << std::rint(-2.5) << '\n'
              << "  rint(-3.5) = " << std::rint(-3.5) << '\n';
    std::fesetround(FE_DOWNWARD);
    std::cout << "내림:\n"
              << "  rint(+2.3) = " << std::rint(2.3) << '\n'
              << "  rint(+2.5) = " << std::rint(2.5) << '\n'
              << "  rint(+3.5) = " << std::rint(3.5) << '\n'
              << "  rint(-2.3) = " << std::rint(-2.3) << '\n'
              << "  rint(-2.5) = " << std::rint(-2.5) << '\n'
              << "  rint(-3.5) = " << std::rint(-3.5) << '\n'
              << "lrint로 내림 처리:\n"
              << "  lrint(+2.3) = " << std::lrint(2.3) << '\n'
              << "  lrint(+2.5) = " << std::lrint(2.5) << '\n'
              << "  lrint(+3.5) = " << std::lrint(3.5) << '\n'
              << "  lrint(-2.3) = " << std::lrint(-2.3) << '\n'
              << "  lrint(-2.5) = " << std::lrint(-2.5) << '\n'
              << "  lrint(-3.5) = " << std::lrint(-3.5) << '\n'
              << "특수 값:\n"
              << "  lrint(-0.0) = " << std::lrint(-0.0) << '\n'
              << std::hex << std::showbase
              << "  lrint(-Inf) = " << std::lrint(-INFINITY) << '\n';
    // 오류 처리
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "std::rint(0.1) = " << std::rint(.1) << '\n';
    if (std::fetestexcept(FE_INEXACT))
        std::cout << "  FE_INEXACT가 발생했습니다\n";
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "std::lrint(LONG_MIN-2048.0) = "
              << std::lrint(LONG_MIN - 2048.0) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "FE_INVALID이 발생했습니다\n";
}

가능한 출력:

가장 가까운 값으로 반올림 (중간값은 짝수로):
  rint(+2.3) = 2
  rint(+2.5) = 2
  rint(+3.5) = 4
  rint(-2.3) = -2
  rint(-2.5) = -2
  rint(-3.5) = -4
아래로 반올림:
  rint(+2.3) = 2
  rint(+2.5) = 2
  rint(+3.5) = 4
  rint(-2.3) = -2
  rint(-2.5) = -2
  rint(-3.5) = -4
lrint를 사용한 아래로 반올림:
  lrint(+2.3) = 2
  lrint(+2.5) = 2
  lrint(+3.5) = 3
  lrint(-2.3) = -3
  lrint(-2.5) = -3
  lrint(-3.5) = -4
특수 값:
  lrint(-0.0) = 0
  lrint(-Inf) = 0x8000000000000000
std::rint(0.1) = 0
std::lrint(LONG_MIN-2048.0) = 0x8000000000000000
  FE_INVALID가 발생했습니다

참고 항목

trunc truncf truncl (C++11) (C++11) (C++11)	주어진 값의 크기보다 크지 않은 가장 가까운 정수 (함수)
nearbyint nearbyintf nearbyintl (C++11) (C++11) (C++11)	현재 반올림 모드를 사용한 가장 가까운 정수 (함수)
fegetround fesetround (C++11) (C++11)	반올림 방향을 얻거나 설정 (함수)
C documentation for rint

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

cppreference.net

Namespaces

Variants

std:: rint, std:: rintf, std:: rintl, std:: lrint, std:: lrintf, std:: lrintl, std:: llrint, std:: llrintf

목차

매개변수

반환값

오류 처리

참고 사항

예제

참고 항목