Function: imap-mailbox-status

imap-mailbox-status is a byte-compiled function defined in imap.el.gz.

Signature

(imap-mailbox-status MAILBOX ITEMS &optional BUFFER)

Documentation

Get status items ITEM in MAILBOX from server in BUFFER.

ITEMS can be a symbol or a list of symbols, valid symbols are one of the STATUS data items -- i.e. messages, recent, uidnext, uidvalidity, or unseen. If ITEMS is a list of symbols, a list of values is returned, if ITEMS is a symbol only its value is returned.

Source Code

;; Defined in /usr/src/emacs/lisp/net/imap.el.gz
(defun imap-mailbox-status (mailbox items &optional buffer)
  "Get status items ITEM in MAILBOX from server in BUFFER.
ITEMS can be a symbol or a list of symbols, valid symbols are one of
the STATUS data items -- i.e. `messages', `recent', `uidnext', `uidvalidity',
or `unseen'.  If ITEMS is a list of symbols, a list of values is
returned, if ITEMS is a symbol only its value is returned."
  (with-current-buffer (or buffer (current-buffer))
    (when (imap-ok-p
	   (imap-send-command-wait (list "STATUS \""
					 (imap-utf7-encode mailbox)
					 "\" "
					 (upcase
					  (format "%s"
						  (if (listp items)
						      items
						    (list items)))))))
      (if (listp items)
	  (mapcar (lambda (item)
		    (imap-mailbox-get item mailbox))
		  items)
	(imap-mailbox-get items mailbox)))))