NAN(3)

名前
nan, nanf, nanl - 無効値 ('Not a Number') を返す

書式
#include <math.h>

double nan(const char *tagp);
float nanf(const char *tagp);
long double nanl(const char *tagp);

-lm でリンクする。

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

nan(), nanf(), nanl():
    _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
    or cc -std=c99

説明
これらの関数は、SIGFPE シグナルなしの無効値 (NaN) を示す表現を返す (どの表現を使用するかは tagp で指定する)。SIGFPE シグナルなしの NaN をサポートしていない実装では 0 を返す。

nan("char-sequence") を呼び出すのは、以下と等価である。
    strtod("NAN(char-sequence)", NULL);

同様に、 nanf() や nanl() を呼び出すのは、 strtof() や strtold() を呼ぶのと同じである。

引き数 tagp の使い方は規定されていない。 IEEE 754 準拠のシステムでは、NaN にも複数の表現が存在し、 tagp はその選択に使用される。 他のシステムでは、何の意味もないかもしれない。

バージョン
これらの関数は glibc バージョン 2.1 で初めて登場した。

準拠
C99, POSIX.1-2001. IEC 559 や推奨関数になっている IEEE 754/IEEE 854 の付録も参照すること。

関連項目
isnan(3), strtod(3), math_error(7)

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