Namespaces
Variants

std:: trunc, std:: truncf, std:: truncl

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
trunc
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
헤더 파일에 정의됨 <cmath>
(1)
float trunc ( float num ) ;

double trunc ( double num ) ;

long double trunc ( long double num ) ;
(C++23 이전)
constexpr /*floating-point-type*/
trunc ( /*floating-point-type*/ num ) ;
(C++23부터)
float truncf ( float num ) ;
(2) (C++11부터)
(C++23부터 constexpr)
long double truncl ( long double num ) ;
(3) (C++11부터)
(C++23부터 constexpr)
SIMD 오버로드 (C++26부터)
헤더 파일에 정의됨 <simd>
template < /*math-floating-point*/ V >

constexpr /*deduced-simd-t*/ < V >

trunc ( const V & v_num ) ;
(S) (C++26부터)
추가 오버로드 (C++11부터)
헤더 파일에 정의됨 <cmath>
template < class Integer >
double trunc ( Integer num ) ;
(A) (C++23부터 constexpr)
1-3) 크기 기준으로 초과하지 않는 가장 가까운 정수를 계산합니다. num . 라이브러리는 매개변수 타입으로 모든 cv-unqualified 부동소수점 타입에 대한 std::trunc 의 오버로드를 제공합니다. (since C++23)
S) SIMD 오버로드는 v_num 에 대해 요소별(element-wise) std::trunc 연산을 수행합니다.
(정의는 math-floating-point 와 deduced-simd-t 참조)
(C++26부터)
A) 모든 정수 타입에 대해 추가 오버로드가 제공되며, 이들은 double 로 처리됩니다.
(since C++11)

목차

매개변수

num - 부동 소수점 또는 정수 값

반환값

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

반환 값
math-trunc.svg
num

오류 처리

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

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

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

참고 사항

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

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

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

추가 오버로드는 반드시 (A) 와 정확히 동일하게 제공될 필요는 없습니다. 정수 타입의 인자 num 에 대해, std :: trunc ( num ) 가 std :: trunc ( static_cast < double > ( num ) ) 와 동일한 효과를 가지도록 보장하기에 충분하기만 하면 됩니다.

예제

이 코드 실행 
#include <cmath>
#include <initializer_list>
#include <iostream>
int main()
{
    const auto data = std::initializer_list<double>
    {
        +2.7, -2.9, +0.7, -0.9, +0.0, 0.0, -INFINITY, +INFINITY, -NAN, +NAN
    };
    std::cout << std::showpos;
    for (double const x : data)
        std::cout << "trunc(" << x << ") == " << std::trunc(x) << '\n';
}

가능한 출력: 

trunc(+2.7) == +2
trunc(-2.9) == -2
trunc(+0.7) == +0
trunc(-0.9) == -0
trunc(+0) == +0
trunc(+0) == +0
trunc(-inf) == -inf
trunc(+inf) == +inf
trunc(-nan) == -nan
trunc(+nan) == +nan

참고 항목

(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)
가장 가까운 정수, 중간값의 경우 0에서 멀어지는 방향으로 반올림
(함수)
C documentation for trunc