رنگینه

نحوه عملکرد دستور:

1. اين دستور با فراخواني تابع drupal_set_message بدون هيچ پارامتري تمام پيام‌هاي ثبت شده به کاربر را فراخواني کرده و به متغير $messages نسبت مي‌دهد. اگر پيامي قبلاً براي کاربر ثبت نشده باشد، تابع تنها يک آرايه خالي برمي‌گرداند.
2. سپس پارامتر اول يعني type‌ يا نوع پيام بررسي مي‌شود.
3. اگر نوع پيام براي تابع تعريف شده باشد، عمليات بعدي بر روي تنها همان نوع انجام مي‌پذيرد:
   1. حالا اين تابع پارامتر دوم يعني clear_queue را بررسي مي‌کند. اگر مقدار آن TRUE باشد، پيام‌هاي از نوع تعريف شده يا تمام پيام‌ها را از جلسه کاربر حذف مي‌کند.
   2. سپس اين دستور چک مي‌کند که آيا پيامي از نوع تعريف شده در متغير $messages (که شامل تمام پيام‌هاي کاربر بود) وجود دارد يا نه. اگر وجود داشت آن پيام‌ها را به صورت آرايه برمي‌گرداند.
4. و اگر نوع پيام تعيين نشده باشد، عمليات بعدي بر روي تمام پيام‌ها اعمال مي‌شود:
   1. اينجا تابع پارامتر دوم يعني clear_queue را بررسي مي‌کند. اگر مقدار آن TRUE باشد، تمام پيام‌ها را از جلسه کاربر حذف مي‌کند.
   2. سپس اين دستور تمام پيام‌هاي ثبت‌شده براي کاربر را که در مرحله اول وارد متغير $messages‌ بود را برمي‌گرداند

جايگاه اين دستور:

جايگاه اين دستور فايل includes\bootstrap.inc مي‌باشد و ساختار اين دستور در دروپال 6 به شکل زير است:

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();
}