Home › API reference › form.inc

form_set_error

  1. drupal
    1. 4.7
    2. 5
    3. 6 form.inc
    4. 7 form.inc
Versions
4.7 – 5 form_set_error($name = NULL, $message = '')
6 form_set_error($name = NULL, $message = '', $reset = FALSE)
7 form_set_error($name = NULL, $message = '', $limit_validation_errors = NULL)

File an error against a form element. If the name of the element is edit[foo][bar] then you may pass either foo or foo][bar as $name foo will set an error for all its children.

Related topics

Form generation
Functions to enable output of HTML forms and form elements.

▸ 49 functions call form_set_error()

▾ 49 functions call form_set_error()

aggregator_form_category_validate in modules/aggregator.module
Validate aggregator_form_feed form submissions.
aggregator_form_feed_validate in modules/aggregator.module
Validate aggregator_form_feed form submissions.
block_admin_configure_validate in modules/block.module
block_box_add_validate in modules/block.module
comment_admin_overview_validate in modules/comment.module
We can't execute any 'Update options' if no comments were selected.
comment_validate in modules/comment.module
contact_admin_edit_validate in modules/contact.module
Validate the contact category edit page form submission.
contact_mail_page_validate in modules/contact.module
Validate the site-wide contact page form submission.
do_search in modules/search.module
Do a query on the full-text search index for a word or words.
drupal_settings in modules/drupal.module
Implementation of hook_settings().
drupal_validate_form in includes/form.inc
fileupload_validate in developer/examples/fileupload.module
Implementation of hook_validate().
file_check_directory in includes/file.inc
Check that the directory exists and is writable. Directories need to have execute permissions to be considered a directory by FTP servers, etc.
filter_admin_format_form_validate in modules/filter.module
Validate filter format form submissions.
form_error in includes/form.inc
Flag an element as having an error.
form_get_error in includes/form.inc
Return the error message filed against the form with the specified name.
form_get_errors in includes/form.inc
Return an associative array of all errors.
forum_validate in modules/forum.module
Implementation of hook_validate().
hook_prepare in developer/hooks/node.php
This is a hook used by node modules. It is called after load but before the node is shown on the add/edit form.
hook_validate in developer/hooks/node.php
Verify a node editing form.
image_toolkit_validate in includes/image.inc
Validates toolkit selection.
locale_add_language_form_validate in includes/locale.inc
Validate the language addition form.
multipage_form_example_custom_validate in developer/examples/multipage_form_example.module
Validate our form.
nodeapi_example_nodeapi in developer/examples/nodeapi_example.module
Implementation of hook_nodeapi().
node_admin_nodes_validate in modules/node.module
node_example_validate in developer/examples/node_example.module
Implementation of hook_validate().
node_validate in modules/node.module
Perform validation checks on the given node.
path_form_validate in modules/path.module
Verify that URL alias is valid.
path_nodeapi in modules/path.module
Implementation of hook_nodeapi().
poll_validate in modules/poll.module
Implementation of hook_validate().
profile_field_form_validate in modules/profile.module
Validate profile_field_form submissions.
profile_validate_profile in modules/profile.module
search_form_submit in modules/search.module
Process a search form submission.
system_theme_settings in modules/system.module
Menu callback; display theme configuration for entire site and individual themes.
taxonomy_node_validate in modules/taxonomy.module
Make sure incoming vids are free tagging enabled.
upload_settings_form_validate in modules/upload.module
Form API callback to validate the upload settings form.
user_admin_access_add in modules/user.module
Menu callback: add an access rule
user_admin_access_check_validate in modules/user.module
user_admin_access_edit in modules/user.module
Menu callback: edit an access rule
user_admin_edit_role_validate in modules/user.module
user_admin_new_role_validate in modules/user.module
user_edit_validate in modules/user.module
user_login_validate in modules/user.module
user_pass_validate in modules/user.module
user_validate_picture in modules/user.module
_throttle_validate in modules/throttle.module
_unicode_check in includes/unicode.inc
Perform checks about Unicode support in PHP, and set the right settings if needed.
_upload_validate in modules/upload.module
_user_edit_validate in modules/user.module

Code

includes/form.inc, line 283

<?php
function form_set_error($name = NULL, $message = '') {
  static $form = array();
  if (isset($name) && !isset($form[$name])) {
    $form[$name] = $message;
    if ($message) {
      drupal_set_message($message, 'error');
    }
  }
  return $form;
}
?>