Inheritance diagram for ilAssOrderingElementList:

Collaboration diagram for ilAssOrderingElementList:

Public Member Functions
	__construct ()
	ilAssOrderingElementList constructor. More...

	__clone ()
	clone list by additionally cloning the element objects More...

	getClone ()

	getQuestionId ()

	setQuestionId ($questionId)

	loadFromDb ()
	load elements from database More...

	clearElementContents ()
	clears the contents of all elements More...

	countElements ()

	isFirstElementPosition ($position)

	isLastElementPosition ($position)

	moveElementByPositions ($currentPosition, $targetPosition)

	removeElement (ilAssOrderingElement $removeElement)

	resetElements ()
	resets elements More...

	setElements ($elements)

	getElements ()

	getRandomIdentifierIndexedElements ()

	getRandomIdentifierIndex ()

	getSolutionIdentifierIndexedElements ()

	getSolutionIdentifierIndex ()

	addElement (ilAssOrderingElement $element)

	getElementByPosition ($position)

	elementExistByPosition ($position)

	getElementByRandomIdentifier ($randomIdentifier)

	elementExistByRandomIdentifier ($randomIdentifier)

	getElementBySolutionIdentifier ($solutionIdentifier)

	elementExistBySolutionIdentifier ($solutionIdentifier)

	distributeNewRandomIdentifiers ()

	hasSameElementSetByRandomIdentifiers (self $otherList)

	getParityTrueElementList (self $otherList)

	reorderByRandomIdentifiers ($randomIdentifiers)

	resetElementsIndentations ()
	resets the indentation to level 0 for all elements in list More...

	getDifferenceElementList (self $otherElementList)

	completeContentsFromElementList (self $otherList)

	current ()

	next ()

	key ()

	valid ()

	rewind ()

Static Public Member Functions
static	isValidSolutionIdentifier ($identifier)

static	isValidRandomIdentifier ($identifier)

static	isValidPosition ($position)

static	isValidIndentation ($indentation)

static	getFallbackDefaultElement ()

static	buildInstance ($questionId, $orderingElements=array())

Data Fields
	$objectInstanceId

const	SOLUTION_IDENTIFIER_BUILD_MAX_TRIES = 1000

const	SOLUTION_IDENTIFIER_VALUE_INTERVAL = 1

const	SOLUTION_IDENTIFIER_START_VALUE = 0

const	RANDOM_IDENTIFIER_BUILD_MAX_TRIES = 1000

const	RANDOM_IDENTIFIER_RANGE_LOWER_BOUND = 1

const	RANDOM_IDENTIFIER_RANGE_UPPER_BOUND = 100000

const	FALLBACK_DEFAULT_ELEMENT_RANDOM_IDENTIFIER = 0

const	JS_ADDED_ELEMENTS_RANDOM_IDENTIFIER_START_VALUE = -1

const	JS_ADDED_ELEMENTS_RANDOM_IDENTIFIER_VALUE_INTERVAL = -1

const	IDENTIFIER_TYPE_SOLUTION = 'SolutionIds'

const	IDENTIFIER_TYPE_RANDOM = 'RandomIds'

Static Public Attributes
static	$objectInstanceCounter = 0

Protected Member Functions
	getIndexedElements ($identifierType)

	getRegisteredSolutionIdentifiers ()

	getRegisteredRandomIdentifiers ()

	getRegisteredIdentifiers ($identifierType)

	hasValidIdentifiers (ilAssOrderingElement $element)

	ensureValidIdentifiers (ilAssOrderingElement $element)

	ensureValidIdentifier (ilAssOrderingElement $element, $identifierType)

	registerIdentifiers (ilAssOrderingElement $element)

	registerIdentifier (ilAssOrderingElement $element, $identifierType)

	isIdentifierRegistered (ilAssOrderingElement $element, $identifierType)

	fetchIdentifier (ilAssOrderingElement $element, $identifierType)

	populateIdentifier (ilAssOrderingElement $element, $identifierType, $identifier)

	isValidIdentifier ($identifierType, $identifier)

	buildIdentifier ($identifierType)

	throwUnknownIdentifierTypeException ($identifierType)

	throwCouldNotBuildRandomIdentifierException ($maxTries)

	throwMissingReorderPositionException ($randomIdentifier)

	throwUnknownRandomIdentifiersException ($randomIdentifiers)

	getLastSolutionIdentifier ()

	buildSolutionIdentifier ()

	buildRandomIdentifier ()

	getDifferenceRandomIdentifierIndex (self $otherElementList)

Protected Attributes
	$questionId

	$elements

Static Protected Attributes
static	$identifierRegistry

Detailed Description

Definition at line 12 of file class.ilAssOrderingElementList.php.

Constructor & Destructor Documentation

◆ __construct()

ilAssOrderingElementList::__construct ( )

ilAssOrderingElementList constructor.

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

References resetElements().

     {
         $this->objectInstanceId = ++self::$objectInstanceCounter;
         
         $this->questionId = null;
         $this->resetElements();
     }

Here is the call graph for this function:

Member Function Documentation

◆ __clone()

ilAssOrderingElementList::__clone ( )

clone list by additionally cloning the element objects

Definition at line 64 of file class.ilAssOrderingElementList.php.

References $elements, $key, and array.

     {
         $this->objectInstanceId = ++self::$objectInstanceCounter;
 
         $elements = array();
         
         foreach ($this as $key => $element) {
             $elements[$key] = clone $element;
         }
         
         $this->elements = $elements;
     }

◆ addElement()

ilAssOrderingElementList::addElement ( ilAssOrderingElement $element )

Parameters

ilAssOrderingElement $element

Definition at line 308 of file class.ilAssOrderingElementList.php.

References hasValidIdentifiers(), and registerIdentifiers().

Referenced by loadFromDb(), and setElements().

     {
         if ($this->hasValidIdentifiers($element)) {
             $this->registerIdentifiers($element);
         }
         
         $this->elements[] = $element;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildIdentifier()

ilAssOrderingElementList::buildIdentifier ( $identifierType )

protected

Parameters

string $identifierType

Returns: integer

Exceptions

ilTestQuestionPoolException

Definition at line 567 of file class.ilAssOrderingElementList.php.

References buildRandomIdentifier(), buildSolutionIdentifier(), and throwUnknownIdentifierTypeException().

Referenced by ensureValidIdentifier().

     {
         switch ($identifierType) {
             case self::IDENTIFIER_TYPE_SOLUTION: return $this->buildSolutionIdentifier();
             case self::IDENTIFIER_TYPE_RANDOM: return $this->buildRandomIdentifier();
         }
         
         $this->throwUnknownIdentifierTypeException($identifierType);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildInstance()

static ilAssOrderingElementList::buildInstance	(	$questionId,
		$orderingElements = `array()`
	)

static

Parameters

integer	$questionId
	array[ilAssOrderingElement]	$orderingElements

Returns: ilAssOrderingElementList

Definition at line 959 of file class.ilAssOrderingElementList.php.

References $questionId.

Referenced by assOrderingQuestion\fetchSolutionListFromFormSubmissionData(), ilAssOrderingTextsInputGUI\getElementList(), ilAssOrderingImagesInputGUI\getElementList(), ilAssNestedOrderingElementsInputGUI\getElementList(), and assOrderingQuestionGUI\removeElementImage().

     {
         $elementList = new self();
         
         $elementList->setQuestionId($questionId);
         $elementList->setElements($orderingElements);
         
         return $elementList;
     }

Here is the caller graph for this function:

◆ buildRandomIdentifier()

ilAssOrderingElementList::buildRandomIdentifier ( )

protected

Returns: int $randomIdentifier

Exceptions

ilTestQuestionPoolException

Definition at line 660 of file class.ilAssOrderingElementList.php.

References isIdentifierRegistered(), and throwCouldNotBuildRandomIdentifierException().

Referenced by buildIdentifier(), and distributeNewRandomIdentifiers().

     {
         $usedTriesCounter = 0;
         
         do {
             if ($usedTriesCounter >= self::RANDOM_IDENTIFIER_BUILD_MAX_TRIES) {
                 $this->throwCouldNotBuildRandomIdentifierException(self::RANDOM_IDENTIFIER_BUILD_MAX_TRIES);
             }
             
             $usedTriesCounter++;
             
             $lowerBound = self::RANDOM_IDENTIFIER_RANGE_LOWER_BOUND;
             $upperBound = self::RANDOM_IDENTIFIER_RANGE_UPPER_BOUND;
             $randomIdentifier = mt_rand($lowerBound, $upperBound);
             
             $testElement = new ilAssOrderingElement();
             $testElement->setRandomIdentifier($randomIdentifier);
         } while ($this->isIdentifierRegistered($testElement, self::IDENTIFIER_TYPE_RANDOM));
         
         return $randomIdentifier;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildSolutionIdentifier()

ilAssOrderingElementList::buildSolutionIdentifier ( )

protected

Returns: integer|null $nextSolutionIdentifier

Definition at line 643 of file class.ilAssOrderingElementList.php.

References getLastSolutionIdentifier().

Referenced by buildIdentifier().

     {
         $lastSolutionIdentifier = $this->getLastSolutionIdentifier();
         
         if ($lastSolutionIdentifier === null) {
             return 0;
         }
         
         $nextSolutionIdentifier = $lastSolutionIdentifier + self::SOLUTION_IDENTIFIER_VALUE_INTERVAL;
         
         return $nextSolutionIdentifier;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clearElementContents()

ilAssOrderingElementList::clearElementContents ( )

clears the contents of all elements

Definition at line 164 of file class.ilAssOrderingElementList.php.

     {
         foreach ($this as $orderingElement) {
             $orderingElement->setContent('');
         }
     }

◆ completeContentsFromElementList()

ilAssOrderingElementList::completeContentsFromElementList ( self $otherList )

Parameters

ilAssOrderingElementList $otherList

Definition at line 888 of file class.ilAssOrderingElementList.php.

     {
         foreach ($this as $thisElement) {
             if (!$otherList->elementExistByRandomIdentifier($thisElement->getRandomIdentifier())) {
                 continue;
             }
             
             $otherElement = $otherList->getElementByRandomIdentifier(
                 $thisElement->getRandomIdentifier()
             );
             
             $thisElement->setContent($otherElement->getContent());
         }
     }

◆ countElements()

ilAssOrderingElementList::countElements ( )

Definition at line 171 of file class.ilAssOrderingElementList.php.

Referenced by hasSameElementSetByRandomIdentifiers(), and isLastElementPosition().

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

Here is the caller graph for this function:

◆ current()

ilAssOrderingElementList::current ( )

Returns: ilAssOrderingElement

Definition at line 906 of file class.ilAssOrderingElementList.php.

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

◆ distributeNewRandomIdentifiers()

ilAssOrderingElementList::distributeNewRandomIdentifiers ( )

Definition at line 733 of file class.ilAssOrderingElementList.php.

References buildRandomIdentifier().

     {
         foreach ($this as $element) {
             $element->setRandomIdentifier($this->buildRandomIdentifier());
         }
     }

Here is the call graph for this function:

◆ elementExistByPosition()

ilAssOrderingElementList::elementExistByPosition ( $position )

Parameters

$position

Returns: bool

Definition at line 334 of file class.ilAssOrderingElementList.php.

References getElementByPosition().

     {
         return ($this->getElementByPosition($position) !== null);
     }

Here is the call graph for this function:

◆ elementExistByRandomIdentifier()

ilAssOrderingElementList::elementExistByRandomIdentifier ( $randomIdentifier )

Parameters

$randomIdentifier

Returns: bool

Definition at line 360 of file class.ilAssOrderingElementList.php.

References getElementByRandomIdentifier().

     {
         return ($this->getElementByRandomIdentifier($randomIdentifier) !== null);
     }

Here is the call graph for this function:

◆ elementExistBySolutionIdentifier()

ilAssOrderingElementList::elementExistBySolutionIdentifier ( $solutionIdentifier )

Parameters

$solutionIdentifier

Returns: bool

Definition at line 385 of file class.ilAssOrderingElementList.php.

References getElementBySolutionIdentifier().

     {
         return ($this->getElementBySolutionIdentifier($solutionIdentifier) !== null);
     }

Here is the call graph for this function:

◆ ensureValidIdentifier()

ilAssOrderingElementList::ensureValidIdentifier	(	ilAssOrderingElement	$element,
			$identifierType
	)

protected

Parameters

ilAssOrderingElement	$element
string	$identifierType

Definition at line 453 of file class.ilAssOrderingElementList.php.

References buildIdentifier(), fetchIdentifier(), isValidIdentifier(), populateIdentifier(), and registerIdentifier().

Referenced by ensureValidIdentifiers().

     {
         $identifier = $this->fetchIdentifier($element, $identifierType);
         
         if (!$this->isValidIdentifier($identifierType, $identifier)) {
             $identifier = $this->buildIdentifier($identifierType);
             $this->populateIdentifier($element, $identifierType, $identifier);
             $this->registerIdentifier($element, $identifierType);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensureValidIdentifiers()

ilAssOrderingElementList::ensureValidIdentifiers ( ilAssOrderingElement $element )

protected

Parameters

ilAssOrderingElement $element

Definition at line 443 of file class.ilAssOrderingElementList.php.

References ensureValidIdentifier().

Referenced by loadFromDb().

     {
         $this->ensureValidIdentifier($element, self::IDENTIFIER_TYPE_SOLUTION);
         $this->ensureValidIdentifier($element, self::IDENTIFIER_TYPE_RANDOM);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchIdentifier()

ilAssOrderingElementList::fetchIdentifier	(	ilAssOrderingElement	$element,
			$identifierType
	)

protected

Parameters

ilAssOrderingElement	$element
string	$identifierType

Returns: int

Exceptions

ilTestQuestionPoolException

Definition at line 518 of file class.ilAssOrderingElementList.php.

References ilAssOrderingElement\getRandomIdentifier(), ilAssOrderingElement\getSolutionIdentifier(), and throwUnknownIdentifierTypeException().

Referenced by ensureValidIdentifier(), getIndexedElements(), hasValidIdentifiers(), isIdentifierRegistered(), and registerIdentifier().

     {
         switch ($identifierType) {
             case self::IDENTIFIER_TYPE_SOLUTION: return $element->getSolutionIdentifier();
             case self::IDENTIFIER_TYPE_RANDOM: return $element->getRandomIdentifier();
         }
         
         $this->throwUnknownIdentifierTypeException($identifierType);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getClone()

ilAssOrderingElementList::getClone ( )

Returns: ilAssOrderingElementList

Definition at line 80 of file class.ilAssOrderingElementList.php.

     {
         $that = clone $this;
         return $that;
     }

◆ getDifferenceElementList()

ilAssOrderingElementList::getDifferenceElementList ( self $otherElementList )

Parameters

ilAssOrderingElementList $otherElementList

Returns: $differenceElementList ilAssOrderingElementList

Definition at line 856 of file class.ilAssOrderingElementList.php.

References getDifferenceRandomIdentifierIndex(), getElementByRandomIdentifier(), and getQuestionId().

     {
         $differenceRandomIdentifierIndex = $this->getDifferenceRandomIdentifierIndex($otherElementList);
         
         $differenceElementList = new self();
         $differenceElementList->setQuestionId($this->getQuestionId());
         
         foreach ($differenceRandomIdentifierIndex as $randomIdentifier) {
             $element = $this->getElementByRandomIdentifier($randomIdentifier);
             $differenceElementList->addElement($element);
         }
         
         return $differenceElementList;
     }

Here is the call graph for this function:

◆ getDifferenceRandomIdentifierIndex()

ilAssOrderingElementList::getDifferenceRandomIdentifierIndex ( self $otherElementList )

protected

Parameters

ilAssOrderingElementList $other

Returns: array

Definition at line 875 of file class.ilAssOrderingElementList.php.

References getRandomIdentifierIndex().

Referenced by getDifferenceElementList().

     {
         $differenceRandomIdentifierIndex = array_diff(
             $this->getRandomIdentifierIndex(),
             $otherElementList->getRandomIdentifierIndex()
         );
         
         return $differenceRandomIdentifierIndex;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getElementByPosition()

ilAssOrderingElementList::getElementByPosition ( $position )

Parameters

$randomIdentifier

Returns: ilAssOrderingElement

Definition at line 321 of file class.ilAssOrderingElementList.php.

Referenced by assOrderingQuestion\calculateReachedPointsForSolution(), elementExistByPosition(), and moveElementByPositions().

     {
         if (isset($this->elements[$position])) {
             return $this->elements[$position];
         }
         
         return null;
     }

Here is the caller graph for this function:

◆ getElementByRandomIdentifier()

ilAssOrderingElementList::getElementByRandomIdentifier ( $randomIdentifier )

Parameters

$randomIdentifier

Returns: ilAssOrderingElement

Definition at line 343 of file class.ilAssOrderingElementList.php.

Referenced by elementExistByRandomIdentifier(), and getDifferenceElementList().

     {
         foreach ($this as $element) {
             if ($element->getRandomIdentifier() != $randomIdentifier) {
                 continue;
             }
             
             return $element;
         }
         
         return null;
     }

Here is the caller graph for this function:

◆ getElementBySolutionIdentifier()

ilAssOrderingElementList::getElementBySolutionIdentifier ( $solutionIdentifier )

Parameters

$randomIdentifier

Returns: ilAssOrderingElement

Definition at line 369 of file class.ilAssOrderingElementList.php.

Referenced by elementExistBySolutionIdentifier().

     {
         foreach ($this as $element) {
             if ($element->getSolutionIdentifier() != $solutionIdentifier) {
                 continue;
             }
             
             return $element;
         }
         return null;
     }

Here is the caller graph for this function:

◆ getElements()

ilAssOrderingElementList::getElements ( )

Returns: array[ilAssOrderingElement]

Definition at line 254 of file class.ilAssOrderingElementList.php.

References $elements.

     {
         return $this->elements;
     }

◆ getFallbackDefaultElement()

static ilAssOrderingElementList::getFallbackDefaultElement ( )

static

Returns: ilAssOrderingElement

Definition at line 946 of file class.ilAssOrderingElementList.php.

Referenced by ilAssOrderingDefaultElementFallback\manipulateFormInputValues().

     {
         $element = new ilAssOrderingElement();
         $element->setRandomIdentifier(self::FALLBACK_DEFAULT_ELEMENT_RANDOM_IDENTIFIER);
 
         return $element;
     }

Here is the caller graph for this function:

◆ getIndexedElements()

ilAssOrderingElementList::getIndexedElements ( $identifierType )

protected

Returns: array

Definition at line 294 of file class.ilAssOrderingElementList.php.

References $elements, array, and fetchIdentifier().

Referenced by getRandomIdentifierIndexedElements(), and getSolutionIdentifierIndexedElements().

     {
         $elements = array();
         
         foreach ($this as $element) {
             $elements[$this->fetchIdentifier($element, $identifierType)] = $element;
         }
         
         return $elements;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLastSolutionIdentifier()

ilAssOrderingElementList::getLastSolutionIdentifier ( )

protected

Returns: integer|null $lastSolutionIdentifier

Definition at line 625 of file class.ilAssOrderingElementList.php.

References getRegisteredSolutionIdentifiers().

Referenced by buildSolutionIdentifier().

     {
         $lastSolutionIdentifier = null;
         
         foreach ($this->getRegisteredSolutionIdentifiers() as $registeredIdentifier) {
             if ($lastSolutionIdentifier > $registeredIdentifier) {
                 continue;
             }
             
             $lastSolutionIdentifier = $registeredIdentifier;
         }
         
         return $lastSolutionIdentifier;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getParityTrueElementList()

ilAssOrderingElementList::getParityTrueElementList ( self $otherList )

Definition at line 782 of file class.ilAssOrderingElementList.php.

References getQuestionId(), and hasSameElementSetByRandomIdentifiers().

     {
         if (!$this->hasSameElementSetByRandomIdentifiers($otherList)) {
             throw new ilTestQuestionPoolException('cannot compare lists having different element sets');
         }
         
         $parityTrueElementList = new self();
         $parityTrueElementList->setQuestionId($this->getQuestionId());
         
         foreach ($this as $thisElement) {
             $otherElement = $otherList->getElementByRandomIdentifier(
                 $thisElement->getRandomIdentifier()
             );
             
             if ($otherElement->getPosition() != $thisElement->getPosition()) {
                 continue;
             }
             
             if ($otherElement->getIndentation() != $thisElement->getIndentation()) {
                 continue;
             }
             
             $parityTrueElementList->addElement($thisElement);
         }
         
         return $parityTrueElementList;
     }

Here is the call graph for this function:

◆ getQuestionId()

ilAssOrderingElementList::getQuestionId ( )

Returns: integer

Definition at line 89 of file class.ilAssOrderingElementList.php.

References $questionId.

Referenced by getDifferenceElementList(), getParityTrueElementList(), getRegisteredIdentifiers(), isIdentifierRegistered(), loadFromDb(), moveElementByPositions(), registerIdentifier(), and removeElement().

     {
         return $this->questionId;
     }

Here is the caller graph for this function:

◆ getRandomIdentifierIndex()

ilAssOrderingElementList::getRandomIdentifierIndex ( )

Returns: array

Definition at line 270 of file class.ilAssOrderingElementList.php.

References getRandomIdentifierIndexedElements().

Referenced by getDifferenceRandomIdentifierIndex(), and hasSameElementSetByRandomIdentifiers().

     {
         return array_keys($this->getRandomIdentifierIndexedElements());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRandomIdentifierIndexedElements()

ilAssOrderingElementList::getRandomIdentifierIndexedElements ( )

Returns: array

Definition at line 262 of file class.ilAssOrderingElementList.php.

References getIndexedElements().

Referenced by getRandomIdentifierIndex(), ilAssOrderingTextsInputGUI\setElementList(), ilAssOrderingImagesInputGUI\setElementList(), and ilAssNestedOrderingElementsInputGUI\setElementList().

     {
         return $this->getIndexedElements(self::IDENTIFIER_TYPE_RANDOM);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRegisteredIdentifiers()

ilAssOrderingElementList::getRegisteredIdentifiers ( $identifierType )

protected

Parameters

string $identifierType

Returns: array

Definition at line 410 of file class.ilAssOrderingElementList.php.

References array, and getQuestionId().

Referenced by getRegisteredRandomIdentifiers(), and getRegisteredSolutionIdentifiers().

     {
         if (!isset(self::$identifierRegistry[$identifierType][$this->getQuestionId()])) {
             return array();
         }
         
         return self::$identifierRegistry[$identifierType][$this->getQuestionId()];
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRegisteredRandomIdentifiers()

ilAssOrderingElementList::getRegisteredRandomIdentifiers ( )

protected

Returns: array

Definition at line 401 of file class.ilAssOrderingElementList.php.

References getRegisteredIdentifiers().

     {
         return $this->getRegisteredIdentifiers(self::IDENTIFIER_TYPE_RANDOM);
     }

Here is the call graph for this function:

◆ getRegisteredSolutionIdentifiers()

ilAssOrderingElementList::getRegisteredSolutionIdentifiers ( )

protected

Returns: array

Definition at line 393 of file class.ilAssOrderingElementList.php.

References getRegisteredIdentifiers().

Referenced by getLastSolutionIdentifier().

     {
         return $this->getRegisteredIdentifiers(self::IDENTIFIER_TYPE_SOLUTION);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSolutionIdentifierIndex()

ilAssOrderingElementList::getSolutionIdentifierIndex ( )

Returns: array

Definition at line 286 of file class.ilAssOrderingElementList.php.

References getSolutionIdentifierIndexedElements().

     {
         return array_keys($this->getSolutionIdentifierIndexedElements());
     }

Here is the call graph for this function:

◆ getSolutionIdentifierIndexedElements()

ilAssOrderingElementList::getSolutionIdentifierIndexedElements ( )

Returns: array

Definition at line 278 of file class.ilAssOrderingElementList.php.

References getIndexedElements().

Referenced by getSolutionIdentifierIndex().

     {
         return $this->getIndexedElements(self::IDENTIFIER_TYPE_SOLUTION);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasSameElementSetByRandomIdentifiers()

ilAssOrderingElementList::hasSameElementSetByRandomIdentifiers ( self $otherList )

Parameters

ilAssOrderingElementList $otherList

Returns: bool $hasSameElements

Definition at line 744 of file class.ilAssOrderingElementList.php.

References countElements(), and getRandomIdentifierIndex().

Referenced by getParityTrueElementList().

     {
         $numIntersectingElements = count(array_intersect(
             $otherList->getRandomIdentifierIndex(),
             $this->getRandomIdentifierIndex()
         ));
         
         if ($numIntersectingElements != $this->countElements()) {
             return false;
         }
         
         if ($numIntersectingElements != $otherList->countElements()) {
             return false;
         }
         
         return true; // faster ;-)
         
         $otherListRandomIdentifierIndex = $otherList->getRandomIdentifierIndex();
         
         foreach ($this as $orderingElement) {
             if (!in_array($orderingElement->getRandomIdentifier(), $otherListRandomIdentifierIndex)) {
                 return false;
             }
             
             $randomIdentifierIndexMatchingsCount = count(array_keys(
                 $otherListRandomIdentifierIndex,
                 $orderingElement->getRandomIdentifier(),
                 false
             ));
             
             if ($randomIdentifierIndexMatchingsCount != 1) {
                 return false;
             }
         }
         
         return $this->countElements() == $otherList->countElements();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasValidIdentifiers()

ilAssOrderingElementList::hasValidIdentifiers ( ilAssOrderingElement $element )

protected

Parameters

ilAssOrderingElement $element

Returns: bool

Definition at line 423 of file class.ilAssOrderingElementList.php.

References fetchIdentifier(), and isValidIdentifier().

Referenced by addElement().

     {
         $identifier = $this->fetchIdentifier($element, self::IDENTIFIER_TYPE_SOLUTION);
 
         if (!$this->isValidIdentifier(self::IDENTIFIER_TYPE_SOLUTION, $identifier)) {
             return false;
         }
         
         $identifier = $this->fetchIdentifier($element, self::IDENTIFIER_TYPE_RANDOM);
 
         if (!$this->isValidIdentifier(self::IDENTIFIER_TYPE_RANDOM, $identifier)) {
             return false;
         }
         
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isFirstElementPosition()

ilAssOrderingElementList::isFirstElementPosition ( $position )

Definition at line 176 of file class.ilAssOrderingElementList.php.

     {
         return $position == 0;
     }

◆ isIdentifierRegistered()

ilAssOrderingElementList::isIdentifierRegistered	(	ilAssOrderingElement	$element,
			$identifierType
	)

protected

Parameters

ilAssOrderingElement	$element
string	$identifierType

Returns: bool

Exceptions

ilTestQuestionPoolException

Definition at line 497 of file class.ilAssOrderingElementList.php.

References fetchIdentifier(), and getQuestionId().

Referenced by buildRandomIdentifier().

     {
         if (!isset(self::$identifierRegistry[$identifierType][$this->getQuestionId()])) {
             return false;
         }
         
         $identifier = $this->fetchIdentifier($element, $identifierType);
         
         if (!in_array($identifier, self::$identifierRegistry[$identifierType][$this->getQuestionId()])) {
             return false;
         }
         
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isLastElementPosition()

ilAssOrderingElementList::isLastElementPosition ( $position )

Definition at line 181 of file class.ilAssOrderingElementList.php.

References countElements().

     {
         return $position == ($this->countElements() - 1);
     }

Here is the call graph for this function:

◆ isValidIdentifier()

ilAssOrderingElementList::isValidIdentifier	(	$identifierType,
		$identifier
	)

protected

Parameters

string	$identifierType
	$identifier

Returns: mixed

Exceptions

ilTestQuestionPoolException

Definition at line 549 of file class.ilAssOrderingElementList.php.

References throwUnknownIdentifierTypeException().

Referenced by ensureValidIdentifier(), and hasValidIdentifiers().

     {
         switch ($identifierType) {
             case self::IDENTIFIER_TYPE_SOLUTION:
                 return self::isValidSolutionIdentifier($identifier);
             
             case self::IDENTIFIER_TYPE_RANDOM:
                 return self::isValidRandomIdentifier($identifier);
         }
         
         $this->throwUnknownIdentifierTypeException($identifierType);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isValidIndentation()

static ilAssOrderingElementList::isValidIndentation ( $indentation )

static

Definition at line 725 of file class.ilAssOrderingElementList.php.

Referenced by ilAssOrderingElement\isExportIdent().

     {
         return self::isValidPosition($indentation); // horizontal position ^^
     }

Here is the caller graph for this function:

◆ isValidPosition()

static ilAssOrderingElementList::isValidPosition ( $position )

static

Definition at line 720 of file class.ilAssOrderingElementList.php.

Referenced by ilAssOrderingElement\isExportIdent().

     {
         return self::isValidSolutionIdentifier($position); // this was the position earlier
     }

Here is the caller graph for this function:

◆ isValidRandomIdentifier()

static ilAssOrderingElementList::isValidRandomIdentifier ( $identifier )

static

Definition at line 699 of file class.ilAssOrderingElementList.php.

Referenced by ilAssOrderingElement\isExportIdent().

     {
         if (!is_numeric($identifier)) {
             return false;
         }
         
         if ($identifier != (int) $identifier) {
             return false;
         }
         
         if ($identifier < self::RANDOM_IDENTIFIER_RANGE_LOWER_BOUND) {
             return false;
         }
         
         if ($identifier > self::RANDOM_IDENTIFIER_RANGE_UPPER_BOUND) {
             return false;
         }
         
         return true;
     }

Here is the caller graph for this function:

◆ isValidSolutionIdentifier()

static ilAssOrderingElementList::isValidSolutionIdentifier ( $identifier )

static

Definition at line 682 of file class.ilAssOrderingElementList.php.

Referenced by ilAssOrderingElement\isExportIdent().

     {
         if (!is_numeric($identifier)) {
             return false;
         }
         
         if ($identifier != (int) $identifier) {
             return false;
         }
         
         if ($identifier < 0) {
             return false;
         }
         
         return true;
     }

Here is the caller graph for this function:

◆ key()

ilAssOrderingElementList::key ( )

Returns: integer|bool

Definition at line 922 of file class.ilAssOrderingElementList.php.

Referenced by valid().

     {
         return key($this->elements);
     }

Here is the caller graph for this function:

◆ loadFromDb()

ilAssOrderingElementList::loadFromDb ( )

load elements from database

Definition at line 105 of file class.ilAssOrderingElementList.php.

References $GLOBALS, $ilDB, $result, $row, addElement(), array, ensureValidIdentifiers(), getQuestionId(), registerIdentifiers(), and time.

     {
         $ilDB = isset($GLOBALS['DIC']) ? $GLOBALS['DIC']['ilDB'] : $GLOBALS['ilDB'];
         
         $result = $ilDB->queryF(
             "SELECT * FROM qpl_a_ordering WHERE question_fi = %s ORDER BY position ASC",
             array('integer'),
             array($this->getQuestionId())
         );
         
         while ($row = $ilDB->fetchAssoc($result)) {
             $element = new ilAssOrderingElement();
             
             $element->setRandomIdentifier($row['random_id']);
             $element->setSolutionIdentifier($row['solution_key']);
             
             $element->setPosition($row['position']);
             $element->setIndentation($row["depth"]);
             
             $element->setContent($row['answertext']);
             
             $this->addElement($element);
             $this->registerIdentifiers($element);
         }
     }

Here is the call graph for this function:

◆ moveElementByPositions()

ilAssOrderingElementList::moveElementByPositions	(	$currentPosition,
		$targetPosition
	)

Definition at line 186 of file class.ilAssOrderingElementList.php.

References getElementByPosition(), getQuestionId(), and setElements().

     {
         $movingElement = $this->getElementByPosition($currentPosition);
         $dodgingElement = $this->getElementByPosition($targetPosition);
         
         $elementList = new self();
         $elementList->setQuestionId($this->getQuestionId());
         
         foreach ($this as $element) {
             if ($element->getPosition() == $currentPosition) {
                 $elementList->addElement($dodgingElement);
                 continue;
             }
             
             if ($element->getPosition() == $targetPosition) {
                 $elementList->addElement($movingElement);
                 continue;
             }
             
             $elementList->addElement($element);
         }
         
         $dodgingElement->setPosition($currentPosition);
         $movingElement->setPosition($targetPosition);
         
         $this->setElements($elementList->getElements());
     }

Here is the call graph for this function:

◆ next()

ilAssOrderingElementList::next ( )

Returns: ilAssOrderingElement

Definition at line 914 of file class.ilAssOrderingElementList.php.

     {
         return next($this->elements);
     }

◆ populateIdentifier()

ilAssOrderingElementList::populateIdentifier	(	ilAssOrderingElement	$element,
			$identifierType,
			$identifier
	)

protected

Parameters

ilAssOrderingElement	$element
string	$identifierType
	$identifier

Exceptions

ilTestQuestionPoolException

Definition at line 534 of file class.ilAssOrderingElementList.php.

References ilAssOrderingElement\setRandomIdentifier(), ilAssOrderingElement\setSolutionIdentifier(), and throwUnknownIdentifierTypeException().

Referenced by ensureValidIdentifier().

     {
         switch ($identifierType) {
             case self::IDENTIFIER_TYPE_SOLUTION: $element->setSolutionIdentifier($identifier); break;
             case self::IDENTIFIER_TYPE_RANDOM: $element->setRandomIdentifier($identifier); break;
             default: $this->throwUnknownIdentifierTypeException($identifierType);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ registerIdentifier()

ilAssOrderingElementList::registerIdentifier	(	ilAssOrderingElement	$element,
			$identifierType
	)

protected

Parameters

ilAssOrderingElement	$element
string	$identifierType

Exceptions

ilTestQuestionPoolException

Definition at line 478 of file class.ilAssOrderingElementList.php.

References array, fetchIdentifier(), and getQuestionId().

Referenced by ensureValidIdentifier(), and registerIdentifiers().

     {
         if (!isset(self::$identifierRegistry[$identifierType][$this->getQuestionId()])) {
             self::$identifierRegistry[$identifierType][$this->getQuestionId()] = array();
         }
         
         $identifier = $this->fetchIdentifier($element, $identifierType);
         
         if (!in_array($identifier, self::$identifierRegistry[$identifierType][$this->getQuestionId()])) {
             self::$identifierRegistry[$identifierType][$this->getQuestionId()][] = $identifier;
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ registerIdentifiers()

ilAssOrderingElementList::registerIdentifiers ( ilAssOrderingElement $element )

protected

Parameters

ilAssOrderingElement $element

Definition at line 467 of file class.ilAssOrderingElementList.php.

References registerIdentifier().

Referenced by addElement(), and loadFromDb().

     {
         $this->registerIdentifier($element, self::IDENTIFIER_TYPE_SOLUTION);
         $this->registerIdentifier($element, self::IDENTIFIER_TYPE_RANDOM);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeElement()

ilAssOrderingElementList::removeElement ( ilAssOrderingElement $removeElement )

Definition at line 214 of file class.ilAssOrderingElementList.php.

References getQuestionId().

     {
         $elementList = new self();
         $elementList->setQuestionId($this->getQuestionId());
         
         $positionCounter = 0;
         
         foreach ($this as $element) {
             if ($element->isSameElement($removeElement)) {
                 continue;
             }
             
             $element->setPosition($positionCounter++);
             $elementList->addElement($element);
         }
     }

Here is the call graph for this function:

◆ reorderByRandomIdentifiers()

ilAssOrderingElementList::reorderByRandomIdentifiers ( $randomIdentifiers )

Parameters

$randomIdentifiers

Returns: ilAssOrderingElementList

Exceptions

ilTestQuestionPoolException

Definition at line 815 of file class.ilAssOrderingElementList.php.

References array, setElements(), throwMissingReorderPositionException(), and throwUnknownRandomIdentifiersException().

     {
         $positionsMap = array_flip(array_values($randomIdentifiers));
         
         $orderedElements = array();
         
         foreach ($this as $element) {
             if (!isset($positionsMap[$element->getRandomIdentifier()])) {
                 $this->throwMissingReorderPositionException($element->getRandomIdentifier());
             }
             
             $position = $positionsMap[$element->getRandomIdentifier()];
             unset($positionsMap[$element->getRandomIdentifier()]);
             
             $element->setPosition($position);
             $orderedElements[$position] = $element;
         }
         
         if (count($positionsMap)) {
             $this->throwUnknownRandomIdentifiersException(array_keys($positionsMap));
         }
         
         ksort($orderedElements);
         
         $this->setElements(array_values($orderedElements));
     }

Here is the call graph for this function:

◆ resetElements()

ilAssOrderingElementList::resetElements ( )

resets elements

Definition at line 234 of file class.ilAssOrderingElementList.php.

References array.

Referenced by __construct(), and setElements().

     {
         $this->elements = array();
     }

Here is the caller graph for this function:

◆ resetElementsIndentations()

ilAssOrderingElementList::resetElementsIndentations ( )

resets the indentation to level 0 for all elements in list

Definition at line 845 of file class.ilAssOrderingElementList.php.

     {
         foreach ($this as $element) {
             $element->setIndentation(0);
         }
     }

◆ rewind()

ilAssOrderingElementList::rewind ( )

Returns: ilAssOrderingElement

Definition at line 938 of file class.ilAssOrderingElementList.php.

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

◆ setElements()

ilAssOrderingElementList::setElements ( $elements )

Parameters

$elements

Definition at line 242 of file class.ilAssOrderingElementList.php.

References $elements, addElement(), and resetElements().

Referenced by moveElementByPositions(), and reorderByRandomIdentifiers().

     {
         $this->resetElements();
         
         foreach ($elements as $element) {
             $this->addElement($element);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setQuestionId()

ilAssOrderingElementList::setQuestionId ( $questionId )

Parameters

integer $questionId

Definition at line 97 of file class.ilAssOrderingElementList.php.

References $questionId.

     {
         $this->questionId = $questionId;
     }

◆ throwCouldNotBuildRandomIdentifierException()

ilAssOrderingElementList::throwCouldNotBuildRandomIdentifierException ( $maxTries )

protected

Parameters

string $identifierType

Exceptions

ilTestQuestionPoolException

Definition at line 592 of file class.ilAssOrderingElementList.php.

Referenced by buildRandomIdentifier().

     {
         throw new ilTestQuestionPoolException(
             "could not build random identifier (max tries: $maxTries)"
         );
     }

Here is the caller graph for this function:

◆ throwMissingReorderPositionException()

ilAssOrderingElementList::throwMissingReorderPositionException ( $randomIdentifier )

protected

Parameters

string $randomIdentifier

Exceptions

ilTestQuestionPoolException

Definition at line 603 of file class.ilAssOrderingElementList.php.

Referenced by reorderByRandomIdentifiers().

     {
         throw new ilTestQuestionPoolException(
             "cannot reorder element due to missing position (random identifier: $randomIdentifier)"
         );
     }

Here is the caller graph for this function:

◆ throwUnknownIdentifierTypeException()

ilAssOrderingElementList::throwUnknownIdentifierTypeException ( $identifierType )

protected

Parameters

string $identifierType

Exceptions

ilTestQuestionPoolException

Definition at line 581 of file class.ilAssOrderingElementList.php.

Referenced by buildIdentifier(), fetchIdentifier(), isValidIdentifier(), and populateIdentifier().

     {
         throw new ilTestQuestionPoolException(
             "unknown identifier type given (type: $identifierType)"
         );
     }

Here is the caller graph for this function:

◆ throwUnknownRandomIdentifiersException()

ilAssOrderingElementList::throwUnknownRandomIdentifiersException ( $randomIdentifiers )

protected

Parameters

array $randomIdentifiers

Exceptions

ilTestQuestionPoolException

Definition at line 614 of file class.ilAssOrderingElementList.php.

Referenced by reorderByRandomIdentifiers().

     {
         throw new ilTestQuestionPoolException(
             'cannot reorder element due to one or more unknown random identifiers ' .
             '(' . implode(', ', $randomIdentifiers) . ')'
         );
     }

Here is the caller graph for this function:

◆ valid()

ilAssOrderingElementList::valid ( )

Returns: bool

Definition at line 930 of file class.ilAssOrderingElementList.php.

References key().

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

Here is the call graph for this function:

Field Documentation

◆ $elements

ilAssOrderingElementList::$elements

protected

Definition at line 48 of file class.ilAssOrderingElementList.php.

Referenced by __clone(), getElements(), getIndexedElements(), and setElements().

◆ $identifierRegistry

ilAssOrderingElementList::$identifierRegistry

staticprotected

Initial value:

= array(
        self::IDENTIFIER_TYPE_SOLUTION => array(),
        self::IDENTIFIER_TYPE_RANDOM => array()
    )

Definition at line 35 of file class.ilAssOrderingElementList.php.

◆ $objectInstanceCounter

ilAssOrderingElementList::$objectInstanceCounter = 0

static

Definition at line 14 of file class.ilAssOrderingElementList.php.

◆ $objectInstanceId

ilAssOrderingElementList::$objectInstanceId

Definition at line 15 of file class.ilAssOrderingElementList.php.

◆ $questionId

ilAssOrderingElementList::$questionId

protected

Definition at line 43 of file class.ilAssOrderingElementList.php.

Referenced by buildInstance(), getQuestionId(), and setQuestionId().

◆ FALLBACK_DEFAULT_ELEMENT_RANDOM_IDENTIFIER

const ilAssOrderingElementList::FALLBACK_DEFAULT_ELEMENT_RANDOM_IDENTIFIER = 0

Definition at line 25 of file class.ilAssOrderingElementList.php.

◆ IDENTIFIER_TYPE_RANDOM

const ilAssOrderingElementList::IDENTIFIER_TYPE_RANDOM = 'RandomIds'

Definition at line 30 of file class.ilAssOrderingElementList.php.

◆ IDENTIFIER_TYPE_SOLUTION

const ilAssOrderingElementList::IDENTIFIER_TYPE_SOLUTION = 'SolutionIds'

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

◆ JS_ADDED_ELEMENTS_RANDOM_IDENTIFIER_START_VALUE

const ilAssOrderingElementList::JS_ADDED_ELEMENTS_RANDOM_IDENTIFIER_START_VALUE = -1

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

◆ JS_ADDED_ELEMENTS_RANDOM_IDENTIFIER_VALUE_INTERVAL

const ilAssOrderingElementList::JS_ADDED_ELEMENTS_RANDOM_IDENTIFIER_VALUE_INTERVAL = -1

Definition at line 27 of file class.ilAssOrderingElementList.php.

◆ RANDOM_IDENTIFIER_BUILD_MAX_TRIES

const ilAssOrderingElementList::RANDOM_IDENTIFIER_BUILD_MAX_TRIES = 1000

Definition at line 21 of file class.ilAssOrderingElementList.php.

◆ RANDOM_IDENTIFIER_RANGE_LOWER_BOUND

const ilAssOrderingElementList::RANDOM_IDENTIFIER_RANGE_LOWER_BOUND = 1

Definition at line 22 of file class.ilAssOrderingElementList.php.

◆ RANDOM_IDENTIFIER_RANGE_UPPER_BOUND

const ilAssOrderingElementList::RANDOM_IDENTIFIER_RANGE_UPPER_BOUND = 100000

Definition at line 23 of file class.ilAssOrderingElementList.php.

◆ SOLUTION_IDENTIFIER_BUILD_MAX_TRIES

const ilAssOrderingElementList::SOLUTION_IDENTIFIER_BUILD_MAX_TRIES = 1000

Definition at line 17 of file class.ilAssOrderingElementList.php.

◆ SOLUTION_IDENTIFIER_START_VALUE

const ilAssOrderingElementList::SOLUTION_IDENTIFIER_START_VALUE = 0

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

◆ SOLUTION_IDENTIFIER_VALUE_INTERVAL

const ilAssOrderingElementList::SOLUTION_IDENTIFIER_VALUE_INTERVAL = 1

Definition at line 18 of file class.ilAssOrderingElementList.php.

The documentation for this class was generated from the following file:

Modules/TestQuestionPool/classes/questions/class.ilAssOrderingElementList.php

Public Member Functions

Static Public Member Functions

Data Fields

Static Public Attributes

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __clone()

◆ addElement()

◆ buildIdentifier()

◆ buildInstance()

◆ buildRandomIdentifier()

◆ buildSolutionIdentifier()

◆ clearElementContents()

◆ completeContentsFromElementList()

◆ countElements()

◆ current()

◆ distributeNewRandomIdentifiers()

◆ elementExistByPosition()

◆ elementExistByRandomIdentifier()

◆ elementExistBySolutionIdentifier()

◆ ensureValidIdentifier()

◆ ensureValidIdentifiers()

◆ fetchIdentifier()

◆ getClone()

◆ getDifferenceElementList()

◆ getDifferenceRandomIdentifierIndex()

◆ getElementByPosition()

◆ getElementByRandomIdentifier()

◆ getElementBySolutionIdentifier()

◆ getElements()

◆ getFallbackDefaultElement()

◆ getIndexedElements()

◆ getLastSolutionIdentifier()

◆ getParityTrueElementList()

◆ getQuestionId()

◆ getRandomIdentifierIndex()

◆ getRandomIdentifierIndexedElements()

◆ getRegisteredIdentifiers()

◆ getRegisteredRandomIdentifiers()

◆ getRegisteredSolutionIdentifiers()

◆ getSolutionIdentifierIndex()

◆ getSolutionIdentifierIndexedElements()

◆ hasSameElementSetByRandomIdentifiers()

◆ hasValidIdentifiers()

◆ isFirstElementPosition()

◆ isIdentifierRegistered()

◆ isLastElementPosition()

◆ isValidIdentifier()

◆ isValidIndentation()

◆ isValidPosition()

◆ isValidRandomIdentifier()

◆ isValidSolutionIdentifier()

◆ key()

◆ loadFromDb()

◆ moveElementByPositions()

◆ next()

◆ populateIdentifier()

◆ registerIdentifier()

◆ registerIdentifiers()

◆ removeElement()

◆ reorderByRandomIdentifiers()

◆ resetElements()

◆ resetElementsIndentations()

◆ rewind()

◆ setElements()

◆ setQuestionId()

◆ throwCouldNotBuildRandomIdentifierException()

◆ throwMissingReorderPositionException()

◆ throwUnknownIdentifierTypeException()

◆ throwUnknownRandomIdentifiersException()

◆ valid()

Field Documentation

◆ $elements

◆ $identifierRegistry

◆ $objectInstanceCounter