Inheritance diagram for ilTestRandomQuestionSetQuestionCollection:

Collaboration diagram for ilTestRandomQuestionSetQuestionCollection:

Public Member Functions
	setQuestions (array $questions)

	getQuestions ()

	addQuestion (ilTestRandomQuestionSetQuestion $question)

	current ()

	next ()

	key ()

	valid ()

	rewind ()

	isGreaterThan ($amount)

	isSmallerThan ($amount)

	getMissingCount ($requiredAmount)

	shuffleQuestions ()

	mergeQuestionCollection (self $questionCollection)

	getUniqueQuestionCollection ()

	getRelativeComplementCollection (self $questionCollection)

	getIntersectionCollection (self $questionCollection)

	getQuestionAmount ()

	getInvolvedQuestionIds ()

	getRandomQuestionCollection ($requiredAmount)

Private Member Functions
	getRandomArrayKeys ($array, $numKeys)

Private Attributes
	$questions = []

Detailed Description

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

Member Function Documentation

◆ addQuestion()

ilTestRandomQuestionSetQuestionCollection::addQuestion ( ilTestRandomQuestionSetQuestion $question )

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

    {
        $this->questions[] = $question;
    }

◆ current()

ilTestRandomQuestionSetQuestionCollection::current ( )

Definition at line 49 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                             : ?ilTestRandomQuestionSetQuestion
    {
        $current = current($this->questions);
        return $current !== false ? $current : null;
    }

References current().

Referenced by current().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getIntersectionCollection()

ilTestRandomQuestionSetQuestionCollection::getIntersectionCollection ( self $questionCollection )

Definition at line 153 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                                                       : ilTestRandomQuestionSetQuestionCollection
    {
        $questionIds = array_flip($questionCollection->getInvolvedQuestionIds());
 
        $intersectionCollection = new self();
 
        foreach ($this->getQuestions() as $question) {
            if (!isset($questionIds[$question->getQuestionId()])) {
                continue;
            }
 
            $intersectionCollection->addQuestion($question);
        }
 
        return $intersectionCollection;
    }

References getQuestions().

Here is the call graph for this function:

◆ getInvolvedQuestionIds()

ilTestRandomQuestionSetQuestionCollection::getInvolvedQuestionIds ( )

Definition at line 176 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                            : array
    {
        $questionIds = [];
 
        foreach ($this->getQuestions() as $question) {
            $questionIds[] = $question->getQuestionId();
        }
 
        return $questionIds;
    }

References getQuestions().

Here is the call graph for this function:

◆ getMissingCount()

ilTestRandomQuestionSetQuestionCollection::getMissingCount ( $requiredAmount )

Parameters

int $requiredAmount

Definition at line 89 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                                    : int
    {
        // hey: fixRandomTestBuildable - fix returning missing count instead of difference (neg values!)
        $difference = $requiredAmount - count($this->questions);
        $missingCount = $difference < 0 ? 0 : $difference;
        return $missingCount;
        // hey.
    }

◆ getQuestionAmount()

ilTestRandomQuestionSetQuestionCollection::getQuestionAmount ( )

Definition at line 170 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                       : int
    {
        return count($this->getQuestions());
    }

References getQuestions().

Here is the call graph for this function:

◆ getQuestions()

ilTestRandomQuestionSetQuestionCollection::getQuestions ( )

Definition at line 39 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                  : array
    {
        return $this->questions;
    }

References $questions.

Referenced by getIntersectionCollection(), getInvolvedQuestionIds(), getQuestionAmount(), getRelativeComplementCollection(), and getUniqueQuestionCollection().

Here is the caller graph for this function:

◆ getRandomArrayKeys()

ilTestRandomQuestionSetQuestionCollection::getRandomArrayKeys	(	$array,
		$numKeys
	)

private

Definition at line 200 of file class.ilTestRandomQuestionSetQuestionCollection.php.

    {
        if ($numKeys < 1) {
            return [];
        }
 
        if ($numKeys > 1) {
            return array_rand($array, $numKeys);
        }
 
        return [ array_rand($array, $numKeys) ];
    }

Referenced by getRandomQuestionCollection().

Here is the caller graph for this function:

◆ getRandomQuestionCollection()

ilTestRandomQuestionSetQuestionCollection::getRandomQuestionCollection ( $requiredAmount )

Definition at line 187 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                                                : ilTestRandomQuestionSetQuestionCollection
    {
        $randomKeys = $this->getRandomArrayKeys($this->questions, $requiredAmount);
 
        $randomQuestionCollection = new self();
 
        foreach ($randomKeys as $randomKey) {
            $randomQuestionCollection->addQuestion($this->questions[$randomKey]);
        }
 
        return $randomQuestionCollection;
    }

References getRandomArrayKeys().

Referenced by ilTestRandomQuestionSetBuilder\fetchQuestionsFromStageRandomly().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRelativeComplementCollection()

ilTestRandomQuestionSetQuestionCollection::getRelativeComplementCollection ( self $questionCollection )

actually i would like to consider $this as quantity A passed $questionCollection is should be considered as quantity B

--> relative complement usually means all element from B missing in A

indeed we are considering $questionCollection as A and $this as B currently (!) when changing, do not forget to switch caller and param for all usages (!)

Definition at line 126 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                                                             : ilTestRandomQuestionSetQuestionCollection
    {
        // hey: fixRandomTestBuildable - comment for refactoring
        // hey.
 
        $questionIds = array_flip($questionCollection->getInvolvedQuestionIds());
 
        $relativeComplementCollection = new self();
 
        foreach ($this->getQuestions() as $question) {
            if (!isset($questionIds[$question->getQuestionId()])) {
                $relativeComplementCollection->addQuestion($question);
            }
        }
 
        return $relativeComplementCollection;
    }

References getQuestions().

Here is the call graph for this function:

◆ getUniqueQuestionCollection()

ilTestRandomQuestionSetQuestionCollection::getUniqueQuestionCollection ( )

Definition at line 108 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                                 : ilTestRandomQuestionSetQuestionCollection
    {
        $uniqueQuestions = [];
 
        foreach ($this->getQuestions() as $question) {
            /* @var ilTestRandomQuestionSetQuestion $question */
 
            if (!isset($uniqueQuestions[$question->getQuestionId()])) {
                $uniqueQuestions[$question->getQuestionId()] = $question;
            }
        }
 
        $uniqueQuestionCollection = new self();
        $uniqueQuestionCollection->setQuestions($uniqueQuestions);
 
        return $uniqueQuestionCollection;
    }

References getQuestions(), and setQuestions().

Here is the call graph for this function:

◆ isGreaterThan()

ilTestRandomQuestionSetQuestionCollection::isGreaterThan ( $amount )

Definition at line 76 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                          : bool
    {
        return count($this->questions) > $amount;
    }

◆ isSmallerThan()

ilTestRandomQuestionSetQuestionCollection::isSmallerThan ( $amount )

Definition at line 81 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                          : bool
    {
        return count($this->questions) < $amount;
    }

◆ key()

ilTestRandomQuestionSetQuestionCollection::key ( )

Definition at line 60 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                         : ?string
    {
        return (string) key($this->questions);
    }

References key().

Referenced by key(), and valid().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ mergeQuestionCollection()

ilTestRandomQuestionSetQuestionCollection::mergeQuestionCollection ( self $questionCollection )

Definition at line 103 of file class.ilTestRandomQuestionSetQuestionCollection.php.

    {
        $this->questions = array_merge($this->questions, $questionCollection->getQuestions());
    }

◆ next()

ilTestRandomQuestionSetQuestionCollection::next ( )

Definition at line 55 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                          : void
    {
        next($this->questions);
    }

References next().

Referenced by next().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ rewind()

ilTestRandomQuestionSetQuestionCollection::rewind ( )

Definition at line 70 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                            : void
    {
        reset($this->questions);
    }

◆ setQuestions()

ilTestRandomQuestionSetQuestionCollection::setQuestions ( array $questions )

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

                                                  : void
    {
        $this->questions = $questions;
    }

References $questions.

Referenced by getUniqueQuestionCollection().

Here is the caller graph for this function:

◆ shuffleQuestions()

ilTestRandomQuestionSetQuestionCollection::shuffleQuestions ( )

Definition at line 98 of file class.ilTestRandomQuestionSetQuestionCollection.php.

    {
        shuffle($this->questions);
    }

Referenced by ilTestRandomQuestionSetBuilder\handleQuestionOrdering().

Here is the caller graph for this function:

◆ valid()

ilTestRandomQuestionSetQuestionCollection::valid ( )

Definition at line 65 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                           : bool
    {
        return key($this->questions) !== null;
    }

References key().

Here is the call graph for this function:

Field Documentation

◆ $questions

ilTestRandomQuestionSetQuestionCollection::$questions = []

private

Definition at line 32 of file class.ilTestRandomQuestionSetQuestionCollection.php.

Referenced by getQuestions(), and setQuestions().

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

components/ILIAS/Test/classes/class.ilTestRandomQuestionSetQuestionCollection.php

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation

◆ addQuestion()

◆ current()

◆ getIntersectionCollection()

◆ getInvolvedQuestionIds()

◆ getMissingCount()

◆ getQuestionAmount()

◆ getQuestions()

◆ getRandomArrayKeys()

◆ getRandomQuestionCollection()

◆ getRelativeComplementCollection()

◆ getUniqueQuestionCollection()

◆ isGreaterThan()

◆ isSmallerThan()

◆ key()

◆ mergeQuestionCollection()

◆ next()

◆ rewind()

◆ setQuestions()

◆ shuffleQuestions()

◆ valid()

Field Documentation

◆ $questions