nearbyint, nearbyintf, nearbyintl

지정된 부동 소수점 값을 정수로 반올림하고 부동 소수점 형식으로 해당 값을 반환합니다.

구문

double nearbyint( double x );
float nearbyintf( float x );
long double nearbyintl( long double x );
#define nearbyint( X ) // Requires C11 or higher

float nearbyint( float x ); //C++ only
long double nearbyint( long double x ); //C++ only

매개 변수

x
반올림할 값입니다.

반환 값

성공하면 보고fegetround한 대로 현재 반올림 형식을 사용하여 가장 가까운 정수로 반올림된 반환x합니다. 그렇지 않은 경우에는 함수가 다음 값 중 하나를 반환할 수 있습니다.

문제	반환 값
x = ±INFINITY	±인피니티, 수정되지 않음
x = ±0	수정되지 않은 ±0
x = NaN	NaN

오류는 보고 _matherr되지 않습니다. 특히 이 함수는 예외를 보고 FE_INEXACT 하지 않습니다.

설명

이 함수의 주요 차이점은 이 함수 rint 가 인덱싱되지 않은 부동 소수점 예외를 발생하지 않는다는 것입니다.

최대 부동 소수점 값은 정확한 정수이므로 이 함수 자체는 오버플로되지 않으며, 사용하는 함수의 버전에 따라 출력이 반환 값을 오버플로할 수는 있습니다.

C++에서는 오버로드를 허용하므로 float 또는 long double 매개 변수를 사용 및 반환하는 nearbyint의 오버로드를 호출할 수 있습니다. C 프로그램에서 tgmath.h> 매크로를 사용하여 <이 함수 nearbyint 를 호출하지 않는 한 항상 두 개의 double 값을 사용하고 double 값을 반환합니다.

tgmath.h>nearbyint() 매크로를 <사용하는 경우 인수 형식에 따라 선택한 함수 버전이 결정됩니다. 자세한 내용은 형식 제네릭 수학을 참조하세요.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

요구 사항

함수	C 헤더	C++ 헤더
nearbyint, nearbyintf, nearbyintl	<math.h>	<cmath> 또는 <math.h>
nearbyint 매크로	<tgmath.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

참고 항목

사전순 함수 참조
수학 및 부동 소수점 지원