drupal_submit_form

• Drupal 4.7
• Drupal 5

• View documentation
• List references

Definition

drupal_submit_form($form_id, $form)
includes/form.inc, line 417

Description

Processes user-submitted form data from a global variable using the submit functions defined in a structured form array.

Parameters

$form_id A unique string identifying the form for validation, submission, theming, and hook_form_alter functions.

$form An associative array containing the structure of the form.

Return value

A string containing the path of the page to display when processing is complete.

Related topics

Name	Description
Form generation	Functions to enable the processing and display of HTML forms.

Code

<?php
function drupal_submit_form($form_id, $form) {
  global $form_values;
  $default_args = array($form_id, &$form_values);
  $submitted = FALSE;
  $goto = NULL;

  if (isset($form['#submit'])) {
    foreach ($form['#submit'] as $function => $args) {
      if (function_exists($function)) {
        $args = array_merge($default_args, (array) $args);
        // Since we can only redirect to one page, only the last redirect
        // will work.
        $redirect = call_user_func_array($function, $args);
        $submitted = TRUE;
        if (isset($redirect)) {
          $goto = $redirect;
        }
      }
    }
  }

  return $goto;
}
?>