Function: seq-random-elt

seq-random-elt is a byte-compiled function defined in seq.el.gz.

Signature

(seq-random-elt SEQUENCE)

Documentation

Return a randomly chosen element from SEQUENCE.

Signal an error if SEQUENCE is empty.

Other relevant functions are documented in the sequence group.

View in manual

Shortdoc

;; sequence
(seq-random-elt '(a b c))
    e.g. => c

Implementations

(seq-random-elt SEQUENCE) in `seq.el'.

Undocumented

Source Code

;; Defined in /usr/src/emacs/lisp/emacs-lisp/seq.el.gz
;;;###autoload
(cl-defgeneric seq-random-elt (sequence)
  "Return a randomly chosen element from SEQUENCE.
Signal an error if SEQUENCE is empty."
  (if (seq-empty-p sequence)
      (error "Sequence cannot be empty")
    (seq-elt sequence (random (seq-length sequence)))))