]> git.eshelyaron.com Git - emacs.git/commitdiff
(Float Basics): Explain how to test for NaN, and printing the sign of NaNs.
authorRichard M. Stallman <rms@gnu.org>
Sat, 25 Jun 2005 02:29:46 +0000 (02:29 +0000)
committerRichard M. Stallman <rms@gnu.org>
Sat, 25 Jun 2005 02:29:46 +0000 (02:29 +0000)
lispref/numbers.texi

index 776251e4933156f55788a07b0ce2769104a40343..f7f88248ff13e80902b2029e36f5bb48b3280bba 100644 (file)
@@ -183,21 +183,26 @@ there is no correct answer.  For example, @code{(/ 0.0 0.0)} returns a
 NaN.  For practical purposes, there's no significant difference between
 different NaN values in Emacs Lisp, and there's no rule for precisely
 which NaN value should be used in a particular case, so Emacs Lisp
-doesn't try to distinguish them.  Here are the read syntaxes for
-these special floating point values:
+doesn't try to distinguish them (but it does report the sign, if you
+print it).  Here are the read syntaxes for these special floating
+point values:
 
 @table @asis
 @item positive infinity
 @samp{1.0e+INF}
 @item negative infinity
 @samp{-1.0e+INF}
-@item Not-a-number
-@samp{0.0e+NaN}.
+@item Not-a-number 
+@samp{0.0e+NaN} or @samp{-0.0e+NaN}.
 @end table
 
-  In addition, the value @code{-0.0} is distinguishable from ordinary
-zero in @acronym{IEEE} floating point (although @code{equal} and
-@code{=} consider them equal values).
+  To test whether a floating point value is a NaN, compare it with
+itself using @code{=}.  That returns @code{nil} for a NaN, and
+@code{t} for any other floating point value.
+
+  The value @code{-0.0} is distinguishable from ordinary zero in
+@acronym{IEEE} floating point, but Emacs Lisp @code{equal} and
+@code{=} consider them equal values.
 
   You can use @code{logb} to extract the binary exponent of a floating
 point number (or estimate the logarithm of an integer):