Class for cloze question numeric answers. More...

Inheritance diagram for assAnswerCloze:

Collaboration diagram for assAnswerCloze:

Public Member Functions
	__construct ($answertext="", $points=0.0, $order=0)
	assAnswerCloze constructor More...

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

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

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

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

	setGapSize ($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
	$lowerBound

	$upperBound

	$gap_size

Protected Attributes inherited from ASS_AnswerSimple
	$answertext

	$points

	$order

	$id

Detailed Description

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 23 of file class.assAnswerCloze.php.

Constructor & Destructor Documentation

◆ __construct()

assAnswerCloze::__construct	(	$answertext = `""`,
		$points = `0.0`,
		$order = `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

Returns: assAnswerCloze @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, -1);
                $this->lowerBound = NULL;
                $this->upperBound = NULL;
                $this->gap_size = 0;
        }

References ASS_AnswerSimple\$answertext, ASS_AnswerSimple\$order, and ASS_AnswerSimple\$points.

Member Function Documentation

◆ getGapSize()

assAnswerCloze::getGapSize ( )

Returns: int

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

        {
                return $this->gap_size;
        }

References $gap_size.

◆ getLowerBound()

assAnswerCloze::getLowerBound ( )

Returns the lower bound.

Returns: null|string

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

        {
                return $this->lowerBound;
        }

References $lowerBound.

◆ getNumericValueFromAnswerText()

assAnswerCloze::getNumericValueFromAnswerText ( )

protected

Definition at line 115 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 120 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 $text, and 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 144 of file class.assAnswerCloze.php.

        {
                return $this->upperBound;
        }

References $upperBound.

◆ setGapSize()

assAnswerCloze::setGapSize ( $gap_size )

Parameters

int $gap_size

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

        {
                $this->gap_size = $gap_size;
        }

References $gap_size.

◆ setLowerBound()

assAnswerCloze::setLowerBound ( $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 79 of file class.assAnswerCloze.php.

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

Here is the call graph for this function:

◆ setUpperBound()

assAnswerCloze::setUpperBound ( $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 100 of file class.assAnswerCloze.php.

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

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

Here is the call graph for this function:

Field Documentation

◆ $gap_size

assAnswerCloze::$gap_size

protected

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

Referenced by getGapSize(), and setGapSize().

◆ $lowerBound

assAnswerCloze::$lowerBound

protected

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

Referenced by getLowerBound().

◆ $upperBound

assAnswerCloze::$upperBound

protected

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

Referenced by getUpperBound().

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

Modules/TestQuestionPool/classes/class.assAnswerCloze.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ getGapSize()

◆ getLowerBound()

◆ getNumericValueFromAnswerText()

◆ getNumericValueFromText()

◆ getUpperBound()

◆ setGapSize()

◆ setLowerBound()

◆ setUpperBound()

Field Documentation

◆ $gap_size

◆ $lowerBound

◆ $upperBound