KRandomSequence
#include <KRandomSequence>
Public Member Functions  
KRandomSequence (const KRandomSequence &a)  
KRandomSequence (int intSeed=0)  
KRandomSequence (long lngSeed)  
virtual  ~KRandomSequence () 
bool  getBool () 
double  getDouble () 
unsigned int  getInt (unsigned int max) 
unsigned long  getLong (unsigned long max) 
void  modulate (int i) 
KRandomSequence &  operator= (const KRandomSequence &a) 
template<typename T >  
void  randomize (QList< T > &list) 
void  setSeed (int intSeed=0) 
void  setSeed (long lngSeed=0) 
Detailed Description
A class to create a pseudorandom sequence
Given a seed number, this class will produce a sequence of pseudorandom numbers. This would typically be used in applications like games.
In general, you should instantiate a KRandomSequence object and pass along your seed number in the constructor. From then on, simply call getDouble or getLong to obtain the next number in the sequence.
 Deprecated:
 Since 5.75, use QRandomGenerator or KRandom::shuffle
Definition at line 37 of file krandomsequence.h.
Constructor & Destructor Documentation
◆ KRandomSequence() [1/2]

explicit 
Creates a pseudorandom sequence based on the seed lngSeed.
A Pseudorandom sequence is different for each seed but can be reproduced by starting the sequence with the same seed.
If you need a single value which needs to be unpredictable, you need to use QRandomGenerator::global()>generate() instead.
 Parameters

intSeed Seed to initialize the sequence with. If lngSeed is 0, the sequence is initialized with a value from [0, RAND_MAX)
Do not use methods working with long type because on 64bit their size is different.
Definition at line 42 of file krandomsequence.cpp.
◆ ~KRandomSequence()

virtualdefault 
Standard destructor.
◆ KRandomSequence() [2/2]

default 
Copy constructor.
Member Function Documentation
◆ getBool()
bool KRandomSequence::getBool  (  ) 
Get a boolean from the pseudorandom sequence.
 Returns
 a boolean which is either true or false
Definition at line 191 of file krandomsequence.cpp.
◆ getDouble()
double KRandomSequence::getDouble  (  ) 
Get the next number from the pseudorandom sequence.
 Returns
 a pseudorandom double value between [0,1)
Definition at line 163 of file krandomsequence.cpp.
◆ getInt()
unsigned int KRandomSequence::getInt  (  unsigned int  max  ) 
Get the next number from the pseudorandom sequence.
 Returns
 a pseudorandom integer value between [0, max) with 0 <= max < 1.000.000
Definition at line 184 of file krandomsequence.cpp.
◆ modulate()
void KRandomSequence::modulate  (  int  i  ) 
Modulate the random sequence.
If S(i) is the sequence of numbers that will follow given the current state after calling modulate(i), then S(i) != S(j) for i != j and S(i) == S(j) for i == j.
This can be useful in game situation where "undo" restores the state of the random sequence. If the game modulates the random sequence with the move chosen by the player, the random sequence will be identical whenever the player "redo"s his or hers original move, but different when the player chooses another move.
With this scenario "undo" can no longer be used to repeat a certain move over and over again until the computer reacts with a favorable response or to predict the response for a certain move based on the response to another move.
 Parameters

i the sequence identified
Definition at line 149 of file krandomsequence.cpp.
◆ operator=()

default 
Assignment.
◆ randomize()

inline 
Put a list in random order.
Since kdelibs 4.11, this function uses a more efficient algorithm (FisherYates). Therefore, the order of the items in the randomized list is different from the one in earlier versions if the same seed value is used for the random sequence.
 Parameters

list the list whose order will be modified
 Note
 modifies the list in place
 Deprecated:
 Since 5.75, use KRandom::shuffle
Definition at line 124 of file krandomsequence.h.
◆ setSeed()
void KRandomSequence::setSeed  (  int  intSeed = 0  ) 
Restart the sequence based on lngSeed.
 Parameters

intSeed Seed to initialize the sequence with. If lngSeed is 0, the sequence is initialized with a value from [0, RAND_MAX).
Definition at line 63 of file krandomsequence.cpp.
The documentation for this class was generated from the following files:
Documentation copyright © 19962023 The KDE developers.
Generated on Sat Apr 1 2023 04:10:11 by doxygen 1.8.17 written by Dimitri van Heesch, © 19972006
KDE's Doxygen guidelines are available online.