Function: progress-reporter-update

progress-reporter-update is a byte-compiled function defined in subr.el.gz.

Signature

(progress-reporter-update REPORTER &optional VALUE SUFFIX)

Documentation

Report progress of an operation, by default, in the echo area.

REPORTER should be the result of a call to make-progress-reporter.

If REPORTER is a numerical progress reporter---i.e. if it was made using non-nil MIN-VALUE and MAX-VALUE arguments to make-progress-reporter---then VALUE should be a number between MIN-VALUE and MAX-VALUE.

Optional argument SUFFIX is a string to be displayed after REPORTER's main message and progress text. If REPORTER is a non-numerical reporter, then VALUE should be nil, or a string to use instead of SUFFIX. SUFFIX is considered obsolete and may be removed in the future.

See progress-reporter-update-functions for the list of functions called on each update.

This function is relatively inexpensive. If the change since last update is too small or insufficient time has passed, it does nothing.

View in manual

Probably introduced at or before Emacs version 22.1.

Aliases

eglot--reporter-update

Source Code

;; Defined in /usr/src/emacs/lisp/subr.el.gz
(defsubst progress-reporter-update (reporter &optional value suffix)
  "Report progress of an operation, by default, in the echo area.
REPORTER should be the result of a call to `make-progress-reporter'.

If REPORTER is a numerical progress reporter---i.e. if it was
made using non-nil MIN-VALUE and MAX-VALUE arguments to
`make-progress-reporter'---then VALUE should be a number between
MIN-VALUE and MAX-VALUE.

Optional argument SUFFIX is a string to be displayed after REPORTER's
main message and progress text.  If REPORTER is a non-numerical
reporter, then VALUE should be nil, or a string to use instead of
SUFFIX.  SUFFIX is considered obsolete and may be removed in the future.

See `progress-reporter-update-functions' for the list of functions
called on each update.

This function is relatively inexpensive.  If the change since
last update is too small or insufficient time has passed, it does
nothing."
  (when (or (not (numberp value))      ; For pulsing reporter
	    (>= value (car reporter))) ; For numerical reporter
    (progress-reporter-do-update reporter value suffix)))