Function: use-region-p

use-region-p is a byte-compiled function defined in simple.el.gz.

Signature

(use-region-p)

Documentation

Return t if the region is active and it is appropriate to act on it.

This is used by commands that act specially on the region under Transient Mark mode.

The return value is t if Transient Mark mode is enabled and the mark is active; furthermore, if use-empty-active-region is nil, the region must not be empty. Otherwise, the return value is nil.

For some commands, it may be appropriate to ignore the value of use-empty-active-region; in that case, use region-active-p.

Probably introduced at or before Emacs version 23.1.

Aliases

idlwave-region-active-p (obsolete since 28.1) reftex-region-active-p (obsolete since 28.1)

Source Code

;; Defined in /usr/src/emacs/lisp/simple.el.gz
(defun use-region-p ()
  "Return t if the region is active and it is appropriate to act on it.
This is used by commands that act specially on the region under
Transient Mark mode.

The return value is t if Transient Mark mode is enabled and the
mark is active; furthermore, if `use-empty-active-region' is nil,
the region must not be empty.  Otherwise, the return value is nil.

For some commands, it may be appropriate to ignore the value of
`use-empty-active-region'; in that case, use `region-active-p'."
  (and (region-active-p)
       (or use-empty-active-region (> (region-end) (region-beginning)))
       t))