Function: read-char-choice

read-char-choice is a byte-compiled function defined in subr.el.gz.

Signature

(read-char-choice PROMPT CHARS &optional INHIBIT-KEYBOARD-QUIT)

Documentation

Read and return one of CHARS, prompting for PROMPT.

Any input that is not one of CHARS is ignored.

By default, the minibuffer is used to read the key non-modally (see read-char-from-minibuffer). If read-char-choice-use-read-key is non-nil, the modal read-key function is used instead (see read-char-choice-with-read-key).

Probably introduced at or before Emacs version 24.1.

Source Code

;; Defined in /usr/src/emacs/lisp/subr.el.gz
(defun read-char-choice (prompt chars &optional inhibit-keyboard-quit)
  "Read and return one of CHARS, prompting for PROMPT.
Any input that is not one of CHARS is ignored.

By default, the minibuffer is used to read the key
non-modally (see `read-char-from-minibuffer').  If
`read-char-choice-use-read-key' is non-nil, the modal `read-key'
function is used instead (see `read-char-choice-with-read-key')."
  (if (not read-char-choice-use-read-key)
      (read-char-from-minibuffer prompt chars)
    (read-char-choice-with-read-key prompt chars inhibit-keyboard-quit)))