ilTestRandomQuestionSetQuestionCollection Class Reference

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.

Referenced by getIntersectionCollection(), and getRelativeComplementCollection().

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

Here is the caller graph for this function:

current()

ilTestRandomQuestionSetQuestionCollection::current

(

)

Returns

ilTestRandomQuestionSetQuestion|false

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

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

getIntersectionCollection()

ilTestRandomQuestionSetQuestionCollection::getIntersectionCollection

(

self

$questionCollection

)

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

References getQuestions().

                                            : array
    {
        $questionIds = array();

        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 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.

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(), and getUniqueQuestionCollection().

                                  : array
    {
        return $this->questions;
    }

Here is the caller graph for this function:

getRandomArrayKeys()

ilTestRandomQuestionSetQuestionCollection::getRandomArrayKeys (   $array,   $numKeys  )

private

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

Referenced by getRandomQuestionCollection().

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

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

        return array( array_rand($array, $numKeys) );
    }

Here is the caller graph for this function:

getRandomQuestionCollection()

ilTestRandomQuestionSetQuestionCollection::getRandomQuestionCollection

(

$requiredAmount

)

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

References getQuestions().

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

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.

Referenced by valid().

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

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

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.

References $questions.

    {
        $this->questions = $questions;
    }

shuffleQuestions()

ilTestRandomQuestionSetQuestionCollection::shuffleQuestions

(

)

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