Namespaces
Variants

trunc, truncf, truncl

From cppreference.net
< c ‎ | numeric ‎ | math
C
Numerics
Common mathematical functions
Functions
Basic operations
(C99)
(C99)
(C99)
(C99)
(C99) (C99) (C99) (C23)
Maximum/minimum operations
Exponential functions
Power functions
Trigonometric and hyperbolic functions
Nearest integer floating-point
(C99) (C99) (C99)
(C23)
trunc
(C99)

(C99)
(C99) (C99) (C99)
(C23) (C23) (C23) (C23)
Floating-point manipulation
Narrowing operations
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quantum and quantum exponent
Decimal re-encoding functions
Total order and payload functions
Classification
Error and gamma functions
(C99)
(C99)
(C99)
(C99)
Types
Macro constants
Special floating-point values
Arguments and return values
Error handling
Fast operation indicators
헤더 파일에 정의됨 <math.h>
float truncf ( float arg ) ;
(1) (C99부터)
double trunc ( double arg ) ;
(2) (C99부터)
long double truncl ( long double arg ) ;
(3) (C99부터)
헤더 파일에 정의됨 <tgmath.h>
#define trunc( arg )
(4) (C99부터)
1-3) 크기 기준으로 더 크지 않은 가장 가까운 정수를 계산합니다 arg .
4) 타입-제네릭 매크로: 만약 arg 가 long double 타입을 가지면, truncl 가 호출됩니다. 그렇지 않고 arg 가 정수 타입이나 double 타입을 가지면, trunc 가 호출됩니다. 그 외의 경우에는 truncf 가 호출됩니다.

목차

매개변수

arg - 부동소수점 값

반환값

오류가 발생하지 않으면, 크기 기준으로 더 크지 않은 가장 가까운 정수 값 arg (다시 말해, arg 를 0 방향으로 반올림한 값)이 반환됩니다.

반환값
math-trunc.svg
인수

오류 처리

오류는 math_errhandling 에 명시된 대로 보고됩니다.

구현체가 IEEE 부동 소수점 연산(IEC 60559)을 지원하는 경우:

  • 현재 반올림 모드 는 영향을 미치지 않습니다.
  • 만약 arg 가 ±∞이면, 수정 없이 그대로 반환됩니다.
  • 만약 arg 가 ±0이면, 수정 없이 그대로 반환됩니다.
  • 만약 arg 가 NaN이면, NaN이 반환됩니다.

참고 사항

FE_INEXACT 는 비정수 유한 값을 절단할 때 발생할 수 있습니다(발생해야 하는 것은 아닙니다).

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

부동 소수점에서 정수형으로의 암시적 변환 또한 0 방향으로 반올림하지만, 대상 타입으로 표현 가능한 값으로 제한됩니다.

예제

이 코드 실행 
#include <math.h>
#include <stdio.h>
int main(void)
{
    printf("trunc(+2.7) = %+.1f\n", trunc(+2.7));
    printf("trunc(-2.7) = %+.1f\n", trunc(-2.7));
    printf("trunc(-0.0) = %+.1f\n", trunc(-0.0));
    printf("trunc(-Inf) = %+f\n",   trunc(-INFINITY));
}

가능한 출력: 

trunc(+2.7) = +2.0
trunc(-2.7) = -2.0
trunc(-0.0) = -0.0
trunc(-Inf) = -inf

참고문헌

  • C23 표준 (ISO/IEC 9899:2024):
  • 7.12.9.8 trunc 함수들 (p: TBD)
  • 7.25 타입-제네릭 수학 <tgmath.h> (p: TBD)
  • F.10.6.8 trunc 함수들 (p: TBD)
  • C17 표준 (ISO/IEC 9899:2018):
  • 7.12.9.8 trunc 함수들 (p: TBD)
  • 7.25 타입-제네릭 수학 <tgmath.h> (p: TBD)
  • F.10.6.8 trunc 함수들 (p: TBD)
  • C11 표준 (ISO/IEC 9899:2011):
  • 7.12.9.8 trunc 함수들 (p: 253-254)
  • 7.25 유형-일반 수학 <tgmath.h> (p: 373-375)
  • F.10.6.8 trunc 함수들 (p: 528)
  • C99 표준 (ISO/IEC 9899:1999):
  • 7.12.9.8 trunc 함수들 (p: 234)
  • 7.22 범용 수학 <tgmath.h> (p: 335-337)
  • F.9.6.8 trunc 함수들 (p: 464)

참고 항목

(C99) (C99)
주어진 값보다 크지 않은 가장 큰 정수를 계산합니다
(함수)
(C99) (C99)
주어진 값보다 작지 않은 가장 작은 정수를 계산합니다
(함수)
(C99) (C99) (C99) (C99) (C99) (C99) (C99) (C99) (C99)
가장 가까운 정수로 반올림하며, 중간값인 경우 0에서 멀어지는 방향으로 반올림합니다
(함수)
C++ documentation for trunc