Namespaces
Variants

std:: ldexp, std:: ldexpf, std:: ldexpl

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
ldexp
(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 ldexp ( float num, int exp ) ;

double ldexp ( double num, int exp ) ;

long double ldexp ( long double num, int exp ) ;
(C++23 이전)
constexpr /* floating-point-type */
ldexp ( /* floating-point-type */ num, int exp ) ;
(C++23 이후)
float ldexpf ( float num, int exp ) ;
(2) (C++11 이후)
(C++23부터 constexpr)
long double ldexpl ( long double num, int exp ) ;
(3) (C++11 이후)
(C++23부터 constexpr)
추가 오버로드 (C++11 이후)
헤더 파일에 정의됨 <cmath>
template < class Integer >
double ldexp ( Integer num, int exp ) ;
(A) (C++11 이후)
(C++23부터 constexpr)
1-3) 부동 소수점 값 num 에 2 의 exp 제곱을 곱합니다. 라이브러리는 std::ldexp 의 오버로드를 매개변수 num 의 타입으로 모든 cv-unqualified 부동소수점 타입에 대해 제공합니다. (since C++23)
A) 모든 정수 타입에 대해 추가 오버로드가 제공되며, 이들은 double 로 처리됩니다.
(since C++11)

목차

매개변수

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

반환값

오류가 발생하지 않으면, num 에 2의 exp 제곱을 곱한 값( num×2 exp
)이 반환됩니다.

오버플로로 인한 범위 오류가 발생하는 경우, ±HUGE_VAL , ±HUGE_VALF , 또는 ±HUGE_VALL 가 반환됩니다.

언더플로로 인한 범위 오류가 발생하면, 올바른 결과(반올림 후)가 반환됩니다.

오류 처리

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

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

  • 범위 오류가 발생하지 않는 한, FE_INEXACT 는 절대 발생하지 않습니다 (결과는 정확함).
  • 범위 오류가 발생하지 않는 한, 현재 반올림 모드 는 무시됩니다.
  • 만약 num 이 ±0이면, 수정 없이 그대로 반환됩니다.
  • 만약 num 이 ±∞이면, 수정 없이 그대로 반환됩니다.
  • 만약 exp 이 0이면, num 이 수정 없이 반환됩니다.
  • 만약 num 이 NaN이면, NaN이 반환됩니다.

참고 사항

이진 시스템(여기서 FLT_RADIX 가 2 인 경우)에서, std::ldexp 는 std::scalbn 와 동등합니다.

함수 std::ldexp ("지수 로드")는 그 상대 함수인 std::frexp 와 함께 직접적인 비트 조작 없이 부동소수점 수의 표현을 조작하는 데 사용될 수 있습니다.

많은 구현에서, std::ldexp 는 산술 연산자를 사용하여 2의 거듭제곱으로 곱셈이나 나눗셈을 수행하는 것보다 효율성이 낮습니다.

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

부동 소수점 지수에 대한 2의 거듭제곱 연산에는 std::exp2 를 사용할 수 있습니다.

예제

이 코드 실행 
#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout
        << "ldexp(5, 3) = 5 * 8 = " << std::ldexp(5, 3) << '\n'
        << "ldexp(7, -4) = 7 / 16 = " << std::ldexp(7, -4) << '\n'
        << "ldexp(1, -1074) = " << std::ldexp(1, -1074)
        << " (minimum positive subnormal float64_t)\n"
        << "ldexp(nextafter(1,0), 1024) = "
        << std::ldexp(std::nextafter(1,0), 1024)
        << " (largest finite float64_t)\n";
    // special values
    std::cout << "ldexp(-0, 10) = " << std::ldexp(-0.0, 10) << '\n'
              << "ldexp(-Inf, -1) = " << std::ldexp(-INFINITY, -1) << '\n';
    // error handling
    std::feclearexcept(FE_ALL_EXCEPT);
    errno = 0;
    const double inf = std::ldexp(1, 1024);
    const bool is_range_error = errno == ERANGE;
    std::cout << "ldexp(1, 1024) = " << inf << '\n';
    if (is_range_error)
        std::cout << "    errno == ERANGE: " << std::strerror(ERANGE) << '\n';
    if (std::fetestexcept(FE_OVERFLOW))
        std::cout << "    FE_OVERFLOW raised\n";
}

가능한 출력: 

ldexp(5, 3) = 5 * 8 = 40
ldexp(7, -4) = 7 / 16 = 0.4375
ldexp(1, -1074) = 4.94066e-324 (minimum positive subnormal float64_t)
ldexp(nextafter(1,0), 1024) = 1.79769e+308 (largest finite float64_t)
ldexp(-0, 10) = -0
ldexp(-Inf, -1) = -inf
ldexp(1, 1024) = inf
    errno == ERANGE: Numerical result out of range
    FE_OVERFLOW raised

참고 항목

(C++11) (C++11)
숫자를 가수와 밑수 2 지수로 분해
(함수)
(C++11) (C++11) (C++11) (C++11) (C++11) (C++11)
숫자에 FLT_RADIX 의 거듭제곱을 곱함
(함수)
(C++11) (C++11) (C++11)
주어진 거듭제곱으로 올린 2 의 값을 반환 ( 2 x )
(함수)
C 문서 참조 ldexp