Random Classes

Table of Contents

• About
• Random
• SecureRandom
• Further Reading

About

The MAXON API provides pseudo random number generators for trivial purposes and cryptographic applications.

Random

maxon::LinearCongruentialRandom is a standard pseudo random number generator that can be initialized with a seed value:

• maxon::LinearCongruentialRandom::LinearCongruentialRandom(): Creates a new instance.
• maxon::LinearCongruentialRandom::Init(): Initialises the generator with the given seed.
• maxon::LinearCongruentialRandom::Get01(): Returns a float value between 0.0 and 1.0.
• maxon::LinearCongruentialRandom::Get11(): Returns a random float value between -1.0 and 1.0.
• maxon::LinearCongruentialRandom::GetSeed(): Returns the current maxon::UInt32 seed value.

  // This example fills an array with pseudo random numbers float values.
 
  // prepare array
  maxon::BaseArray<maxon::Float32> values;
  values.EnsureCapacity(count) iferr_return;
 
  // init pseudo random generator
  maxon::LinearCongruentialRandom<maxon::Float32> random;
  random.Init(123);
 
  // fill array with random float values
  for (maxon::Int32 i = 0; i < count; ++i)
  {
    const maxon::Float32 randomValue = random.Get01();
    values.Append(randomValue) iferr_return;
  }

SecureRandom

maxon::SecureRandom is a cryptographically secure pseudo-random number generator. It is typically used in the context of encrypting data. See Cryptography

maxon::SecureRandom provides these static functions:

• maxon::SecureRandom::GetDefaultProvider(): Returns the default generator of cryptographically secure pseudo-random numbers.
• maxon::SecureRandom::GetRandomNumber(): Fills the given memory block with random data.

  // This example fills an array with cryptographically secure random data.
 
  // prepare array
  maxon::BaseArray<maxon::UChar> values;
  values.Resize(100) iferr_return;
 
  // fill array with random data
  const maxon::SecureRandomProvider provider = maxon::SecureRandom::GetDefaultProvider();
  maxon::SecureRandom::GetRandomNumber(provider, values);
 
  // print random data
  for (maxon::UChar& chr : values)
  {
    DiagnosticOutput("Random Data: @", chr);
  }

Further Reading

• Algorithms
• Stream Conversions Manual