scalbln

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

名前

scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl - scale by an integer power of radix  

ライブラリ

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

書式

#include <math.h>

double scalbln(double x, long e);
float scalblnf(float x, long e);
long double scalblnl(long double x, long e);

double scalbn(double x, int e);
float scalbnf(float x, int e);
long double scalbnl(long double x, int e);

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

scalbln(), scalblnf(), scalblnl():

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

scalbn(), scalbnf(), scalbnl():

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

説明

These functions multiply their first argument x by FLT_RADIX (probably 2) to the power of e, that is:

    x * FLT_RADIX ** e

FLT_RADIX の定義は <float.h> をインクルードすることで得られる。  

返り値

On success, these functions return x * FLT_RADIX ** e.

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

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

x が +0 (-0) の場合、+0 (-0) が返される。

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

結果がアンダーフローする場合、範囲エラーが発生し、 各関数は 0 を返す。符号は x と同じになる。  

エラー

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

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

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

属性

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

標準規格

C11, POSIX.1-2008.  

歴史

glibc 2.1. C99, POSIX.1-2001.  

歴史

これらの関数は、 scalb(3) に説明がある廃止予定の関数群とは二番目の 引数の型が異なる。このページで説明する関数群は、二番目の引数の型が 整数である。これに対して scalb(3) に説明がある関数群は、二番目の 引数の型が double である。  

注意

FLT_RADIX が 2 の場合 (これが普通だが)、 その場合は scalbn() は ldexp(3) と等価である。  

バグ

バージョン 2.20 より前の glibc では、これらの関数は範囲エラーの場合に errno を設定しなかった。  

関連項目

ldexp(3), scalb(3)


 

Index

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

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