Inheritance diagram for ilTestRandomQuestionSetQuestionCollection:

Collaboration diagram for ilTestRandomQuestionSetQuestionCollection:

Public Member Functions
	setQuestions ($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 = array()

Detailed Description

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

Member Function Documentation

◆ addQuestion()

ilTestRandomQuestionSetQuestionCollection::addQuestion ( ilTestRandomQuestionSetQuestion $question )

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

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

◆ current()

ilTestRandomQuestionSetQuestionCollection::current ( )

Returns: ilTestRandomQuestionSetQuestion|false

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

    {
        return current($this->questions);
    }

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

                                            : array
    {
        $questionIds = array();
 
        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 95 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 176 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 37 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 206 of file class.ilTestRandomQuestionSetQuestionCollection.php.

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

Referenced by getRandomQuestionCollection().

Here is the caller graph for this function:

◆ getRandomQuestionCollection()

ilTestRandomQuestionSetQuestionCollection::getRandomQuestionCollection ( $requiredAmount )

Definition at line 193 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 132 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 114 of file class.ilTestRandomQuestionSetQuestionCollection.php.

                                                 : ilTestRandomQuestionSetQuestionCollection
    {
        $uniqueQuestions = array();
 
        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().

Here is the call graph for this function:

◆ isGreaterThan()

ilTestRandomQuestionSetQuestionCollection::isGreaterThan ( $amount )

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

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

◆ isSmallerThan()

ilTestRandomQuestionSetQuestionCollection::isSmallerThan ( $amount )

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

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

◆ key()

ilTestRandomQuestionSetQuestionCollection::key ( )

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

                         : string
    {
        return 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 109 of file class.ilTestRandomQuestionSetQuestionCollection.php.

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

◆ next()

ilTestRandomQuestionSetQuestionCollection::next ( )

Returns: ilTestRandomQuestionSetQuestion|false

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

    {
        return 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 ( )

Returns: ilTestRandomQuestionSetQuestion|false

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

    {
        return reset($this->questions);
    }

◆ setQuestions()

ilTestRandomQuestionSetQuestionCollection::setQuestions ( $questions )

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

    {
        $this->questions = $questions;
    }

References $questions.

◆ shuffleQuestions()

ilTestRandomQuestionSetQuestionCollection::shuffleQuestions ( )

Definition at line 104 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 68 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 = array()

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:

Modules/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