debian man page for numrandom

NUMRANDOM(1)						User Contributed Perl Documentation					      NUMRANDOM(1)

NAME
       numrandom - Print out a random number.

SYNOPSIS
       numrandom [-dhV] /[expression]/

DESCRIPTION
       numrandom will print out a random number determined by the expression that you give.  The syntax and program is nearly identical to the
       numrange program, except that numrandom picks a number at random from the range expression.  If no expression is specified, numrandom will
       print out a random integer between 1 and 100.  Ranges are inclusive.

OPTIONS
	   -h  Help: You're looking at it.
	   -V  Increase verbosity.
	   -d  Debug mode.  For developers

EXAMPLES
	  Random number from 1 to 10.
	   $ numrandom /1..10/
	   7

	  From 1 to 10 or from 15 to 20.
	   $ numrandom /1..10,15..20/
	   16

	  An even number from 0 to 10
	   $ numrandom /0..10i2/
	   4

	  An odd number. Notice the starting number in the range.
	   $ numrandom /1..10i2/
	   9

	  A factor of 3 between 99 and 120.
	   $ numrandom /99..120i3/
	   111

	  A decimal number.
	   $ numrandom /1.1..2.5i0.1/
	   1.8

	  A negative random number.
	   $ numrandom /0.0..-2.0i0.3/
	   -0.8

BUGS
       numrandom is slow when dealing with large ranges to randomly find a number from.  This is because it creates a list of all potential
       numbers before picking one.  So it can be memory intensive for large ranges.

SEE ALSO
       numaverage(1), numbound(1), numinterval(1), numnormalize(1), numgrep(1), numprocess(1), numsum(1), numrange(1), numround(1)

COPYRIGHT
       numrandom is part of the num-utils package, which is copyrighted by Suso Banderas and released under the GPL license.  Please read the
       COPYING and LICENSE files that came with the num-utils package

	 Developers can read the GOALS file and contact me about providing
       submitions or help for the project.

MORE INFO
       More info on numrandom can be found at:

       http://suso.suso.org/programs/num-utils/

perl v5.10.1							    2009-10-31							      NUMRANDOM(1)