ilTestRandomQuestionSetQuestionCollection Class Reference

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.

Referenced by getIntersectionCollection(), and getRelativeComplementCollection().

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

Here is the caller graph for this function:

current()

ilTestRandomQuestionSetQuestionCollection::current

(

)

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

References null.

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

getIntersectionCollection()

ilTestRandomQuestionSetQuestionCollection::getIntersectionCollection

(

self

$questionCollection

)

Definition at line 153 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 176 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 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.

References getQuestions().

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

Here is the call graph for this function:

getQuestions()

ilTestRandomQuestionSetQuestionCollection::getQuestions

(

)

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

References $questions.

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

                                  : array
    {
        return $this->questions;
    }

Here is the caller graph for this function:

getRandomArrayKeys()

ilTestRandomQuestionSetQuestionCollection::getRandomArrayKeys (   $array,   $numKeys  )

private

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

(

$requiredAmount

)

Definition at line 187 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 126 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 108 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 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.

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

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.

References $questions.

Referenced by getUniqueQuestionCollection().

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

Here is the caller graph for this function:

shuffleQuestions()

ilTestRandomQuestionSetQuestionCollection::shuffleQuestions

(

)

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

References key(), and null.

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

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