ilArrayElementShuffler Class Reference

Inheritance diagram for ilArrayElementShuffler:

Collaboration diagram for ilArrayElementShuffler:

Public Member Functions
	__construct ()
	getSeed ()
	setSeed ($seed)
	buildRandomSeed ()
	buildSeedFromString ($string)
	shuffle ($array)

Protected Attributes
	$seed

Private Member Functions
	initSeed ($seed)
	shuffleArray ($array)
	mtShuffle ($orderedArray)
	isMtRandomizerAvailable ()

Detailed Description

Definition at line 11 of file class.ilArrayElementShuffler.php.

Constructor & Destructor Documentation

__construct()

ilArrayElementShuffler::__construct

(

)

Definition at line 20 of file class.ilArrayElementShuffler.php.

References buildRandomSeed(), and setSeed().

        {
                $this->setSeed($this->buildRandomSeed());
        }

Here is the call graph for this function:

Member Function Documentation

buildRandomSeed()

ilArrayElementShuffler::buildRandomSeed

(

)

Returns

integer

Definition at line 44 of file class.ilArrayElementShuffler.php.

Referenced by __construct(), and shuffle().

        {
                list($usec, $sec) = explode(' ', microtime());
                return (int)($sec + ($usec * 100000));
        }

Here is the caller graph for this function:

buildSeedFromString()

ilArrayElementShuffler::buildSeedFromString

(

$string

)

Parameters

string

$string

Returns

integer

Definition at line 54 of file class.ilArrayElementShuffler.php.

        {
                return hexdec(substr(md5($string), 0, 10));
        }

getSeed()

ilArrayElementShuffler::getSeed

(

)

Returns

integer

Definition at line 28 of file class.ilArrayElementShuffler.php.

References $seed.

Referenced by shuffle().

        {
                return $this->seed;
        }

Here is the caller graph for this function:

initSeed()

ilArrayElementShuffler::initSeed (   $seed )

private

Parameters

integer

$seed

Definition at line 74 of file class.ilArrayElementShuffler.php.

References $seed, and isMtRandomizerAvailable().

Referenced by shuffle().

        {
                $seed = (int)$seed; // (mt_)srand seems to not cast to integer itself (string seeds avoid randomizing) !!

                if( $this->isMtRandomizerAvailable() )
                {
                        mt_srand($seed);
                }
                else
                {
                        srand($seed);
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

isMtRandomizerAvailable()

ilArrayElementShuffler::isMtRandomizerAvailable ( )

private

Returns

bool

Definition at line 124 of file class.ilArrayElementShuffler.php.

Referenced by initSeed(), and shuffleArray().

        {
                return function_exists('mt_srand') && function_exists('mt_rand');
        }

Here is the caller graph for this function:

mtShuffle()

ilArrayElementShuffler::mtShuffle (   $orderedArray )

private

Parameters

array

$orderedArray

Returns

array

Definition at line 107 of file class.ilArrayElementShuffler.php.

References array.

Referenced by shuffleArray().

        {
                $shuffledArray = array();
                
                while( count($orderedArray) > 0 )
                {
                        $key = mt_rand(0, (count($orderedArray)-1));
                        $splice = array_splice($orderedArray, $key, 1);
                        $shuffledArray[] = current($splice);
                }
                
                return $shuffledArray;
        }

Here is the caller graph for this function:

setSeed()

ilArrayElementShuffler::setSeed

(

$seed

)

Parameters

integer

$seed

Definition at line 36 of file class.ilArrayElementShuffler.php.

References $seed.

Referenced by __construct().

        {
                $this->seed = $seed;
        }

Here is the caller graph for this function:

shuffle()

ilArrayElementShuffler::shuffle

(

$array

)

Parameters

array

$array

Returns

array

Definition at line 63 of file class.ilArrayElementShuffler.php.

References buildRandomSeed(), getSeed(), initSeed(), and shuffleArray().

Referenced by assClozeGap\getItems(), and shuffleArray().

        {
                $this->initSeed($this->getSeed());
                $array = $this->shuffleArray($array);
                $this->initSeed($this->buildRandomSeed());
                return $array;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

shuffleArray()

ilArrayElementShuffler::shuffleArray (   $array )

private

Parameters

array

$array

Returns

array

Definition at line 92 of file class.ilArrayElementShuffler.php.

References isMtRandomizerAvailable(), mtShuffle(), and shuffle().

Referenced by shuffle().

        {
                if( $this->isMtRandomizerAvailable() )
                {
                        return $this->mtShuffle($array);
                }

                shuffle($array);
                return $array;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$seed

ilArrayElementShuffler::$seed

protected

Definition at line 16 of file class.ilArrayElementShuffler.php.

Referenced by getSeed(), initSeed(), and setSeed().

---

The documentation for this class was generated from the following file:

• Services/Randomization/classes/class.ilArrayElementShuffler.php