1 ;;; register.el --- register commands for Emacs.
3 ;; Copyright (C) 1985 Free Software Foundation, Inc.
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software; you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation; either version 2, or (at your option)
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs; see the file COPYING. If not, write to
22 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
26 ;; This package of functions emulates and somewhat extends the venerable
27 ;; TECO's `register' feature, which permits you to save various useful
28 ;; pieces of buffer state to named variables. The entry points are
29 ;; documented in the Emacs user's manual.
33 (defvar register-alist nil
34 "Alist of elements (NAME . CONTENTS), one for each Emacs register.
35 NAME is a character (a number). CONTENTS is a string, number,
36 frame configuration, mark or list.
37 A list of strings represents a rectangle.
38 A list of the form (file . NAME) represents the file named NAME.")
40 (defun get-register (char)
41 "Return contents of Emacs register named CHAR, or nil if none."
42 (cdr (assq char register-alist
)))
44 (defun set-register (char value
)
45 "Set contents of Emacs register named CHAR to VALUE. Returns VALUE.
46 See the documentation of the variable `register-alist' for possible VALUE."
47 (let ((aelt (assq char register-alist
)))
50 (setq aelt
(cons char value
))
51 (setq register-alist
(cons aelt register-alist
)))
54 (defun point-to-register (char &optional arg
)
55 "Store current location of point in register REGISTER.
56 With prefix argument, store current frame configuration.
57 Use \\[jump-to-register] to go to that location or restore that configuration.
58 Argument is a character, naming the register."
59 (interactive "cPoint to register: \nP")
60 (set-register char
(if arg
(current-frame-configuration) (point-marker))))
62 (defun window-configuration-to-register (char &optional arg
)
63 "Store the window configuration of the selected frame in register REGISTER.
64 Use \\[jump-to-register] to restore the configuration.
65 Argument is a character, naming the register."
66 (interactive "cPoint to register: \nP")
67 (set-register char
(current-window-configuration)))
69 (defun frame-configuration-to-register (char &optional arg
)
70 "Store the window configuration of all frames in register REGISTER.
71 Use \\[jump-to-register] to restore the configuration.
72 Argument is a character, naming the register."
73 (interactive "cPoint to register: \nP")
74 (set-register char
(current-frame-configuration)))
76 (defalias 'register-to-point
'jump-to-register
)
77 (defun jump-to-register (char)
78 "Move point to location stored in a register.
79 If the register contains a file name, find that file.
80 \(To put a file name in a register, you must use `set-register'.)
81 If the register contains a window configuration (one frame) or a frame
82 configuration (all frames), restore that frame or all frames accordingly.
83 Argument is a character, naming the register."
84 (interactive "cJump to register: ")
85 (let ((val (get-register char
)))
87 ((frame-configuration-p val
)
88 (set-frame-configuration val
))
89 ((window-configuration-p val
)
90 (set-window-configuration val
))
92 (switch-to-buffer (marker-buffer val
))
94 ((and (consp val
) (eq (car val
) 'file
))
95 (find-file (cdr val
)))
97 (error "Register doesn't contain a buffer position or configuration")))))
99 ;(defun number-to-register (arg char)
100 ; "Store a number in a register.
101 ;Two args, NUMBER and REGISTER (a character, naming the register).
102 ;If NUMBER is nil, digits in the buffer following point are read
103 ;to get the number to store.
104 ;Interactively, NUMBER is the prefix arg (none means nil)."
105 ; (interactive "P\ncNumber to register: ")
108 ; (prefix-numeric-value arg)
109 ; (if (looking-at "[0-9][0-9]*")
112 ; (narrow-to-region (point)
113 ; (progn (skip-chars-forward "0-9")
115 ; (goto-char (point-min))
116 ; (read (current-buffer))))
119 ;(defun increment-register (arg char)
120 ; "Add NUMBER to the contents of register REGISTER.
121 ;Interactively, NUMBER is the prefix arg (none means nil)."
122 ; (interactive "p\ncNumber to register: ")
123 ; (or (integerp (get-register char))
124 ; (error "Register does not contain a number"))
125 ; (set-register char (+ arg (get-register char))))
127 (defun view-register (char)
128 "Display what is contained in register named REGISTER.
129 REGISTER is a character."
130 (interactive "cView register: ")
131 (let ((val (get-register char
)))
133 (message "Register %s is empty" (single-key-description char
))
134 (with-output-to-temp-buffer "*Output*"
136 (princ (single-key-description char
))
143 (princ "a buffer position:\nbuffer ")
144 (princ (buffer-name (marker-buffer val
)))
145 (princ ", position ")
148 ((window-configuration-p val
)
149 (princ "a window configuration."))
151 ((frame-configuration-p val
)
152 (princ "a frame configuration."))
155 (princ "the rectangle:\n")
159 (setq val
(cdr val
))))
162 (princ "the text:\n")
169 (defun insert-register (char &optional arg
)
170 "Insert contents of register REG. REG is a character.
171 Normally puts point before and mark after the inserted text.
172 If optional second arg is non-nil, puts mark before and point after.
173 Interactively, second arg is non-nil if prefix arg is supplied."
174 (interactive "cInsert register: \nP")
176 (let ((val (get-register char
)))
178 (insert-rectangle val
)
181 (if (or (integerp val
) (markerp val
))
182 (princ (+ 0 val
) (current-buffer))
183 (error "Register does not contain text")))))
184 (if (not arg
) (exchange-point-and-mark)))
186 (defun copy-to-register (char start end
&optional delete-flag
)
187 "Copy region into register REG. With prefix arg, delete as well.
188 Called from program, takes four args: REG, START, END and DELETE-FLAG.
189 START and END are buffer positions indicating what to copy."
190 (interactive "cCopy to register: \nr\nP")
191 (set-register char
(buffer-substring start end
))
192 (if delete-flag
(delete-region start end
)))
194 (defun append-to-register (char start end
&optional delete-flag
)
195 "Append region to text in register REG. With prefix arg, delete as well.
196 Called from program, takes four args: REG, START, END and DELETE-FLAG.
197 START and END are buffer positions indicating what to append."
198 (interactive "cAppend to register: \nr\nP")
199 (or (stringp (get-register char
))
200 (error "Register does not contain text"))
201 (set-register char
(concat (get-register char
)
202 (buffer-substring start end
)))
203 (if delete-flag
(delete-region start end
)))
205 (defun prepend-to-register (char start end
&optional delete-flag
)
206 "Prepend region to text in register REG. With prefix arg, delete as well.
207 Called from program, takes four args: REG, START, END and DELETE-FLAG.
208 START and END are buffer positions indicating what to prepend."
209 (interactive "cPrepend to register: \nr\nP")
210 (or (stringp (get-register char
))
211 (error "Register does not contain text"))
212 (set-register char
(concat (buffer-substring start end
)
213 (get-register char
)))
214 (if delete-flag
(delete-region start end
)))
216 (defun copy-rectangle-to-register (char start end
&optional delete-flag
)
217 "Copy rectangular region into register REG. With prefix arg, delete as well.
218 Called from program, takes four args: REG, START, END and DELETE-FLAG.
219 START and END are buffer positions giving two corners of rectangle."
220 (interactive "cCopy rectangle to register: \nr\nP")
223 (delete-extract-rectangle start end
)
224 (extract-rectangle start end
))))
226 ;;; register.el ends here