release/man3/nan.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL
   3 .\" Based on glibc infopages
   4 .\"
   5 .\" Corrections by aeb
   6 .\"
   7 .\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI all rights reserved.
   8 .\" Translated Thu 05 Dec 2002 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   9 .\" Updated 2008-09-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  10 .\"
  11 .\"WORD:        NaN             無効値
  12 .\"WORD:        quiet NaN       SIGFPE シグナルなしの無効値
  13 .\"
  14 .TH NAN 3 2010-09-20 "GNU" "Linux Programmer's Manual"
  15 .SH 名前
  16 nan, nanf, nanl \- 無効値 ('Not a Number') を返す
  17 .SH 書式
  18 .B #include <math.h>
  19 .sp
  20 .BI "double nan(const char *" tagp );
  21 .br
  22 .BI "float nanf(const char *" tagp );
  23 .br
  24 .BI "long double nanl(const char *" tagp );
  25 .sp
  26 \fI\-lm\fP でリンクする。
  27 .sp
  28 .in -4n
  29 glibc 向けの機能検査マクロの要件
  30 .RB ( feature_test_macros (7)
  31 参照):
  32 .in
  33 .sp
  34 .ad l
  35 .BR nan (),
  36 .BR nanf (),
  37 .BR nanl ():
  38 .RS 4
  39 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
  40 _POSIX_C_SOURCE\ >=\ 200112L;
  41 .br
  42 or
  43 .I cc\ -std=c99
  44 .RE
  45 .ad
  46 .SH 説明
  47 .\" motoki: quiet NaN とは何だろう？
  48 これらの関数は、SIGFPE シグナルなしの無効値 (NaN) を示す表現を返す
  49 (どの表現を使用するかは
  50 .I tagp
  51 で指定する)。SIGFPE シグナルなしの NaN をサポートしていない実装では 0 を返す。
  52 .LP
  53 .I nan("char-sequence")
  54 を呼び出すのは、
  55 .nf
  56
  57     strtod("NAN(char-sequence)", NULL);
  58
  59 .fi
  60 と等価である。
  61 .PP
  62 同様に、
  63 .BR nanf ()
  64 や
  65 .BR nanl ()
  66 を呼び出すのは、
  67 .BR strtof ()
  68 や
  69 .BR strtold ()
  70 を呼ぶのと同じである。
  71 .PP
  72 引き数
  73 .I tagp
  74 の使い方は規定されていない。
  75 IEEE 754 準拠のシステムでは、NaN にも複数の表現が存在し、
  76 .I tagp
  77 はその選択に使用される。
  78 他のシステムでは、何の意味もないかもしれない。
  79 .SH バージョン
  80 これらの関数は glibc バージョン 2.1 で初めて登場した。
  81 .SH 準拠
  82 C99, POSIX.1-2001.
  83 IEC 559 や推奨関数になっている IEEE 754/IEEE 854
  84 の付録も参照すること。
  85 .SH 関連項目
  86 .BR isnan (3),
  87 .BR strtod (3),
  88 .BR math_error (7)