Wrapper for generation of random numbers, strings, bytes. More...

Collaboration diagram for ilRandom:

Public Member Functions
	__construct ()
	ilRandom constructor. More...

	int ($min=null, $max=null)

Private Member Functions
	logIfPossible (callable $c)

	supportsRandomInt ()

Detailed Description

Wrapper for generation of random numbers, strings, bytes.

Definition at line 7 of file class.ilRandom.php.

Constructor & Destructor Documentation

◆ __construct()

ilRandom::__construct ( )

ilRandom constructor.

Definition at line 12 of file class.ilRandom.php.

13 {

14 }

Member Function Documentation

◆ int()

ilRandom::int	(	$min = `null`,
		$max = `null`
	)

Parameters

int	$min
int	$max

Returns: int

Exceptions

Throwable

Definition at line 34 of file class.ilRandom.php.

    {
        if (is_null($min)) {
            $min = 0;
        }
        if (is_null($max)) {
            $max = mt_getrandmax();
        }
 
        if ($this->supportsRandomInt()) {
            try {
                return random_int($min, $max);
            } catch (Exception $e) {
                $this->logIfPossible(static function (ilLogger $logger) {
                    $logger->logStack(\ilLogLevel::ERROR);
                    $logger->error('No suitable random number generator found.');
                });
                throw $e;
            } catch (Throwable $e) {
                $this->logIfPossible(static function (ilLogger $logger) {
                    $logger->logStack(\ilLogLevel::ERROR);
                    $logger->error('max should be greater than min.');
                });
                throw $e;
            }
        }
        // version 5.6 => use mt_rand
        return mt_rand($min, $max);
    }

References ilLogger\error(), ilLogLevel\ERROR, logIfPossible(), ilLogger\logStack(), and supportsRandomInt().

Here is the call graph for this function:

◆ logIfPossible()

ilRandom::logIfPossible ( callable $c )

private

Parameters

callable $c

Definition at line 19 of file class.ilRandom.php.

    {
        global $DIC;
 
        if (isset($DIC['ilLoggerFactory'])) {
            $c($DIC->logger()->rnd());
        }
    }

References $c, and $DIC.

Referenced by int().

Here is the caller graph for this function:

◆ supportsRandomInt()

ilRandom::supportsRandomInt ( )