Function: icomplete-forward-completions

icomplete-forward-completions is an interactive and byte-compiled function defined in icomplete.el.gz.

Signature

(icomplete-forward-completions)

Documentation

Step forward completions by one entry.

Second entry becomes the first and can be selected with icomplete-force-complete-and-exit. Return non-nil iff something was stepped.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/icomplete.el.gz
(defun icomplete-forward-completions ()
  "Step forward completions by one entry.
Second entry becomes the first and can be selected with
`icomplete-force-complete-and-exit'.
Return non-nil iff something was stepped."
  (interactive)
  (let* ((beg (icomplete--field-beg))
         (end (icomplete--field-end))
         (comps (completion-all-sorted-completions beg end)))
    (when (consp (cdr comps))
      (cond (icomplete-scroll
             (push (pop comps) icomplete--scrolled-past)
             (setq icomplete--scrolled-completions comps))
            (t
             (let ((last (last comps)))
               (setcdr (last comps) (cons (pop comps) (cdr last))))))
      (completion--cache-all-sorted-completions beg end comps))))