Introduction
Sometimes you need true random numbers. True random numbers are, in contrast to numbers generated by a pseudo-random number generator (PRNG), really random, i.e. there are no patterns and they cannot be predicted.
Pseudo-random number generators are functions that compute random-looking sequences of numbers. For most cases this is sufficient, but some applications need numbers that are really random.
You need true random numbers for example in the field of cryptography, game-playing and various scientific calculations.
CTrueRandom is completely free open-source. You are allowed to do anything with it what you want. But it would be nice if you mention me (Dominik Reichl) somewhere in the docs of your application :-) But because it is completely free, there also is no warranty of any kind. Use it on your own risk.
How CTrueRandom works
CTrueRandom uses the online service provided by random.org (thanks random.org!). Random.org is an online true random number generation service. The true random numbers are generated using atmospheric noise.
The class uses the
URLDownloadToCacheFile function of the
UrlMon.dll. This DLL is a library which gets installed with Internet Explorer 3.0 or later. So IE must be installed. The Internet Explorer handles the complete download: it uses the default proxy if needed, establishes a connection to the server, it creates a file and stores the downloaded stream into it. The
URLDownloadToCacheFile returns the filename of the cached file.
CTrueRandom reads that file and deletes it when finished.
Because of speed reasons,
CTrueRandom currently downloads 8192 random bytes at once. You can now call the
GetRandomByte function 8192 times before the cached file gets refreshed automatically, or 4096 words, or 2048 dwords, or 1024 dwords plus 2048 words, etc. So the cached file gets completely used and
CTrueRandom doesn't download random bytes each
GetRandomXXX call.
Because we use an online service, the speed of the random number class depends on the speed of the internet connection. If you have ADSL you won't have any problems getting 5 MB random bytes in a few seconds. If you know that the end-user only has a low speed internet connection and need many random bytes, consider downloading only a few true random bytes and using them as seed to a pseudo-random number generator.
Usage
Using the
CTrueRandom class is very easy. Here's a sample snippet:
CTrueRandom rnd;
BYTE pArray[2000];
if(rnd.Initialize() == false)
{
MessageBox("Initialization of CTrueRandom class failed!","Error",0);
return;
}
rnd.GetRandomBuffer(pArray, 2000);
BYTE b = rnd.GetRandomByte();
WORD w = rnd.GetRandomWord();
DWORD dw = rnd.GetRandomDWord();
rnd.Close(); Public function summary:
bool CTrueRandom::Initialize()
Before you can use any of the
GetRandomXXX functions you must initialize the class using the
Initialize function. This function tries to establish a connection to random.org and get some random numbers to a cache. If it cannot connect to the server, it returns false. If it successfully downloaded some random bytes to the cache, it returns true.
void CTrueRandom::GetRandomBuffer(BYTE *pBuf, DWORD dwBufferSize)
This function fills the buffer pBuf with
dwBufferSize random bytes. If there aren't enough random bytes in the cache, it automatically connects to the server again and gets some new ones.
BYTE CTrueRandom::GetRandomByte()
WORD CTrueRandom::GetRandomWord()
DWORD CTrueRandom::GetRandomDWord()
Various wrappers for the
GetRandomBuffer function. It should be clear what they are doing.
void CTrueRandom::Close()
When you don't need random numbers any more, call the
Close function. It will free allocated memory and loaded libraries.
History
