Inheritance diagram for ilAssOrderingElementList:

Collaboration diagram for ilAssOrderingElementList:

Public Member Functions
	__construct (int $question_id=null, array $elements=[])
	ilAssOrderingElementList constructor. More...

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

	getClone ()

	getQuestionId ()

	setQuestionId ($question_id)

	countElements ()

	hasElements ()

	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)

	ensureValidIdentifiers (ilAssOrderingElement $element)

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

	getHash ()

	withElements (array $elements)

	withQuestionId (int $question_id)

Static Public Member Functions
static	isValidSolutionIdentifier ($identifier)

static	isValidRandomIdentifier ($identifier)

static	isValidPosition ($position)

static	isValidIndentation ($indentation)

static	getFallbackDefaultElement ()

static	buildInstance (int $question_id, array $elements=[])

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)

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

	$elements

Static Protected Attributes
static	$identifierRegistry

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilAssOrderingElementList::__construct	(	int	$question_id = `null`,
		array	$elements = `[]`
	)

ilAssOrderingElementList constructor.

Parameters

ilAssOrderingElement[] $elements

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

      {
        $this->objectInstanceId = ++self::$objectInstanceCounter;
 
        $this->question_id = $question_id;
        $this->elements = $elements;
    }

References $elements, $objectInstanceCounter, and $question_id.

Member Function Documentation

◆ __clone()

ilAssOrderingElementList::__clone ( )

clone list by additionally cloning the element objects

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

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

References $elements, and $objectInstanceCounter.

◆ addElement()

ilAssOrderingElementList::addElement ( ilAssOrderingElement $element )

Parameters

ilAssOrderingElement $element

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

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

References hasValidIdentifiers(), and registerIdentifiers().

Referenced by setElements().

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 505 of file class.ilAssOrderingElementList.php.

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

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

Referenced by ensureValidIdentifier().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildInstance()

static ilAssOrderingElementList::buildInstance	(	int	$question_id,
		array	$elements = `[]`
	)

static

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

                                                                                 : ilAssOrderingElementList
    {
        $elementList = new self();
        
        $elementList->setQuestionId($question_id);
        $elementList->setElements($elements);
        
        return $elementList;
    }

References $elements, $question_id, and setQuestionId().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildRandomIdentifier()

ilAssOrderingElementList::buildRandomIdentifier ( )

protected

Returns: int $randomIdentifier

Exceptions

ilTestQuestionPoolException

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

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

References isIdentifierRegistered(), RANDOM_IDENTIFIER_RANGE_LOWER_BOUND, RANDOM_IDENTIFIER_RANGE_UPPER_BOUND, and throwCouldNotBuildRandomIdentifierException().

Referenced by buildIdentifier(), and distributeNewRandomIdentifiers().

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 581 of file class.ilAssOrderingElementList.php.

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

References getLastSolutionIdentifier(), and SOLUTION_IDENTIFIER_VALUE_INTERVAL.

Referenced by buildIdentifier().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ completeContentsFromElementList()

ilAssOrderingElementList::completeContentsFromElementList ( self $otherList )

Parameters

ilAssOrderingElementList $otherList

Definition at line 775 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 105 of file class.ilAssOrderingElementList.php.

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

Referenced by hasElements(), hasSameElementSetByRandomIdentifiers(), and isLastElementPosition().

Here is the caller graph for this function:

◆ current()

ilAssOrderingElementList::current ( )

Returns: ilAssOrderingElement

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

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

References current().

Referenced by current().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ distributeNewRandomIdentifiers()

ilAssOrderingElementList::distributeNewRandomIdentifiers ( )

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

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

References buildRandomIdentifier().

Here is the call graph for this function:

◆ elementExistByPosition()

ilAssOrderingElementList::elementExistByPosition ( $position )

Parameters

$position

Returns: bool

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

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

References getElementByPosition().

Here is the call graph for this function:

◆ elementExistByRandomIdentifier()

ilAssOrderingElementList::elementExistByRandomIdentifier ( $randomIdentifier )

Parameters

$randomIdentifier

Returns: bool

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

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

References getElementByRandomIdentifier().

Here is the call graph for this function:

◆ elementExistBySolutionIdentifier()

ilAssOrderingElementList::elementExistBySolutionIdentifier ( $solutionIdentifier )

Parameters

$solutionIdentifier

Returns: bool

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

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

References getElementBySolutionIdentifier().

Here is the call graph for this function:

◆ ensureValidIdentifier()

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

protected

Parameters

ilAssOrderingElement	$element
string	$identifierType

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

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

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

Referenced by ensureValidIdentifiers().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensureValidIdentifiers()

ilAssOrderingElementList::ensureValidIdentifiers ( ilAssOrderingElement $element )

Parameters

ilAssOrderingElement $element

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

    {
        //TODO: remove!
        $this->ensureValidIdentifier($element, self::IDENTIFIER_TYPE_SOLUTION);
        $this->ensureValidIdentifier($element, self::IDENTIFIER_TYPE_RANDOM);
        return $element;
    }

References ensureValidIdentifier().

Referenced by assOrderingQuestion\setOrderingElementList().

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 456 of file class.ilAssOrderingElementList.php.

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getClone()

ilAssOrderingElementList::getClone ( )

Returns: ilAssOrderingElementList

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

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

◆ getDifferenceElementList()

ilAssOrderingElementList::getDifferenceElementList ( self $otherElementList )

Parameters

ilAssOrderingElementList $otherElementList

Returns: $differenceElementList ilAssOrderingElementList

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

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

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

Here is the call graph for this function:

◆ getDifferenceRandomIdentifierIndex()

ilAssOrderingElementList::getDifferenceRandomIdentifierIndex ( self $otherElementList )

protected

Parameters

ilAssOrderingElementList $other

Returns: array

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

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

References getRandomIdentifierIndex().

Referenced by getDifferenceElementList().

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 260 of file class.ilAssOrderingElementList.php.

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

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

Here is the caller graph for this function:

◆ getElementByRandomIdentifier()

ilAssOrderingElementList::getElementByRandomIdentifier ( $randomIdentifier )

Parameters

$randomIdentifier

Returns: ilAssOrderingElement

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

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

Referenced by elementExistByRandomIdentifier(), and getDifferenceElementList().

Here is the caller graph for this function:

◆ getElementBySolutionIdentifier()

ilAssOrderingElementList::getElementBySolutionIdentifier ( $solutionIdentifier )

Parameters

$randomIdentifier

Returns: ilAssOrderingElement

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

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

Referenced by elementExistBySolutionIdentifier().

Here is the caller graph for this function:

◆ getElements()

ilAssOrderingElementList::getElements ( )

Returns: ilAssOrderingElement[]

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

    {
        return $this->elements;
    }

References $elements.

Referenced by assOrderingQuestion\setOrderingElementList(), and ILIAS\TA\Questions\Ordering\assOrderingQuestionDatabaseRepository\updateOrderingList().

Here is the caller graph for this function:

◆ getFallbackDefaultElement()

static ilAssOrderingElementList::getFallbackDefaultElement ( )

static

Returns: ilAssOrderingElement

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

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

Referenced by ilAssOrderingDefaultElementFallback\manipulateFormInputValues().

Here is the caller graph for this function:

◆ getHash()

ilAssOrderingElementList::getHash ( )

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

    {
        $items = array();
        
        foreach ($this as $element) {
            $items[] = implode(':', array(
                $element->getSolutionIdentifier(),
                $element->getRandomIdentifier(),
                $element->getIndentation()
            ));
        }
        
        return md5(serialize($items));
    }

◆ getIndexedElements()

ilAssOrderingElementList::getIndexedElements ( $identifierType )

protected

Returns: array

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

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

References $elements, and fetchIdentifier().

Referenced by getRandomIdentifierIndexedElements(), and getSolutionIdentifierIndexedElements().

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 563 of file class.ilAssOrderingElementList.php.

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

References getRegisteredSolutionIdentifiers().

Referenced by buildSolutionIdentifier().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getParityTrueElementList()

ilAssOrderingElementList::getParityTrueElementList ( self $otherList )

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

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

References getQuestionId(), and hasSameElementSetByRandomIdentifiers().

Here is the call graph for this function:

◆ getQuestionId()

ilAssOrderingElementList::getQuestionId ( )

Returns: integer

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

    {
        return $this->question_id;
    }

References $question_id.

Referenced by getDifferenceElementList(), getParityTrueElementList(), getRegisteredIdentifiers(), isIdentifierRegistered(), moveElementByPositions(), registerIdentifier(), removeElement(), and ILIAS\TA\Questions\Ordering\assOrderingQuestionDatabaseRepository\updateOrderingList().

Here is the caller graph for this function:

◆ getRandomIdentifierIndex()

ilAssOrderingElementList::getRandomIdentifierIndex ( )

Returns: array

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

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

References getRandomIdentifierIndexedElements().

Referenced by getDifferenceRandomIdentifierIndex().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRandomIdentifierIndexedElements()

ilAssOrderingElementList::getRandomIdentifierIndexedElements ( )

Returns: array

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

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

References getIndexedElements().

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

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 346 of file class.ilAssOrderingElementList.php.

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

References getQuestionId().

Referenced by getRegisteredRandomIdentifiers(), and getRegisteredSolutionIdentifiers().

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 337 of file class.ilAssOrderingElementList.php.

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

References getRegisteredIdentifiers().

Here is the call graph for this function:

◆ getRegisteredSolutionIdentifiers()

ilAssOrderingElementList::getRegisteredSolutionIdentifiers ( )

protected

Returns: array

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

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

References getRegisteredIdentifiers().

Referenced by getLastSolutionIdentifier().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSolutionIdentifierIndex()

ilAssOrderingElementList::getSolutionIdentifierIndex ( )

Returns: array

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

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

References getSolutionIdentifierIndexedElements().

Here is the call graph for this function:

◆ getSolutionIdentifierIndexedElements()

ilAssOrderingElementList::getSolutionIdentifierIndexedElements ( )

Returns: array

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

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

References getIndexedElements().

Referenced by getSolutionIdentifierIndex().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasElements()

ilAssOrderingElementList::hasElements ( )

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

    {
        return (bool) $this->countElements();
    }

References countElements().

Here is the call graph for this function:

◆ hasSameElementSetByRandomIdentifiers()

ilAssOrderingElementList::hasSameElementSetByRandomIdentifiers ( self $otherList )

Parameters

ilAssOrderingElementList $otherList

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

                                                                          : bool
    {
        $numIntersectingElements = count(array_intersect(
            $otherList->getRandomIdentifierIndex(),
            $this->getRandomIdentifierIndex()
        ));
        
        return $numIntersectingElements == $this->countElements()
            && $numIntersectingElements == $otherList->countElements();
    }

References countElements().

Referenced by getParityTrueElementList().

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 359 of file class.ilAssOrderingElementList.php.

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

References fetchIdentifier(), and isValidIdentifier().

Referenced by addElement().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isFirstElementPosition()

ilAssOrderingElementList::isFirstElementPosition ( $position )

Definition at line 115 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 435 of file class.ilAssOrderingElementList.php.

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

References fetchIdentifier(), and getQuestionId().

Referenced by buildRandomIdentifier().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isLastElementPosition()

ilAssOrderingElementList::isLastElementPosition ( $position )

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

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

References countElements().

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 487 of file class.ilAssOrderingElementList.php.

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

References IDENTIFIER_TYPE_RANDOM, IDENTIFIER_TYPE_SOLUTION, isValidRandomIdentifier(), isValidSolutionIdentifier(), and throwUnknownIdentifierTypeException().

Referenced by ensureValidIdentifier(), and hasValidIdentifiers().

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 640 of file class.ilAssOrderingElementList.php.

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

References isValidPosition().

Referenced by ilAssOrderingElement\isExportIdent().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isValidPosition()

static ilAssOrderingElementList::isValidPosition ( $position )

static

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

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

References isValidSolutionIdentifier().

Referenced by ilAssOrderingElement\isExportIdent(), and isValidIndentation().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isValidRandomIdentifier()

static ilAssOrderingElementList::isValidRandomIdentifier ( $identifier )

static

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

                                                                : bool
    {
        return is_numeric($identifier)
            && $identifier == (int) $identifier
            && (int) $identifier >= self::RANDOM_IDENTIFIER_RANGE_LOWER_BOUND
            && (int) $identifier <= self::RANDOM_IDENTIFIER_RANGE_UPPER_BOUND;
    }

Referenced by ilAssOrderingElement\isExportIdent(), and isValidIdentifier().

Here is the caller graph for this function:

◆ isValidSolutionIdentifier()

static ilAssOrderingElementList::isValidSolutionIdentifier ( $identifier )

static

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

                                                                  : bool
    {
        return is_numeric($identifier)
            && $identifier == (int) $identifier
            && (int) $identifier >= 0;
    }

Referenced by ilAssOrderingElement\isExportIdent(), isValidIdentifier(), and isValidPosition().

Here is the caller graph for this function:

◆ key()

ilAssOrderingElementList::key ( )

Returns: integer|bool

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

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

References key().

Referenced by key(), and valid().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ moveElementByPositions()

ilAssOrderingElementList::moveElementByPositions	(	$currentPosition,
		$targetPosition
	)

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

    {
        $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());
    }

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

Here is the call graph for this function:

◆ next()

ilAssOrderingElementList::next ( )

Returns: ilAssOrderingElement

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

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

References next().

Referenced by next().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ populateIdentifier()

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

protected

Parameters

ilAssOrderingElement	$element
string	$identifierType
	$identifier

Exceptions

ilTestQuestionPoolException

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

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

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

Referenced by ensureValidIdentifier().

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 416 of file class.ilAssOrderingElementList.php.

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

References fetchIdentifier(), and getQuestionId().

Referenced by ensureValidIdentifier(), and registerIdentifiers().

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 405 of file class.ilAssOrderingElementList.php.

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

References registerIdentifier().

Referenced by addElement().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeElement()

ilAssOrderingElementList::removeElement ( ilAssOrderingElement $removeElement )

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

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

References getQuestionId().

Here is the call graph for this function:

◆ reorderByRandomIdentifiers()

ilAssOrderingElementList::reorderByRandomIdentifiers ( $randomIdentifiers )

Parameters

$randomIdentifiers

Returns: ilAssOrderingElementList

Exceptions

ilTestQuestionPoolException

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

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

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

Here is the call graph for this function:

◆ resetElements()

ilAssOrderingElementList::resetElements ( )

resets elements

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

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

Referenced by setElements().

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 732 of file class.ilAssOrderingElementList.php.

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

◆ rewind()

ilAssOrderingElementList::rewind ( )

Returns: ilAssOrderingElement

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

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

◆ setElements()

ilAssOrderingElementList::setElements ( $elements )

Parameters

$elements

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

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

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

Referenced by moveElementByPositions(), and reorderByRandomIdentifiers().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setQuestionId()

ilAssOrderingElementList::setQuestionId ( $question_id )

Parameters

integer $question_id

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

    {
        $this->question_id = $question_id;
    }

References $question_id.

Referenced by buildInstance().

Here is the caller graph for this function:

◆ throwCouldNotBuildRandomIdentifierException()

ilAssOrderingElementList::throwCouldNotBuildRandomIdentifierException ( $maxTries )

protected

Parameters

string $identifierType

Exceptions

ilTestQuestionPoolException

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

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

Referenced by buildRandomIdentifier().

Here is the caller graph for this function:

◆ throwMissingReorderPositionException()

ilAssOrderingElementList::throwMissingReorderPositionException ( $randomIdentifier )

protected

Parameters

string $randomIdentifier

Exceptions

ilTestQuestionPoolException

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

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

Referenced by reorderByRandomIdentifiers().

Here is the caller graph for this function:

◆ throwUnknownIdentifierTypeException()

ilAssOrderingElementList::throwUnknownIdentifierTypeException ( $identifierType )

protected

Parameters

string $identifierType

Exceptions

ilTestQuestionPoolException

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

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

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

Here is the caller graph for this function:

◆ throwUnknownRandomIdentifiersException()

ilAssOrderingElementList::throwUnknownRandomIdentifiersException ( $randomIdentifiers )

protected

Parameters

array $randomIdentifiers

Exceptions

ilTestQuestionPoolException

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

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

Referenced by reorderByRandomIdentifiers().

Here is the caller graph for this function:

◆ valid()

ilAssOrderingElementList::valid ( )

Returns: bool

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

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

References key().

Here is the call graph for this function:

◆ withElements()

ilAssOrderingElementList::withElements ( array $elements )

Parameters

ilAssOrderingElement[];

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

                                                  : self
    {
        $clone = clone $this;
        $clone->elements = $elements;
        return $clone;
    }

References $elements.

Referenced by assOrderingQuestion\setOrderingElementList(), and assOrderingQuestionTest\testOrderingElementListMutation().

Here is the caller graph for this function:

◆ withQuestionId()

ilAssOrderingElementList::withQuestionId ( int $question_id )

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

                                                     : self
    {
        $clone = clone $this;
        $clone->question_id = $question_id;
        return $clone;
    }

References $question_id.

Referenced by assOrderingQuestion\setOrderingElementList().

Here is the caller graph for this function:

Field Documentation

◆ $elements

ilAssOrderingElementList::$elements

protected

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

Referenced by __clone(), __construct(), buildInstance(), getElements(), getIndexedElements(), setElements(), and withElements().

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

Referenced by __clone(), and __construct().

◆ $objectInstanceId

ilAssOrderingElementList::$objectInstanceId

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

◆ $question_id

ilAssOrderingElementList::$question_id

protected

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

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

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

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

◆ IDENTIFIER_TYPE_SOLUTION

const ilAssOrderingElementList::IDENTIFIER_TYPE_SOLUTION = 'SolutionIds'

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

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

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

Referenced by buildRandomIdentifier().

◆ RANDOM_IDENTIFIER_RANGE_UPPER_BOUND

const ilAssOrderingElementList::RANDOM_IDENTIFIER_RANGE_UPPER_BOUND = 100000

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

Referenced by buildRandomIdentifier().

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

Referenced by buildSolutionIdentifier().

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

◆ completeContentsFromElementList()

◆ countElements()

◆ current()

◆ distributeNewRandomIdentifiers()

◆ elementExistByPosition()

◆ elementExistByRandomIdentifier()

◆ elementExistBySolutionIdentifier()

◆ ensureValidIdentifier()

◆ ensureValidIdentifiers()

◆ fetchIdentifier()

◆ getClone()

◆ getDifferenceElementList()

◆ getDifferenceRandomIdentifierIndex()

◆ getElementByPosition()

◆ getElementByRandomIdentifier()

◆ getElementBySolutionIdentifier()

◆ getElements()

◆ getFallbackDefaultElement()

◆ getHash()

◆ getIndexedElements()

◆ getLastSolutionIdentifier()

◆ getParityTrueElementList()

◆ getQuestionId()

◆ getRandomIdentifierIndex()

◆ getRandomIdentifierIndexedElements()

◆ getRegisteredIdentifiers()

◆ getRegisteredRandomIdentifiers()

◆ getRegisteredSolutionIdentifiers()

◆ getSolutionIdentifierIndex()

◆ getSolutionIdentifierIndexedElements()

◆ hasElements()

◆ hasSameElementSetByRandomIdentifiers()

◆ hasValidIdentifiers()

◆ isFirstElementPosition()

◆ isIdentifierRegistered()

◆ isLastElementPosition()

◆ isValidIdentifier()

◆ isValidIndentation()

◆ isValidPosition()

◆ isValidRandomIdentifier()

◆ isValidSolutionIdentifier()

◆ key()

◆ moveElementByPositions()

◆ next()

◆ populateIdentifier()

◆ registerIdentifier()

◆ registerIdentifiers()

◆ removeElement()

◆ reorderByRandomIdentifiers()

◆ resetElements()

◆ resetElementsIndentations()

◆ rewind()

◆ setElements()

◆ setQuestionId()

◆ throwCouldNotBuildRandomIdentifierException()

◆ throwMissingReorderPositionException()

◆ throwUnknownIdentifierTypeException()

◆ throwUnknownRandomIdentifiersException()

◆ valid()

◆ withElements()

◆ withQuestionId()

Field Documentation

◆ $elements