SFXLCGRandom

Class that generates a random number using the Linear Congruential Generator method(LCG method).

#include <SFXLCGRandom.h.hpp>

class SFXLCGRandom;

SFMTYPEDEFCLASS(SFXLCGRandom)

Description

Generate a pseudo-random numbers quickly using the linear combination method with 48-bit integer operations.

Example

// if seed is not set
// seed is set based on the present time
SFXLCGRandom random;

// number between UINT32_MINIMUM and UINT32_MAXIMUM
SInt32 n1 = random.GetSInt32(); // get a random number

random.Randomize(3456);         // set seed

// number between 0 and UINT08_MAXIMUM
UInt08 n2 = random.GetUInt08(); // get a random number

Member

Constructor/Destructor
SFXLCGRandom( `UInt32` seed = 0 ) Constructor of SFXLCGRandom class.

Public Functions
`Bool`	GetBool( `Void` ) Generate a random number of Bool type.
`Float32`	GetFloat32( `Void` ) Generate a random number of Float32 type.
`Float64`	GetFloat64( `Void` ) Generate a random number of Float64 type.
`SInt08`	GetSInt08( `Void` ) Generate a random number of SInt08 type.
`SInt16`	GetSInt16( `Void` ) Generate a random number of SInt16 type.
`SInt32`	GetSInt32( `Void` ) Generate a random number of SInt32 type.
`UInt08`	GetUInt08( `Void` ) Generate a random number of UInt08 type.
`UInt16`	GetUInt16( `Void` ) Generate a random number of UInt16 type.
`UInt32`	GetUInt32( `Void` ) Generate a random number of UInt32 type.
`Void`	Randomize( `UInt32` seed = 0 ) Set the seed for generating a random number.

SFXLCGRandom::SFXLCGRandom

Constructor of SFXLCGRandom class.

[ public, explicit ]
SFXLCGRandom(
    UInt32 seed = 0   // seed to generate a random number
);

Description

If 0 is set to the "seed" argument, a seed is automatically set up based on the elapsed time after the device is turned on. In case that time cannot be obtained, "0x1234ABCD" is set to this argument.

SFXLCGRandom::GetBool

Generate a random number of Bool type.

[ public ]
Bool GetBool(Void);

Return value

Return the generated random number of Bool type.

Description

Return the Bool-casted value of the 41th-from-lowest bit of a random number of unsigned 48-bit integer.

SFXLCGRandom::GetFloat32

Generate a random number of Float32 type.

[ public ]
Float32 GetFloat32(Void);

Return value

The return value takes the value from 0 to less than 1.

Description

Return the Float32-casted value of a random number of unsigned 48-bit integer divided by 281474976710656.

SFXLCGRandom::GetFloat64

Generate a random number of Float64 type.

[ public ]
Float64 GetFloat64(Void);

Return value

The return value takes the value from 0 to less than 1.

Description

Return the Float64-casted value of a random number of unsigned 48-bit integer divided by 281474976710656.

SFXLCGRandom::GetSInt08

Generate a random number of SInt08 type.

[ public ]
SInt08 GetSInt08(Void);

Description

Return the SInt08-casted value of the highest 8 bits of a random number of unsigned 48-bit integer.

SFXLCGRandom::GetSInt16

Generate a random number of SInt16 type.

[ public ]
SInt16 GetSInt16(Void);

Description

Return the SInt16-casted value of the highest 16 bits of a random number of unsigned 48-bit integer.

SFXLCGRandom::GetSInt32

Generate a random number of SInt32 type.

[ public ]
SInt32 GetSInt32(Void);

Description

Return the SInt32-casted value of the highest 32 bits of a random number of unsigned 48-bit integer.

SFXLCGRandom::GetUInt08

Generate a random number of UInt08 type.

[ public ]
UInt08 GetUInt08(Void);

Description

Return the UInt08-casted value of the highest 8 bits of a random number of unsigned 48-bit integer.

SFXLCGRandom::GetUInt16

Generate a random number of UInt16 type.

[ public ]
UInt16 GetUInt16(Void);

Description

Return the UInt16-casted value of the highest 16 bits of a random number of unsigned 48-bit integer.

SFXLCGRandom::GetUInt32

Generate a random number of UInt32 type.

[ public ]
UInt32 GetUInt32(Void);

Description

Return the UInt32-casted value of the highest 32 bits of a random number of unsigned 48-bit integer.

SFXLCGRandom::Randomize

Set the seed for generating a random number.

[ public ]
Void Randomize(
    UInt32 seed = 0   // seed to generate a random number
);

Description

If 0 is set to the "seed" argument, a seed is automatically set up based on the elapsed time after the device is turned on. In case that time cannot be obtained, "0x1234ABCD" is set to this argument.