ldexp

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

ldexp, ldexpf, ldexpl - 浮動小数点実数と 2 の整数乗との積を計算する  

ライブラリ

数学ライブラリ (libm,~-lm)  

書式

#include <math.h>

double ldexp(double x, int e);
float ldexpf(float x, int e);
long double ldexpl(long double x, int e);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

ldexpf(), ldexpl():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
 

説明

These functions return the result of multiplying the floating-point number x by 2 raised to the power e.  

返り値

On success, these functions return x * (2^e).

If e is zero, then x is returned.

x が NaN の場合、NaN が返される。

x が正の無限大 (負の無限大) の場合、正の無限大 (負の無限大) が返される。

結果がアンダーフローする場合、 範囲エラー (range error) が発生し、0 が返される。

結果がオーバーフローする場合、 範囲エラー (range error) が発生し、 各関数はそれぞれ HUGE_VAL, HUGE_VALF, HUGE_VALL を返す。符号は x と同じになる。  

エラー

これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は math_error(7) を参照のこと。

以下のエラーが発生する可能性がある。

範囲エラー (range error)、オーバーフローの場合
errno に ERANGE が設定される。 オーバーフロー浮動小数点例外 (FE_OVERFLOW) が上がる。
範囲エラー (range error)、アンダーフローの場合
errno に ERANGE が設定される。 アンダーフロー浮動小数点例外 (FE_UNDERFLOW) が上がる。
 

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
ldexp(), ldexpf(), ldexpl() Thread safetyMT-Safe
 

標準規格

C11, POSIX.1-2008.  

歴史

C99, POSIX.1-2001.

double 版の関数は SVr4, 4.3BSD, C89 にも準拠している。  

関連項目

frexp(3), modf(3), scalbln(3)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
属性
標準規格
歴史
関連項目

This document was created by man2html, using the manual pages.