Function: buffer-to-register

buffer-to-register is an interactive and byte-compiled function defined in register.el.gz.

Signature

(buffer-to-register BUFFER REGISTER)

Documentation

Store reference to BUFFER in REGISTER.

To visit the buffer, use C-x r j (jump-to-register).

Interactively, use current buffer as BUFFER, and prompt for REGISTER. With a prefix argument, prompt for BUFFER as well.

View in manual

Probably introduced at or before Emacs version 31.1.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/register.el.gz
(defun buffer-to-register (buffer register)
  "Store reference to BUFFER in REGISTER.
To visit the buffer, use \\[jump-to-register].

Interactively, use current buffer as BUFFER, and prompt for REGISTER.
With a prefix argument, prompt for BUFFER as well."
  (interactive
   (let ((buffer
          (if current-prefix-arg
              (get-buffer (read-buffer "Store reference to buffer"
                                       (current-buffer) t))
            (current-buffer))))
     (list buffer
           (register-read-with-preview
            (substitute-quotes
             (format "Store reference to buffer `%s' in register: "
                     (buffer-name buffer)))))))
  (with-current-buffer buffer
    (add-hook 'kill-buffer-hook #'register-buffer-to-file-query nil t))
  (set-register register (cons 'buffer buffer)))