original_string: public static function get_user_best_grade($quizid, $userid = 0) {
          global $DB, $USER;
  
          $warnings = array();
  
          $params = array(
              'quizid' => $quizid,
              'userid' => $userid,
          );
          $params = self::validate_parameters(self::get_user_best_grade_parameters(), $params);
  
          list($quiz, $course, $cm, $context) = self::validate_quiz($params['quizid']);
  
          // Default value for userid.
          if (empty($params['userid'])) {
              $params['userid'] = $USER->id;
          }
  
          $user = core_user::get_user($params['userid'], '*', MUST_EXIST);
          core_user::require_active_user($user);
  
          // Extra checks so only users with permissions can view other users attempts.
          if ($USER->id != $user->id) {
              require_capability('mod/quiz:viewreports', $context);
          }
  
          $result = array();
          $grade = quiz_get_best_grade($quiz, $user->id);
  
          if ($grade === null) {
              $result['hasgrade'] = false;
          } else {
              $result['hasgrade'] = true;
              $result['grade'] = $grade;
          }
          $result['warnings'] = $warnings;
          return $result;
      }
code: public static function get_user_best_grade($quizid, $userid = 0) {
          global $DB, $USER;
  
          $warnings = array();
  
          $params = array(
              'quizid' => $quizid,
              'userid' => $userid,
          );
          $params = self::validate_parameters(self::get_user_best_grade_parameters(), $params);
  
          list($quiz, $course, $cm, $context) = self::validate_quiz($params['quizid']);
  
          // Default value for userid.
          if (empty($params['userid'])) {
              $params['userid'] = $USER->id;
          }
  
          $user = core_user::get_user($params['userid'], '*', MUST_EXIST);
          core_user::require_active_user($user);
  
          // Extra checks so only users with permissions can view other users attempts.
          if ($USER->id != $user->id) {
              require_capability('mod/quiz:viewreports', $context);
          }
  
          $result = array();
          $grade = quiz_get_best_grade($quiz, $user->id);
  
          if ($grade === null) {
              $result['hasgrade'] = false;
          } else {
              $result['hasgrade'] = true;
              $result['grade'] = $grade;
          }
          $result['warnings'] = $warnings;
          return $result;
      }
code_tokens: public static function get_user_best_grade ( $ quizid , $ userid = 0 ) { global $ DB , $ USER ; $ warnings = array ( ) ; $ params = array ( 'quizid' => $ quizid , 'userid' => $ userid , ) ; $ params = self :: validate_parameters ( self :: get_user_best_grade_parameters ( ) , $ params ) ; list ( $ quiz , $ course , $ cm , $ context ) = self :: validate_quiz ( $ params [ 'quizid' ] ) ; // Default value for userid. if ( empty ( $ params [ 'userid' ] ) ) { $ params [ 'userid' ] = $ USER -> id ; } $ user = core_user :: get_user ( $ params [ 'userid' ] , '*' , MUST_EXIST ) ; core_user :: require_active_user ( $ user ) ; // Extra checks so only users with permissions can view other users attempts. if ( $ USER -> id != $ user -> id ) { require_capability ( 'mod/quiz:viewreports' , $ context ) ; } $ result = array ( ) ; $ grade = quiz_get_best_grade ( $ quiz , $ user -> id ) ; if ( $ grade === null ) { $ result [ 'hasgrade' ] = false ; } else { $ result [ 'hasgrade' ] = true ; $ result [ 'grade' ] = $ grade ; } $ result [ 'warnings' ] = $ warnings ; return $ result ; }
docstring: Get the best current grade for the given user on a quiz.
  
  @param int $quizid quiz instance id
  @param int $userid user id
  @return array of warnings and the grade information
  @since Moodle 3.1
docstring_tokens: Get the best current grade for the given user on a quiz .