Inheritance diagram for qtype_numerical:

Collaboration diagram for qtype_numerical:

Public Member Functions
	get_question_options ($question)
	get_numerical_units (&$question)
	get_default_numerical_unit ($question)
	get_numerical_options ($question)
	save_question_options ($question)
	save_unit_options ($question)
	save_units ($question)
	initialise_numerical_answers (question_definition $question, $questiondata)
	make_answer_processor ($units, $unitsleft)
	delete_question ($questionid, $contextid)
	get_random_guess_score ($questiondata)
	add_unit ($questiondata, $answer, $unit=null)
	get_possible_responses ($questiondata)
	apply_unit ($rawresponse, $units, $unitsleft)
	move_files ($questionid, $oldcontextid, $newcontextid)
Data Fields
const	UNITINPUT = 0
const	UNITRADIO = 1
const	UNITSELECT = 2
const	UNITNONE = 3
const	UNITGRADED = 1
const	UNITOPTIONAL = 0
const	UNITGRADEDOUTOFMARK = 1
const	UNITGRADEDOUTOFMAX = 2
Protected Member Functions
	initialise_question_instance (question_definition $question, $questiondata)
	delete_files ($questionid, $contextid)

Detailed Description

The numerical question type class.

This class contains some special features in order to make the question type embeddable within a multianswer (cloze) question

Copyright:: 1999 onwards Martin Dougiamas http://moodle.com http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Definition at line 42 of file questiontype.php.

Member Function Documentation

add_unit	(	$	questiondata,
		$	answer,
		$	unit = `null`
	)

Add a unit to a response for display.

Parameters:

object	$questiondata	the data defining the quetsion.
string	$answer	a response.
object	$unit	a unit. If null, get_default_numerical_unit() is used.

Definition at line 400 of file questiontype.php.

Here is the call graph for this function:

Here is the caller graph for this function:

apply_unit	(	$	rawresponse,
		$	units,
		$	unitsleft
	)

Checks if the $rawresponse has a unit and applys it if appropriate.

Parameters:

string	$rawresponse	The response string to be converted to a float.
array	$units	An array with the defined units, where the unit is the key and the multiplier the value.

Returns:: float The rawresponse with the unit taken into account as a float.

Definition at line 459 of file questiontype.php.

Here is the call graph for this function:

Here is the caller graph for this function:

delete_files	(	$	questionid,
		$	contextid
	)		`[protected]`

Delete all the files belonging to this question.

Parameters:

int	$questionid	the question being deleted.
int	$contextid	the context the question is in.

Reimplemented from question_type.

Definition at line 475 of file questiontype.php.

Here is the call graph for this function:

delete_question	(	$	questionid,
		$	contextid
	)

Deletes the question-type specific data when a question is deleted.

Parameters:

int	$question	the question being deleted.
int	$contextid	the context this quesiotn belongs to.

Reimplemented from question_type.

Definition at line 375 of file questiontype.php.

get_default_numerical_unit ( $ question )

Definition at line 113 of file questiontype.php.

Here is the caller graph for this function:

get_numerical_options ( $ question )

Definition at line 124 of file questiontype.php.

Here is the call graph for this function:

Here is the caller graph for this function:

get_numerical_units ( &$ question )

Definition at line 97 of file questiontype.php.

Here is the call graph for this function:

Here is the caller graph for this function:

get_possible_responses ( $ questiondata )

This method should return all the possible types of response that are recognised for this question.

The question is modelled as comprising one or more subparts. For each subpart, there are one or more classes that that students response might fall into, each of those classes earning a certain score.

For example, in a shortanswer question, there is only one subpart, the text entry field. The response the student gave will be classified according to which of the possible $question->options->answers it matches.

For the matching question type, there will be one subpart for each question stem, and for each stem, each of the possible choices is a class of student's response.

A response is an object with two fields, ->responseclass is a string presentation of that response, and ->fraction, the credit for a response in that class.

Array keys have no specific meaning, but must be unique, and must be the same if this function is called repeatedly.

Parameters:

object $question the question definition data.

Returns:: array keys are subquestionid, values are arrays of possible responses to that subquestion.

Reimplemented from question_type.

Definition at line 416 of file questiontype.php.

Here is the call graph for this function:

get_question_options ( $ question )

Loads the question type specific options for the question.

This function loads any question type specific options for the question from the database into the question object. This information is placed in the $question->options field. A question type is free, however, to decide on a internal structure of the options field.

Returns:: bool Indicates success or failure.

Parameters:

object $question The question object for the question. This object should be updated to include the question type specific information (it is passed by reference).

Reimplemented from question_type.

Definition at line 54 of file questiontype.php.

Here is the call graph for this function:

get_random_guess_score ( $ questiondata )

Parameters:

object $question

Returns:: number|null either a fraction estimating what the student would score by guessing, or null, if it is not possible to estimate.

Reimplemented from question_type.

Definition at line 384 of file questiontype.php.

initialise_numerical_answers	(	question_definition $	question,
		$	questiondata
	)

Definition at line 351 of file questiontype.php.

Here is the caller graph for this function:

initialise_question_instance	(	question_definition $	question,
		$	questiondata
	)		`[protected]`

Initialise the common question_definition fields.

Parameters:

question_definition	$question	the question_definition we are creating.
object	$questiondata	the question data loaded from the database.

Reimplemented from question_type.

Definition at line 341 of file questiontype.php.

Here is the call graph for this function:

make_answer_processor	(	$	units,
		$	unitsleft
	)

Definition at line 362 of file questiontype.php.

Here is the caller graph for this function:

move_files	(	$	questionid,
		$	oldcontextid,
		$	newcontextid
	)

Move all the files belonging to this question from one context to another.

Parameters:

int	$questionid	the question being moved.
int	$oldcontextid	the context it is moving from.
int	$newcontextid	the context it is moving to.

Reimplemented from question_type.

Definition at line 468 of file questiontype.php.

Here is the call graph for this function:

save_question_options ( $ question )

Save the units and the answers associated with this question.

Reimplemented from question_type.

Definition at line 151 of file questiontype.php.

Here is the call graph for this function:

save_unit_options ( $ question )

The numerical options control the display and the grading of the unit part of the numerical question and related types (calculateds) Questions previous to 2.0 do not have this table as multianswer questions in all versions including 2.0. The default values are set to give the same grade as old question.

Definition at line 252 of file questiontype.php.

Here is the call graph for this function: