function drupal_get_messages

7.x bootstrap.inc	`drupal_get_messages($type = NULL, $clear_queue = TRUE)`
6.x bootstrap.inc	`drupal_get_messages($type = NULL, $clear_queue = TRUE)`

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 drupal-6.x/modules/openid/openid.module: Authenticate a user or attempt registration.
theme_status_messages in drupal-6.x/includes/theme.inc: Return a themed set of status and/or error messages. The messages are grouped by type.

File

drupal-6.x/includes/bootstrap.inc, line 1023: 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();
}