This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for assAnswerCloze:

Collaboration diagram for assAnswerCloze:

Public Member Functions
	__construct (string $answertext="", float $points=0.0, int $order=0, int $id=-1, int $state=0)
	assAnswerCloze constructor More...

	setLowerBound (string $bound)
	Sets the lower boind. More...

	setUpperBound (string $bound)
	Sets the upper bound. More...

	getLowerBound ()
	Returns the lower bound. More...

	getUpperBound ()
	Returns the upper bound. More...

	setGapSize (int $gap_size)

	getGapSize ()

Public Member Functions inherited from ASS_AnswerSimple
	__construct ($answertext="", $points=0.0, $order=0, $id=-1)
	ASS_AnswerSimple constructor. More...

	getId ()
	Gets the answer id. More...

	getAnswertext ()
	Gets the answer text. More...

	getPoints ()
	Gets the points. More...

	checkPoints ($a_points)
	Checks, if the point value is numeric. More...

	getOrder ()
	Gets the sort/display order. More...

	setOrder ($order=0)
	Sets the order. More...

	setId ($id=-1)
	Sets the answer id. More...

	setAnswertext ($answertext="")
	Sets the answer text. More...

	setPoints ($points=0.0)
	Sets the points. More...

Protected Member Functions
	getNumericValueFromAnswerText ()

	getNumericValueFromText ($text)

Protected Attributes
string	$lowerBound

string	$upperBound

int	$gap_size

Protected Attributes inherited from ASS_AnswerSimple
string	$answertext

	$points

	$order

	$id

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Class for cloze question numeric answers

assAnswerCloze is a class for cloze questions numeric answers.

Author: Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m; Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version: $Id$

See also: ASS_AnswerBinaryState

@TODO Rework class to represent bounds as numerics instead of strings.

Definition at line 37 of file class.assAnswerCloze.php.

Constructor & Destructor Documentation

◆ __construct()

assAnswerCloze::__construct	(	string	$answertext = `""`,
		float	$points = `0.0`,
		int	$order = `0`,
		int	$id = `-1`,
		int	$state = `0`
	)

assAnswerCloze constructor

The constructor takes possible arguments an creates an instance of the assAnswerCloze object.

Parameters

string	$answertext	A string defining the answer text
double	$points	The number of points given for the selected answer
integer	$order	A nonnegative value representing a possible display or sort order @TODO See if the initialization of the bounds to null can be avoided to have them string/numeric at all times.

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

    {
        parent::__construct($answertext, $points, $order, $id, $state);
        $this->lowerBound = null;
        $this->upperBound = null;
        $this->gap_size = 0;
    }

References ASS_AnswerSimple\$answertext, ASS_AnswerSimple\$id, ASS_AnswerSimple\$order, ASS_AnswerSimple\$points, and ILIAS\GlobalScreen\Provider\__construct().

Here is the call graph for this function:

Member Function Documentation

◆ getGapSize()

assAnswerCloze::getGapSize ( )

Returns: int

Definition at line 152 of file class.assAnswerCloze.php.

                                : int
    {
        return $this->gap_size;
    }

References $gap_size.

◆ getLowerBound()

assAnswerCloze::getLowerBound ( )

Returns the lower bound.

Returns: null|string

Definition at line 126 of file class.assAnswerCloze.php.

                                   : ?string
    {
        return $this->lowerBound;
    }

References $lowerBound.

◆ getNumericValueFromAnswerText()

assAnswerCloze::getNumericValueFromAnswerText ( )

protected

Definition at line 107 of file class.assAnswerCloze.php.

    {
        return $this->getNumericValueFromText($this->getAnswertext());
    }

References ASS_AnswerSimple\getAnswertext(), and getNumericValueFromText().

Referenced by setLowerBound(), and setUpperBound().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getNumericValueFromText()

assAnswerCloze::getNumericValueFromText ( $text )

protected

Definition at line 112 of file class.assAnswerCloze.php.

    {
        include_once("./Services/Math/classes/class.EvalMath.php");
        $eval = new EvalMath();
        $eval->suppress_errors = true;
        return $eval->e(str_replace(",", ".", ilUtil::stripSlashes($text, false)));
    }

References ilUtil\stripSlashes().

Referenced by getNumericValueFromAnswerText(), setLowerBound(), and setUpperBound().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getUpperBound()

assAnswerCloze::getUpperBound ( )

Returns the upper bound.

Returns: null|string

Definition at line 136 of file class.assAnswerCloze.php.

                                   : ?string
    {
        return $this->upperBound;
    }

References $upperBound.

◆ setGapSize()

assAnswerCloze::setGapSize ( int $gap_size )

Parameters

int $gap_size

Definition at line 144 of file class.assAnswerCloze.php.

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

References $gap_size.

◆ setLowerBound()

assAnswerCloze::setLowerBound ( string $bound )

Sets the lower boind.

Parameters

$bound string A string defining the lower bound of an answer for numeric gaps. @TODO: Refactor method to get rid of "locale magic".

Definition at line 78 of file class.assAnswerCloze.php.

                                                : void
    {
        $boundvalue = $this->getNumericValueFromText($bound);
        $value = $this->getNumericValueFromAnswerText();
 
        if ($boundvalue === false || $boundvalue > $value) {
            $this->lowerBound = $this->getAnswertext();
        } else {
            $this->lowerBound = $bound;
        }
    }

References ASS_AnswerSimple\getAnswertext(), getNumericValueFromAnswerText(), and getNumericValueFromText().

Referenced by assClozeTestGUI\saveNumericGapCorrectionFormProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUpperBound()

assAnswerCloze::setUpperBound ( string $bound )

Sets the upper bound.

Parameters

$bound string A string defining the upper bound of an answer for numeric gaps. @TODO: Refactor method to get rid of "locale magic".

Definition at line 95 of file class.assAnswerCloze.php.

                                                : void
    {
        $boundvalue = $this->getNumericValueFromText($bound);
        $value = $this->getNumericValueFromAnswerText();
 
        if ($boundvalue === false || $boundvalue < $value) {
            $this->upperBound = $this->getAnswertext();
        } else {
            $this->upperBound = $bound;
        }
    }