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

Member Function Documentation

◆ addQuestion()

ilTestRandomQuestionSetQuestionCollection::addQuestion ( ilTestRandomQuestionSetQuestion $question )

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

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

◆ current()

ilTestRandomQuestionSetQuestionCollection::current ( )

Definition at line 36 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 )

Parameters

ilTestRandomQuestionSetQuestionCollection $questionCollection

Returns: ilTestRandomQuestionSetQuestionCollection

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

    {
        $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 171 of file class.ilTestRandomQuestionSetQuestionCollection.php.

    {
        $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

Returns: int

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

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

Returns: int

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

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

References getQuestions().

Here is the call graph for this function:

◆ getQuestions()

ilTestRandomQuestionSetQuestionCollection::getQuestions ( )

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

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

    {
        $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 113 of file class.ilTestRandomQuestionSetQuestionCollection.php.

    {
        // 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 95 of file class.ilTestRandomQuestionSetQuestionCollection.php.

    {
        $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 62 of file class.ilTestRandomQuestionSetQuestionCollection.php.

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

◆ isSmallerThan()

ilTestRandomQuestionSetQuestionCollection::isSmallerThan ( $amount )

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

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

◆ key()

ilTestRandomQuestionSetQuestionCollection::key ( )

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

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

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

◆ next()

ilTestRandomQuestionSetQuestionCollection::next ( )

Definition at line 41 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 ( )

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

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

◆ setQuestions()

ilTestRandomQuestionSetQuestionCollection::setQuestions ( $questions )

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

    {
        $this->questions = $questions;
    }

References $questions.

◆ shuffleQuestions()

ilTestRandomQuestionSetQuestionCollection::shuffleQuestions ( )

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

    {
        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 17 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