Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.

Differences Between: [Versions 310 and 402] [Versions 311 and 402] [Versions 39 and 402] [Versions 400 and 402] [Versions 401 and 402]

Numerical question definition class.

Copyright: 2009 The Open University
License: http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
File Size: 423 lines (16 kb)
Included or required:0 times
Referenced: 1 time
Includes or requires: 0 files

Defines 2 classes


Class: qtype_numerical_question  - X-Ref

Represents a numerical question.

get_expected_data()   X-Ref
No description

has_separate_unit_field()   X-Ref
No description

start_attempt(question_attempt_step $step, $variant)   X-Ref
No description

apply_attempt_state(question_attempt_step $step)   X-Ref
No description

summarise_response(array $response)   X-Ref
No description

un_summarise_response(string $summary)   X-Ref
No description

is_gradable_response(array $response)   X-Ref
No description

is_complete_response(array $response)   X-Ref
No description

get_validation_error(array $response)   X-Ref
No description

is_same_response(array $prevresponse, array $newresponse)   X-Ref
No description

get_correct_response()   X-Ref
No description

get_matching_answer($value, $multiplier)   X-Ref
Get an answer that contains the feedback and fraction that should be
awarded for this response.

param: number $value the numerical value of a response.
param: number $multiplier for the unit the student gave, if any. When no
return: question_answer the matching answer.

is_unit_right(qtype_numerical_answer $answer, float $value, ?float $multiplier)   X-Ref
Checks if the provided $multiplier is appropriate for the unit of the given $value,
ensuring that multiplying $value by the $multiplier yields the expected $answer.

param: qtype_numerical_answer $answer The expected result when multiplying $value by the appropriate $multiplier.
param: float $value The provided value
param: float|null $multiplier The multiplier value for the unit of $value.
return: bool Returns true if the $multiplier is correct for the unit of $value, false otherwise.

get_correct_answer()   X-Ref
No description

apply_unit_penalty($fraction, $unitisright)   X-Ref
Adjust the fraction based on whether the unit was correct.

param: number $fraction
param: bool $unitisright
return: number

grade_response(array $response)   X-Ref
No description

classify_response(array $response)   X-Ref
No description

check_file_access($qa, $options, $component, $filearea, $args,$forcedownload)   X-Ref
No description

get_question_definition_for_external_rendering(question_attempt $qa, question_display_options $options)   X-Ref
Return the question settings that define this question as structured data.

param: question_attempt $qa the current attempt for which we are exporting the settings.
param: question_display_options $options the question display options which say which aspects of the question
return: mixed structure representing the question settings. In web services, this will be JSON-encoded.

Class: qtype_numerical_answer  - X-Ref

Subclass of {@link question_answer} with the extra information required by
the numerical question type.