X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/a9f0a989a17f47f9d25b7a426b4e82a8ff684ee4..6a70ef0d8173b57817bcc8a013eb86c8583e74fc:/lispref/numbers.texi diff --git a/lispref/numbers.texi b/lispref/numbers.texi index fbbdc83871..eaa2250a3f 100644 --- a/lispref/numbers.texi +++ b/lispref/numbers.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998 Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/numbers @node Numbers, Strings and Characters, Lisp Data Types, Top @@ -36,18 +37,18 @@ exact; they have a fixed, limited amount of precision. The range of values for an integer depends on the machine. The minimum range is @minus{}134217728 to 134217727 (28 bits; i.e., -@ifinfo +@ifnottex -2**27 -@end ifinfo +@end ifnottex @tex -$-2^{27}$ +@math{-2^{27}} @end tex to -@ifinfo +@ifnottex 2**27 - 1), -@end ifinfo +@end ifnottex @tex -$2^{27}-1$), +@math{2^{27}-1}), @end tex but some machines may provide a wider range. Many examples in this chapter assume an integer has 28 bits. @@ -312,6 +313,8 @@ otherwise. @defun max number-or-marker &rest numbers-or-markers This function returns the largest of its arguments. +If any of the argument is floating-point, the value is returned +as floating point, even if it was given as an integer. @example (max 20) @@ -319,12 +322,14 @@ This function returns the largest of its arguments. (max 1 2.5) @result{} 2.5 (max 1 3 2.5) - @result{} 3 + @result{} 3.0 @end example @end defun @defun min number-or-marker &rest numbers-or-markers This function returns the smallest of its arguments. +If any of the argument is floating-point, the value is returned +as floating point, even if it was given as an integer. @example (min -4 1) @@ -953,37 +958,69 @@ in radians. @end defun @defun asin arg -The value of @code{(asin @var{arg})} is a number between @minus{}pi/2 -and pi/2 (inclusive) whose sine is @var{arg}; if, however, @var{arg} +The value of @code{(asin @var{arg})} is a number between +@ifnottex +@minus{}pi/2 +@end ifnottex +@tex +@math{-\pi/2} +@end tex +and +@ifnottex +pi/2 +@end ifnottex +@tex +@math{\pi/2} +@end tex +(inclusive) whose sine is @var{arg}; if, however, @var{arg} is out of range (outside [-1, 1]), then the result is a NaN. @end defun @defun acos arg -The value of @code{(acos @var{arg})} is a number between 0 and pi +The value of @code{(acos @var{arg})} is a number between 0 and +@ifnottex +pi +@end ifnottex +@tex +@math{\pi} +@end tex (inclusive) whose cosine is @var{arg}; if, however, @var{arg} is out of range (outside [-1, 1]), then the result is a NaN. @end defun @defun atan arg -The value of @code{(atan @var{arg})} is a number between @minus{}pi/2 -and pi/2 (exclusive) whose tangent is @var{arg}. +The value of @code{(atan @var{arg})} is a number between +@ifnottex +@minus{}pi/2 +@end ifnottex +@tex +@math{-\pi/2} +@end tex +and +@ifnottex +pi/2 +@end ifnottex +@tex +@math{\pi/2} +@end tex +(exclusive) whose tangent is @var{arg}. @end defun @defun exp arg This is the exponential function; it returns @tex -$e$ +@math{e} @end tex -@ifinfo +@ifnottex @i{e} -@end ifinfo +@end ifnottex to the power @var{arg}. @tex -$e$ +@math{e} @end tex -@ifinfo +@ifnottex @i{e} -@end ifinfo +@end ifnottex is a fundamental mathematical constant also called the base of natural logarithms. @end defun @@ -992,11 +1029,11 @@ logarithms. This function returns the logarithm of @var{arg}, with base @var{base}. If you don't specify @var{base}, the base @tex -$e$ +@math{e} @end tex -@ifinfo +@ifnottex @i{e} -@end ifinfo +@end ifnottex is used. If @var{arg} is negative, the result is a NaN. @end defun @@ -1053,9 +1090,9 @@ first call to @code{(random)} after you start Emacs always returns -1457731, and the second one always returns -7692030. This repeatability is helpful for debugging. -If you want truly unpredictable random numbers, execute @code{(random -t)}. This chooses a new seed based on the current time of day and on -Emacs's process @sc{id} number. +If you want random numbers that don't always come out the same, execute +@code{(random t)}. This chooses a new seed based on the current time of +day and on Emacs's process @sc{id} number. @defun random &optional limit This function returns a pseudo-random integer. Repeated calls return a