Man page - expm1f(3)

Packages contains this manual

Available languages:

en fr pt_BR pl cs ja ru ro de

Manual

EXPM1

名 前
書 式
説 明
返 り 値
エ ラ ー
属 性
準 拠
バ グ
関 連 項 目
こ の 文 書 に つ い て

名 前

expm1, expm1f, expm1l - 引 数 の 指 数 か ら 1 を 引 い た 値

書 式

#include <math.h>

double expm1(double x );
float expm1f(float x );
long double expm1l(long double x );

-lm で リ ン ク す る 。

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

expm1 ():

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

expm1f (), expm1l ():

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

説 明

こ れ ら の 関 数 は 、 以 下 と 等 価 な 値 を 返 す 。

exp(x) - 1

結 果 の 計 算 は 、 x が 0 の 近 傍 で 、 非 常 に 近 い 2 つ の 数 字 の 引 き 算 の た め exp(x) - 1 が 不 正 確 に な る よ う な 場 合 で も 正 確 と な る 方 法 で 行 わ れ る 。

返 り 値

成 功 す る と 、 こ れ ら の 関 数 は exp(x) - 1 を 返 す 。

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

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

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

x が 負 の 無 限 大 の 場 合 、 -1 が 返 さ れ る 。

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

エ ラ ー

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

以 下 の エ ラ ー が 発 生 す る 可 能 性 が あ る 。
範 囲 エ ラ ー (range error)、 オ ー バ ー フ ロ ー の 場 合

errno に ERANGE が 設 定 さ れ る (「 バ グ 」 の 節 も 参 照 )。 オ ー バ ー フ ロ ー 浮 動 小 数 点 例 外 ( FE_OVERFLOW ) が 上 が る 。

属 性

こ の 節 で 使 用 さ れ て い る 用 語 の 説 明 に つ い て は 、 attributes (7) を 参 照 。

Image grohtml-25562-1.png

準 拠

C99, POSIX.1-2001, POSIX.1-2008.

バ グ

Before glibc 2.17, on certain architectures (e.g., x86, but not x86_64) expm1 () raised a bogus underflow floating-point exception for some large negative x values (where the function result approaches -1),

glibc 2.11 あ た り よ り 前 で は 、 expm1 () は 、 x が 正 の 大 き な 値 の 場 合 、 期 待 通 り の オ ー バ ー フ ロ ー 例 外 だ け で な く 間 違 っ て 不 正 な (invalid) 浮 動 小 数 点 例 外 を 上 げ 、 正 の 無 限 大 で は な く NaN を 返 し て い た 。

バ ー ジ ョ ン 2.11 よ り 前 の glibc の 実 装 で は 、 範 囲 エ ラ ー が 発 生 し た 場 合 に 、 errno に ERANGE が 設 定 さ れ な か っ た 。

関 連 項 目

exp (3), log (3), log1p (3)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。