original_string: public static function get_choices_by_courses_returns() {
          return new external_single_structure(
              array(
                  'choices' => new external_multiple_structure(
                      new external_single_structure(
                          array(
                              'id' => new external_value(PARAM_INT, 'Choice instance id'),
                              'coursemodule' => new external_value(PARAM_INT, 'Course module id'),
                              'course' => new external_value(PARAM_INT, 'Course id'),
                              'name' => new external_value(PARAM_RAW, 'Choice name'),
                              'intro' => new external_value(PARAM_RAW, 'The choice intro'),
                              'introformat' => new external_format_value('intro'),
                              'introfiles' => new external_files('Files in the introduction text', VALUE_OPTIONAL),
                              'publish' => new external_value(PARAM_BOOL, 'If choice is published', VALUE_OPTIONAL),
                              'showresults' => new external_value(PARAM_INT, '0 never, 1 after answer, 2 after close, 3 always',
                                                                  VALUE_OPTIONAL),
                              'display' => new external_value(PARAM_INT, 'Display mode (vertical, horizontal)', VALUE_OPTIONAL),
                              'allowupdate' => new external_value(PARAM_BOOL, 'Allow update', VALUE_OPTIONAL),
                              'allowmultiple' => new external_value(PARAM_BOOL, 'Allow multiple choices', VALUE_OPTIONAL),
                              'showunanswered' => new external_value(PARAM_BOOL, 'Show users who not answered yet', VALUE_OPTIONAL),
                              'includeinactive' => new external_value(PARAM_BOOL, 'Include inactive users', VALUE_OPTIONAL),
                              'limitanswers' => new external_value(PARAM_BOOL, 'Limit unswers', VALUE_OPTIONAL),
                              'timeopen' => new external_value(PARAM_INT, 'Date of opening validity', VALUE_OPTIONAL),
                              'timeclose' => new external_value(PARAM_INT, 'Date of closing validity', VALUE_OPTIONAL),
                              'showpreview' => new external_value(PARAM_BOOL, 'Show preview before timeopen', VALUE_OPTIONAL),
                              'timemodified' => new external_value(PARAM_INT, 'Time of last modification', VALUE_OPTIONAL),
                              'completionsubmit' => new external_value(PARAM_BOOL, 'Completion on user submission', VALUE_OPTIONAL),
                              'section' => new external_value(PARAM_INT, 'Course section id', VALUE_OPTIONAL),
                              'visible' => new external_value(PARAM_BOOL, 'Visible', VALUE_OPTIONAL),
                              'groupmode' => new external_value(PARAM_INT, 'Group mode', VALUE_OPTIONAL),
                              'groupingid' => new external_value(PARAM_INT, 'Group id', VALUE_OPTIONAL),
                          ), 'Choices'
                      )
                  ),
                  'warnings' => new external_warnings(),
              )
          );
      }
code: public static function get_choices_by_courses_returns() {
          return new external_single_structure(
              array(
                  'choices' => new external_multiple_structure(
                      new external_single_structure(
                          array(
                              'id' => new external_value(PARAM_INT, 'Choice instance id'),
                              'coursemodule' => new external_value(PARAM_INT, 'Course module id'),
                              'course' => new external_value(PARAM_INT, 'Course id'),
                              'name' => new external_value(PARAM_RAW, 'Choice name'),
                              'intro' => new external_value(PARAM_RAW, 'The choice intro'),
                              'introformat' => new external_format_value('intro'),
                              'introfiles' => new external_files('Files in the introduction text', VALUE_OPTIONAL),
                              'publish' => new external_value(PARAM_BOOL, 'If choice is published', VALUE_OPTIONAL),
                              'showresults' => new external_value(PARAM_INT, '0 never, 1 after answer, 2 after close, 3 always',
                                                                  VALUE_OPTIONAL),
                              'display' => new external_value(PARAM_INT, 'Display mode (vertical, horizontal)', VALUE_OPTIONAL),
                              'allowupdate' => new external_value(PARAM_BOOL, 'Allow update', VALUE_OPTIONAL),
                              'allowmultiple' => new external_value(PARAM_BOOL, 'Allow multiple choices', VALUE_OPTIONAL),
                              'showunanswered' => new external_value(PARAM_BOOL, 'Show users who not answered yet', VALUE_OPTIONAL),
                              'includeinactive' => new external_value(PARAM_BOOL, 'Include inactive users', VALUE_OPTIONAL),
                              'limitanswers' => new external_value(PARAM_BOOL, 'Limit unswers', VALUE_OPTIONAL),
                              'timeopen' => new external_value(PARAM_INT, 'Date of opening validity', VALUE_OPTIONAL),
                              'timeclose' => new external_value(PARAM_INT, 'Date of closing validity', VALUE_OPTIONAL),
                              'showpreview' => new external_value(PARAM_BOOL, 'Show preview before timeopen', VALUE_OPTIONAL),
                              'timemodified' => new external_value(PARAM_INT, 'Time of last modification', VALUE_OPTIONAL),
                              'completionsubmit' => new external_value(PARAM_BOOL, 'Completion on user submission', VALUE_OPTIONAL),
                              'section' => new external_value(PARAM_INT, 'Course section id', VALUE_OPTIONAL),
                              'visible' => new external_value(PARAM_BOOL, 'Visible', VALUE_OPTIONAL),
                              'groupmode' => new external_value(PARAM_INT, 'Group mode', VALUE_OPTIONAL),
                              'groupingid' => new external_value(PARAM_INT, 'Group id', VALUE_OPTIONAL),
                          ), 'Choices'
                      )
                  ),
                  'warnings' => new external_warnings(),
              )
          );
      }
code_tokens: public static function get_choices_by_courses_returns ( ) { return new external_single_structure ( array ( 'choices' => new external_multiple_structure ( new external_single_structure ( array ( 'id' => new external_value ( PARAM_INT , 'Choice instance id' ) , 'coursemodule' => new external_value ( PARAM_INT , 'Course module id' ) , 'course' => new external_value ( PARAM_INT , 'Course id' ) , 'name' => new external_value ( PARAM_RAW , 'Choice name' ) , 'intro' => new external_value ( PARAM_RAW , 'The choice intro' ) , 'introformat' => new external_format_value ( 'intro' ) , 'introfiles' => new external_files ( 'Files in the introduction text' , VALUE_OPTIONAL ) , 'publish' => new external_value ( PARAM_BOOL , 'If choice is published' , VALUE_OPTIONAL ) , 'showresults' => new external_value ( PARAM_INT , '0 never, 1 after answer, 2 after close, 3 always' , VALUE_OPTIONAL ) , 'display' => new external_value ( PARAM_INT , 'Display mode (vertical, horizontal)' , VALUE_OPTIONAL ) , 'allowupdate' => new external_value ( PARAM_BOOL , 'Allow update' , VALUE_OPTIONAL ) , 'allowmultiple' => new external_value ( PARAM_BOOL , 'Allow multiple choices' , VALUE_OPTIONAL ) , 'showunanswered' => new external_value ( PARAM_BOOL , 'Show users who not answered yet' , VALUE_OPTIONAL ) , 'includeinactive' => new external_value ( PARAM_BOOL , 'Include inactive users' , VALUE_OPTIONAL ) , 'limitanswers' => new external_value ( PARAM_BOOL , 'Limit unswers' , VALUE_OPTIONAL ) , 'timeopen' => new external_value ( PARAM_INT , 'Date of opening validity' , VALUE_OPTIONAL ) , 'timeclose' => new external_value ( PARAM_INT , 'Date of closing validity' , VALUE_OPTIONAL ) , 'showpreview' => new external_value ( PARAM_BOOL , 'Show preview before timeopen' , VALUE_OPTIONAL ) , 'timemodified' => new external_value ( PARAM_INT , 'Time of last modification' , VALUE_OPTIONAL ) , 'completionsubmit' => new external_value ( PARAM_BOOL , 'Completion on user submission' , VALUE_OPTIONAL ) , 'section' => new external_value ( PARAM_INT , 'Course section id' , VALUE_OPTIONAL ) , 'visible' => new external_value ( PARAM_BOOL , 'Visible' , VALUE_OPTIONAL ) , 'groupmode' => new external_value ( PARAM_INT , 'Group mode' , VALUE_OPTIONAL ) , 'groupingid' => new external_value ( PARAM_INT , 'Group id' , VALUE_OPTIONAL ) , ) , 'Choices' ) ) , 'warnings' => new external_warnings ( ) , ) ) ; }
docstring: Describes the mod_choice_get_choices_by_courses return value.
  
  @return external_single_structure
  @since Moodle 3.0
docstring_tokens: Describes the mod_choice_get_choices_by_courses return value .