From 0843fae4ca013ad5cbbcc601bc1c26c31c89b8fc Mon Sep 17 00:00:00 2001 From: tege Date: Mon, 17 Apr 2000 02:06:34 +0200 Subject: Move obsolete random functions to end of respective section. --- gmp.texi | 56 ++++++++++++++++++++++++++++---------------------------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/gmp.texi b/gmp.texi index 967ac3e0e..3b07e614c 100644 --- a/gmp.texi +++ b/gmp.texi @@ -1808,25 +1808,6 @@ parameter that is read and modified. Please see the @ref{Random Number Functions} for more information on how to use and not to use random number functions. -@deftypefun void mpz_random (mpz_t @var{rop}, mp_size_t @var{max_size}) -Generate a random integer of at most @var{max_size} limbs. The generated -random number doesn't satisfy any particular requirements of randomness. -Negative random numbers are generated when @var{max_size} is negative. - -This function is obsolete. Use @code{mpz_urandomb} or -@code{mpz_urandomm} instead. -@end deftypefun - -@deftypefun void mpz_random2 (mpz_t @var{rop}, mp_size_t @var{max_size}) -Generate a random integer of at most @var{max_size} limbs, with long strings -of zeros and ones in the binary representation. Useful for testing functions -and algorithms, since this kind of random numbers have proven to be more -likely to trigger corner-case bugs. Negative random numbers are generated -when @var{max_size} is negative. - -This function is obsolete. Use @code{mpz_rrandomb} instead. -@end deftypefun - @deftypefun void mpz_urandomb (mpz_t @var{rop}, gmp_randstate_t @var{state}, unsigned long int @var{n}) Generate a uniform random integer in the range @@ -1900,6 +1881,25 @@ two more than the value returned by @code{mpz_sizeinbase} (one extra for a minus sign and one for the terminating '\0'). @end deftypefun +@deftypefun void mpz_random (mpz_t @var{rop}, mp_size_t @var{max_size}) +Generate a random integer of at most @var{max_size} limbs. The generated +random number doesn't satisfy any particular requirements of randomness. +Negative random numbers are generated when @var{max_size} is negative. + +This function is obsolete. Use @code{mpz_urandomb} or +@code{mpz_urandomm} instead. +@end deftypefun + +@deftypefun void mpz_random2 (mpz_t @var{rop}, mp_size_t @var{max_size}) +Generate a random integer of at most @var{max_size} limbs, with long strings +of zeros and ones in the binary representation. Useful for testing functions +and algorithms, since this kind of random numbers have proven to be more +likely to trigger corner-case bugs. Negative random numbers are generated +when @var{max_size} is negative. + +This function is obsolete. Use @code{mpz_rrandomb} instead. +@end deftypefun + @node Rational Number Functions, Floating-point Functions, Integer Functions, Top @comment node-name, next, previous, up @@ -2589,15 +2589,6 @@ the next higher integer, @code{mpf_floor} to the next lower, and @code{mpf_trunc} to the integer towards zero. @end deftypefun -@deftypefun void mpf_random2 (mpf_t @var{rop}, mp_size_t @var{max_size}, mp_exp_t @var{max_exp}) -Generate a random float of at most @var{max_size} limbs, with long strings of -zeros and ones in the binary representation. The exponent of the number is in -the interval @minus{}@var{exp} to @var{exp}. This function is useful for -testing functions and algorithms, since this kind of random numbers have -proven to be more likely to trigger corner-case bugs. Negative random numbers -are generated when @var{max_size} is negative. -@end deftypefun - @deftypefun void mpf_urandomb (mpf_t @var{rop}, gmp_randstate_t @var{state}) Generate a universally distributed random float in the interval 0 <= X < 1. @@ -2607,6 +2598,15 @@ The variable @var{state} must be initialized by calling one of the before invoking this function. @end deftypefun +@deftypefun void mpf_random2 (mpf_t @var{rop}, mp_size_t @var{max_size}, mp_exp_t @var{max_exp}) +Generate a random float of at most @var{max_size} limbs, with long strings of +zeros and ones in the binary representation. The exponent of the number is in +the interval @minus{}@var{exp} to @var{exp}. This function is useful for +testing functions and algorithms, since this kind of random numbers have +proven to be more likely to trigger corner-case bugs. Negative random numbers +are generated when @var{max_size} is negative. +@end deftypefun + @c @deftypefun size_t mpf_size (mpf_t @var{op}) -- cgit v1.2.1