scalb(3M)

構文

#include <math.h>

double scalb(double x, double y);

説明

scalb() 関数は、 r がマシンの浮動小数点演算の基数として、 x * r^y を返します。 基数 r は、すべての PA-RISC および Itanium ベース システムで ２ です。

使用方法

これらの関数を使用するには、デフォルトの -Ae オプションを指定するか、または -Aa オプションと -D_HPUX_SOURCE オプションを指定してコンパイルしてください。

Itanium ベース システムで scalbw() または scalbq() を使うには、 -fpwidetypes オプションも指定してコンパイルしてください。

プログラムに <math.h> がインクルードされていることを確認した後、 コンパイラまたはリンカーのコマンド行で -lm を指定して、数学ライブラリとリンクしてください。

戻り値

scalb(-x, y) と -scalb(x , y) は同等です。

y が ±0 の場合、 scalb() は x を返します。

x が +0 で y が +INFINITY の場合、 scalb() は NaN を返し、無効例外が発生します。

x が +0 で y が +INFINITY より小さい整数の場合、 scalb() は +0 を返します。

x が +INFINITY で y が -INFINITY より大きい整数の場合、 scalb() は +INFINITY を返します。

x が有限の正の数で y が -INFINITY の場合、 scalb() は +0 を返します。

x が正の数で y が +INFINITY の場合、 scalb() は +INFINITY を返します。

x が +INFINITY で y が -INFINITY の場合、 scalb() は NaN を返します。

x または y が NaN の場合、 scalb() は NaN を返します。

scalb() は、値が大きすぎる場合これに代えて、 適切な符号が付いた無限大 (±HUGE_VAL に等しい) を返し、 オーバーフロー例外と不正確例外を発生させます。

scalb() では、結果が非常に小さく (本質的にはデノーマル値やゼロ) 正確な値でなくなるときには必ず、アンダーフロー例外と不正確例外が発生します。 また、結果が非常に小さいというだけで、これらの例外が発生することがあります。

エラー

正しい値がオーバーフローまたはアンダーフローした場合、 scalb() は errno に [ERANGE] を設定します。

参照

scalbn(3M), scalbln(3M), ilogb(3M), ldexp(3M), logb(3M), math(5)

標準準拠

scalb() : ISO/IEC C99 (付録 F 『IEC 60559 floating-point arithmetic』を含む)