OSDN Git Service

(split) Apply minor changes from v3.32 to v3.35 in the upstream.
[linuxjm/LDP_man-pages.git] / draft / 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 .\"O .SH NAME
16 .\"O nan, nanf, nanl \- return 'Not a Number'
17 .SH Ì¾Á°
18 nan, nanf, nanl \- Ìµ¸úÃÍ ('Not a Number') ¤òÊÖ¤¹
19 .\"O .SH SYNOPSIS
20 .SH ½ñ¼°
21 .B #include <math.h>
22 .sp
23 .BI "double nan(const char *" tagp );
24 .br
25 .BI "float nanf(const char *" tagp );
26 .br
27 .BI "long double nanl(const char *" tagp );
28 .sp
29 .\"O Link with \fI\-lm\fP.
30 \fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
31 .sp
32 .in -4n
33 .\"O Feature Test Macro Requirements for glibc (see
34 .\"O .BR feature_test_macros (7)):
35 glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
36 .RB ( feature_test_macros (7)
37 »²¾È):
38 .in
39 .sp
40 .ad l
41 .BR nan (),
42 .BR nanf (),
43 .BR nanl ():
44 .RS 4
45 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
46 _POSIX_C_SOURCE\ >=\ 200112L;
47 .br
48 or
49 .I cc\ -std=c99
50 .RE
51 .ad
52 .\"O .SH DESCRIPTION
53 .SH ÀâÌÀ
54 .\"O These functions return a representation (determined by
55 .\"O .IR tagp )
56 .\"O of a quiet NaN.
57 .\"O If the implementation does not support
58 .\"O quiet NaNs, these functions return zero.
59 .\" motoki: quiet NaN ¤È¤Ï²¿¤À¤í¤¦¡©
60 ¤³¤ì¤é¤Î´Ø¿ô¤Ï¡¢SIGFPE ¥·¥°¥Ê¥ë¤Ê¤·¤Î̵¸úÃÍ (NaN) ¤ò¼¨¤¹É½¸½¤òÊÖ¤¹
61 (¤É¤Îɽ¸½¤ò»ÈÍѤ¹¤ë¤«¤Ï
62 .I tagp
63 ¤Ç»ØÄꤹ¤ë)¡£SIGFPE ¥·¥°¥Ê¥ë¤Ê¤·¤Î NaN ¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Ê¤¤¼ÂÁõ¤Ç¤Ï 0 ¤òÊÖ¤¹¡£
64 .LP
65 .\"O The call
66 .\"O .I nan("char-sequence")
67 .\"O is equivalent to:
68 .\"O .nf
69 .\"O 
70 .\"O     strtod("NAN(char-sequence)", NULL);
71 .\"O .fi
72 .I nan("char-sequence")
73 ¤ò¸Æ¤Ó½Ð¤¹¤Î¤Ï¡¢
74 .nf
75
76     strtod("NAN(char-sequence)", NULL);
77
78 .fi
79 ¤ÈÅù²Á¤Ç¤¢¤ë¡£
80 .PP
81 .\"O Similarly, calls to
82 .\"O .BR nanf ()
83 .\"O and
84 .\"O .BR nanl ()
85 .\"O are equivalent to analogous calls to
86 .\"O .BR strtof (3)
87 .\"O and
88 .\"O .BR strtold (3).
89 ƱÍͤˡ¢
90 .BR nanf ()
91 ¤ä
92 .BR nanl ()
93 ¤ò¸Æ¤Ó½Ð¤¹¤Î¤Ï¡¢
94 .BR strtof ()
95 ¤ä
96 .BR strtold ()
97 ¤ò¸Æ¤Ö¤Î¤ÈƱ¤¸¤Ç¤¢¤ë¡£
98 .PP
99 .\"O The argument
100 .\"O .I tagp
101 .\"O is used in an unspecified manner.
102 .\"O On IEEE 754 systems, there are
103 .\"O many representations of NaN, and
104 .\"O .I tagp
105 .\"O selects one.
106 .\"O On other systems it may do nothing.
107 °ú¤­¿ô
108 .I tagp
109 ¤Î»È¤¤Êý¤Ïµ¬Äꤵ¤ì¤Æ¤¤¤Ê¤¤¡£
110 IEEE 754 ½àµò¤Î¥·¥¹¥Æ¥à¤Ç¤Ï¡¢NaN ¤Ë¤âÊ£¿ô¤Îɽ¸½¤¬Â¸ºß¤·¡¢
111 .I tagp
112 ¤Ï¤½¤ÎÁªÂò¤Ë»ÈÍѤµ¤ì¤ë¡£
113 ¾¤Î¥·¥¹¥Æ¥à¤Ç¤Ï¡¢²¿¤Î°ÕÌ£¤â¤Ê¤¤¤«¤â¤·¤ì¤Ê¤¤¡£
114 .\"O .SH VERSIONS
115 .SH ¥Ð¡¼¥¸¥ç¥ó
116 .\"O These functions first appeared in glibc in version 2.1.
117 ¤³¤ì¤é¤Î´Ø¿ô¤Ï glibc ¥Ð¡¼¥¸¥ç¥ó 2.1 ¤Ç½é¤á¤ÆÅо줷¤¿¡£
118 .\"O .SH "CONFORMING TO"
119 .SH ½àµò
120 C99, POSIX.1-2001.
121 .\"O See also IEC 559 and the appendix with
122 .\"O recommended functions in IEEE 754/IEEE 854.
123 IEC 559 ¤ä¿ä¾©´Ø¿ô¤Ë¤Ê¤Ã¤Æ¤¤¤ë IEEE 754/IEEE 854
124 ¤ÎÉÕÏ¿¤â»²¾È¤¹¤ë¤³¤È¡£
125 .\"O .SH "SEE ALSO"
126 .SH ´ØÏ¢¹àÌÜ
127 .BR isnan (3),
128 .BR strtod (3),
129 .BR math_error (7)