function drupal_get_messages in Drupal 6

Same name and namespace in other branches

1. 8 core/includes/bootstrap.inc \drupal_get_messages()
2. 4 includes/bootstrap.inc \drupal_get_messages()
3. 5 includes/bootstrap.inc \drupal_get_messages()
4. 7 includes/bootstrap.inc \drupal_get_messages()

Return all messages that have been set.

Parameters

$type: (optional) Only return messages of this type.

$clear_queue: (optional) Set to FALSE if you do not want to clear the messages queue

Return value

An associative array, the key is the message type, the value an array of messages. If the $type parameter is passed, you get only that type, or an empty array if there are no such messages. If $type is not passed, all message types are returned, or an empty array if none exist.

2 calls to drupal_get_messages()

openid_authentication in modules/openid/openid.module

Authenticate a user or attempt registration.

theme_status_messages in includes/theme.inc

Return a themed set of status and/or error messages. The messages are grouped by type.

File

includes/bootstrap.inc, line 1040

Functions that need to be loaded on every Drupal request.

Code

function drupal_get_messages($type = NULL, $clear_queue = TRUE) {
  if ($messages = drupal_set_message()) {
    if ($type) {
      if ($clear_queue) {
        unset($_SESSION['messages'][$type]);
      }
      if (isset($messages[$type])) {
        return array(
          $type => $messages[$type],
        );
      }
    }
    else {
      if ($clear_queue) {
        unset($_SESSION['messages']);
      }
      return $messages;
    }
  }
  return array();
}