From: mdw <mdw>
Date: Wed, 22 Dec 1999 15:55:43 +0000 (+0000)
Subject: Add `mprand_range'.
X-Git-Url: https://git.distorted.org.uk/u/mdw/catacomb/commitdiff_plain/743cef23cf55ff5f4ac436e6e916cc43960eed1b

Add `mprand_range'.
---

diff --git a/mprand.h b/mprand.h
index 2ecfa15..ea1bc21 100644
--- a/mprand.h
+++ b/mprand.h
@@ -1,6 +1,6 @@
 /* -*-c-*-
  *
- * $Id: mprand.h,v 1.1 1999/12/10 23:23:05 mdw Exp $
+ * $Id: mprand.h,v 1.2 1999/12/22 15:55:43 mdw Exp $
  *
  * Generate a random multiprecision integer
  *
@@ -30,6 +30,9 @@
 /*----- Revision history --------------------------------------------------* 
  *
  * $Log: mprand.h,v $
+ * Revision 1.2  1999/12/22 15:55:43  mdw
+ * Add `mprand_range'.
+ *
  * Revision 1.1  1999/12/10 23:23:05  mdw
  * Support for generating random large integers.
  *
@@ -72,6 +75,22 @@
 
 extern mp *mprand(mp */*d*/, unsigned /*b*/, grand */*r*/, mpw /*or*/);
 
+/* --- @mprand_range@ --- *
+ *
+ * Arguments:	@mp *d@ = destination integer
+ *		@mp *l@ = limit for random number
+ *		@grand *r@ = random number source
+ *		@mpw or@ = mask for low-order bits
+ *
+ * Returns: 	A pseudorandom integer, unformly distributed over the
+ *		interval %$[0, l)$%.
+ *
+ * Use:		Generates a uniformly-distributed pseudorandom number in the
+ *		appropriate range.
+ */
+
+extern mp *mprand_range(mp */*d*/, mp */*l*/, grand */*r*/, mpw /*or*/);
+
 /*----- That's all, folks -------------------------------------------------*/
 
 #ifdef __cplusplus