FBB::IRandStream(3bobcat)				      Random numbers istream					 FBB::IRandStream(3bobcat)

NAME

       FBB::IRandStream - Istream producing random numbers

SYNOPSIS

       #include <bobcat/irandstream>
       Linking option: -lbobcat

DESCRIPTION

       FBB::IRandStream objects may be used to extract random numbers in a given range from a stream.

NAMESPACE

       FBB
       All constructors, members, operators and manipulators, mentioned in this man-page, are defined in the namespace FBB.

INHERITS FROM

       std::istream,
       FBB::RandBuffer (private)

CONSTRUCTORS

       o      IRandStream(int max):
	      This FBB::IRandStream() constructor initializes the random generator.  The default seed (i.e., 1) for the srand(3) function is used,
	      meaning that every new run of the program will generate the same sequence of random values. Another constructor (see below) is  pro-
	      vided when this is not considered appropriate. Random values between 1 and max (inclusive) are returned.

       o      IRandStream(int min, int max):
	      This FBB::IRandStream() constructor initializes the random generator.  The default seed (i.e., 1) for the srand(3) function is used,
	      meaning that every new run of the program will generate the same sequence of random values. Another constructor (see below) is  pro-
	      vided when this is not considered appropriate. Random values between min and max (inclusive) are returned.

       o      IRandStream(int min, int max, int seed):
	      This  FBB::IRandStream() constructor initializes the random generator. The seed is used to initialze the random number generator. To
	      start the random generator at some unpredictable point, time(0) could be used.  Random values between min and  max  (inclusive)  are
	      returned.

INHERITED MEMBERS

       Since the class uses public derivation from std::istream, all members of this class can be used.

EXAMPLE

       #include <iostream>
       #include <bobcat/irandstream>

       using namespace std;
       using namespace FBB;

       int main(int argc, char **argv)
       {
	   IRandStream in(1000);

	   for (; argc--; )
	   {
	       size_t random;
	       in >> random;
	       cout << random << endl;
	   }

	   return 0;
       }

FILES

       bobcat/irandstream - defines the class interface

SEE ALSO

       bobcat(7), randbuffer(3bobcat)

BUGS

       None Reported.

DISTRIBUTION FILES

       o      bobcat_3.01.00-x.dsc: detached signature;

       o      bobcat_3.01.00-x.tar.gz: source archive;

       o      bobcat_3.01.00-x_i386.changes: change log;

       o      libbobcat1_3.01.00-x_*.deb: debian package holding the libraries;

       o      libbobcat1-dev_3.01.00-x_*.deb: debian package holding the libraries, headers and manual pages;

       o      http://sourceforge.net/projects/bobcat: public archive location;

BOBCAT

       Bobcat is an acronym of `Brokken's Own Base Classes And Templates'.

COPYRIGHT

       This is free software, distributed under the terms of the GNU General Public License (GPL).

AUTHOR

       Frank B. Brokken (f.b.brokken@rug.nl).

libbobcat1-dev_3.01.00-x.tar.gz 				     2005-2012						 FBB::IRandStream(3bobcat)