comparison lispref/numbers.texi @ 25751:467b88fab665

*** empty log message ***

25750:f1968a807f56

minimum range is @minus{}134217728 to 134217727 (28 bits; i.e.,
@ifinfo 
-2**27
@end ifinfo
@tex 
$-2^{27}$
@end tex
to 
@ifinfo 
2**27 - 1),
@end ifinfo
@tex 
$2^{27}-1$),
@end tex
but some machines may provide a wider range.  Many examples in this
chapter assume an integer has 28 bits.
@cindex overflow

otherwise.
@end defun

@defun max number-or-marker &rest numbers-or-markers
This function returns the largest of its arguments.

@example
(max 20)
     @result{} 20
(max 1 2.5)
     @result{} 2.5
(max 1 3 2.5)
     @result{} 3
@end example
@end defun

@defun min number-or-marker &rest numbers-or-markers
This function returns the smallest of its arguments.

@example
(min -4 1)
     @result{} -4
@end example

The value of @code{(asin @var{arg})} is a number between
@ifinfo
@minus{}pi/2
@end ifinfo
@tex
$-\pi/2$
@end tex
and
@ifinfo
pi/2
@end ifinfo
@tex
$\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

The value of @code{(acos @var{arg})} is a number between 0 and
@ifinfo
pi
@end ifinfo
@tex
$\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

The value of @code{(atan @var{arg})} is a number between
@ifinfo
@minus{}pi/2
@end ifinfo
@tex
$-\pi/2$
@end tex
and
@ifinfo
pi/2
@end ifinfo
@tex
$\pi/2$
@end tex
(exclusive) whose tangent is @var{arg}.
@end defun

@defun exp arg
This is the exponential function; it returns
@tex
$e$
@end tex
@ifinfo
@i{e}
@end ifinfo
to the power @var{arg}.
@tex
$e$
@end tex
@ifinfo
@i{e}
@end ifinfo
is a fundamental mathematical constant also called the base of natural

@defun log arg &optional base
This function returns the logarithm of @var{arg}, with base @var{base}.
If you don't specify @var{base}, the base
@tex
$e$
@end tex
@ifinfo
@i{e}
@end ifinfo
is used.  If @var{arg}

the same in each Emacs run!  For example, in one operating system, the
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.

@defun random &optional limit
This function returns a pseudo-random integer.  Repeated calls return a
series of pseudo-random integers.

25751:467b88fab665

minimum range is @minus{}134217728 to 134217727 (28 bits; i.e.,
@ifinfo 
-2**27
@end ifinfo
@tex 
@math{-2^{27}}
@end tex
to 
@ifinfo 
2**27 - 1),
@end ifinfo
@tex 
@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.
@cindex overflow

otherwise.
@end defun

@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)
     @result{} 20
(max 1 2.5)
     @result{} 2.5
(max 1 3 2.5)
     @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)
     @result{} -4
@end example

The value of @code{(asin @var{arg})} is a number between
@ifinfo
@minus{}pi/2
@end ifinfo
@tex
@math{-\pi/2}
@end tex
and
@ifinfo
pi/2
@end ifinfo
@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

The value of @code{(acos @var{arg})} is a number between 0 and
@ifinfo
pi
@end ifinfo
@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

The value of @code{(atan @var{arg})} is a number between
@ifinfo
@minus{}pi/2
@end ifinfo
@tex
@math{-\pi/2}
@end tex
and
@ifinfo
pi/2
@end ifinfo
@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
@math{e}
@end tex
@ifinfo
@i{e}
@end ifinfo
to the power @var{arg}.
@tex
@math{e}
@end tex
@ifinfo
@i{e}
@end ifinfo
is a fundamental mathematical constant also called the base of natural

@defun log arg &optional base
This function returns the logarithm of @var{arg}, with base @var{base}.
If you don't specify @var{base}, the base
@tex
@math{e}
@end tex
@ifinfo
@i{e}
@end ifinfo
is used.  If @var{arg}

the same in each Emacs run!  For example, in one operating system, the
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 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
series of pseudo-random integers.