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 (int $requiredAmount)

Private Member Functions
	getRandomArrayKeys (array $array, int $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 42 of file class.ilTestRandomQuestionSetQuestionCollection.php.

Referenced by getIntersectionCollection(), and getRelativeComplementCollection().

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

Here is the caller graph for this function:

◆ current()

ilTestRandomQuestionSetQuestionCollection::current ( )

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

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

◆ getIntersectionCollection()

ilTestRandomQuestionSetQuestionCollection::getIntersectionCollection ( self $questionCollection )

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

References addQuestion(), and getQuestions().

                                                                        : 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;
     }

Here is the call graph for this function:

◆ getInvolvedQuestionIds()

ilTestRandomQuestionSetQuestionCollection::getInvolvedQuestionIds ( )

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

References getQuestions().

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

Here is the call graph for this function:

◆ getMissingCount()

ilTestRandomQuestionSetQuestionCollection::getMissingCount ( $requiredAmount )

Parameters

int $requiredAmount

Definition at line 87 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 168 of file class.ilTestRandomQuestionSetQuestionCollection.php.

References getQuestions().

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

Here is the call graph for this function:

◆ getQuestions()

ilTestRandomQuestionSetQuestionCollection::getQuestions ( )

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

References $questions.

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

                                   : array
     {
         return $this->questions;
     }

Here is the caller graph for this function:

◆ getRandomArrayKeys()

ilTestRandomQuestionSetQuestionCollection::getRandomArrayKeys	(	array	$array,
		int	$numKeys
	)

private

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

Referenced by getRandomQuestionCollection().

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

Here is the caller graph for this function:

◆ getRandomQuestionCollection()

ilTestRandomQuestionSetQuestionCollection::getRandomQuestionCollection ( int $requiredAmount )

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

References getRandomArrayKeys().

Referenced by ilTestRandomQuestionSetBuilder\fetchQuestionsFromStageRandomly().

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

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 124 of file class.ilTestRandomQuestionSetQuestionCollection.php.

References addQuestion(), and getQuestions().

                                                                              : 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;
     }

Here is the call graph for this function:

◆ getUniqueQuestionCollection()

ilTestRandomQuestionSetQuestionCollection::getUniqueQuestionCollection ( )

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

References getQuestions(), and setQuestions().

                                                  : 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;
     }

Here is the call graph for this function:

◆ isGreaterThan()

ilTestRandomQuestionSetQuestionCollection::isGreaterThan ( $amount )

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

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

◆ isSmallerThan()

ilTestRandomQuestionSetQuestionCollection::isSmallerThan ( $amount )

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

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

◆ key()

ilTestRandomQuestionSetQuestionCollection::key ( )

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

Referenced by valid().

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

Here is the caller graph for this function:

◆ mergeQuestionCollection()

ilTestRandomQuestionSetQuestionCollection::mergeQuestionCollection ( self $questionCollection )

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

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

◆ next()

ilTestRandomQuestionSetQuestionCollection::next ( )

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

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

◆ rewind()

ilTestRandomQuestionSetQuestionCollection::rewind ( )

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

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

◆ setQuestions()

ilTestRandomQuestionSetQuestionCollection::setQuestions ( array $questions )

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

References $questions.

Referenced by getUniqueQuestionCollection().

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

Here is the caller graph for this function:

◆ shuffleQuestions()

ilTestRandomQuestionSetQuestionCollection::shuffleQuestions ( )

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

Referenced by ilTestRandomQuestionSetBuilder\handleQuestionOrdering().

     {
         shuffle($this->questions);
     }

Here is the caller graph for this function:

◆ valid()

ilTestRandomQuestionSetQuestionCollection::valid ( )

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

References key().

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

Here is the call graph for this function:

Field Documentation

◆ $questions

ilTestRandomQuestionSetQuestionCollection::$questions = []

private

Definition at line 30 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