|
219
|
1 ;;; rect.el --- rectangle functions for XEmacs.
|
|
|
2
|
|
398
|
3 ;; Copyright (C) 1985, 1993, 1994, 1999 Free Software Foundation, Inc.
|
|
219
|
4
|
|
398
|
5 ;; Maintainer: Didier Verna <verna@inf.enst.fr>
|
|
219
|
6 ;; Keywords: internal
|
|
|
7
|
|
|
8 ;; This file is part of XEmacs.
|
|
|
9
|
|
|
10 ;; XEmacs is free software; you can redistribute it and/or modify it
|
|
|
11 ;; under the terms of the GNU General Public License as published by
|
|
|
12 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
13 ;; any later version.
|
|
|
14
|
|
|
15 ;; XEmacs is distributed in the hope that it will be useful, but
|
|
|
16 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
18 ;; General Public License for more details.
|
|
|
19
|
|
|
20 ;; You should have received a copy of the GNU General Public License
|
|
|
21 ;; along with XEmacs; see the file COPYING. If not, write to the Free
|
|
|
22 ;; Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
|
|
|
23 ;; 02111-1307, USA.
|
|
|
24
|
|
398
|
25 ;;; Synched up with: to be incorporated in a forthcoming GNU Emacs
|
|
219
|
26
|
|
|
27 ;;; Commentary:
|
|
|
28
|
|
398
|
29 ;; This package provides the operations on rectangles that are documented
|
|
219
|
30 ;; in the XEmacs Reference Manual.
|
|
|
31
|
|
398
|
32 ;; #### NOTE: this file has been almost completely rewritten by Didier Verna
|
|
|
33 ;; <verna@inf.enst.fr>, Jul 99. The purpose of this rewrite is to be less
|
|
|
34 ;; intrusive and fill lines with whitespaces only when needed. A few functions
|
|
|
35 ;; are untouched though, as noted above their definition.
|
|
|
36
|
|
|
37
|
|
219
|
38 ;;; Code:
|
|
|
39
|
|
398
|
40 ;; #### NOTE: this function is untouched, but not used anymore.
|
|
|
41 ;; `apply-on-rectangle' is used instead. It's still there because it's
|
|
|
42 ;; documented so people might use it in their code, so I've decided not to
|
|
|
43 ;; touch it. --dv
|
|
219
|
44 ;; XEmacs: extra-args
|
|
|
45 (defun operate-on-rectangle (function start end coerce-tabs &rest extra-args)
|
|
|
46 "Call FUNCTION for each line of rectangle with corners at START, END.
|
|
|
47 If COERCE-TABS is non-nil, convert multi-column characters
|
|
|
48 that span the starting or ending columns on any line
|
|
|
49 to multiple spaces before calling FUNCTION.
|
|
|
50 FUNCTION is called with three arguments:
|
|
|
51 position of start of segment of this line within the rectangle,
|
|
|
52 number of columns that belong to rectangle but are before that position,
|
|
|
53 number of columns that belong to rectangle but are after point.
|
|
|
54 Point is at the end of the segment of this line within the rectangle."
|
|
|
55 (let (startcol startlinepos endcol endlinepos)
|
|
|
56 (save-excursion
|
|
398
|
57 (goto-char start)
|
|
|
58 (setq startcol (current-column))
|
|
|
59 (beginning-of-line)
|
|
|
60 (setq startlinepos (point)))
|
|
219
|
61 (save-excursion
|
|
398
|
62 (goto-char end)
|
|
|
63 (setq endcol (current-column))
|
|
|
64 (forward-line 1)
|
|
|
65 (setq endlinepos (point-marker)))
|
|
219
|
66 (if (< endcol startcol)
|
|
|
67 ;; XEmacs
|
|
|
68 (let ((tem startcol))
|
|
|
69 (setq startcol endcol endcol tem)))
|
|
|
70 (save-excursion
|
|
|
71 (goto-char startlinepos)
|
|
|
72 (while (< (point) endlinepos)
|
|
|
73 (let (startpos begextra endextra)
|
|
|
74 (move-to-column startcol coerce-tabs)
|
|
|
75 (setq begextra (- (current-column) startcol))
|
|
|
76 (setq startpos (point))
|
|
|
77 (move-to-column endcol coerce-tabs)
|
|
|
78 (setq endextra (- endcol (current-column)))
|
|
|
79 (if (< begextra 0)
|
|
|
80 (setq endextra (+ endextra begextra)
|
|
|
81 begextra 0))
|
|
|
82 (if (< endextra 0) (setq endextra 0))
|
|
|
83 (apply function startpos begextra endextra extra-args))
|
|
|
84 (forward-line 1)))
|
|
|
85 (- endcol startcol)))
|
|
|
86
|
|
398
|
87 ;; The replacement for `operate-on-rectangle' -- dv
|
|
|
88 (defun apply-on-rectangle (function start end &rest args)
|
|
|
89 "Call FUNCTION for each line of rectangle with corners at START and END.
|
|
|
90 FUNCTION is called with two arguments: the start and end columns of the
|
|
|
91 rectangle, plus ARGS extra arguments. Point is at the beginning of line
|
|
|
92 when the function is called."
|
|
|
93 (let (startcol startpt endcol endpt)
|
|
|
94 (save-excursion
|
|
|
95 (goto-char start)
|
|
|
96 (setq startcol (current-column))
|
|
|
97 (beginning-of-line)
|
|
|
98 (setq startpt (point))
|
|
|
99 (goto-char end)
|
|
|
100 (setq endcol (current-column))
|
|
|
101 (forward-line 1)
|
|
|
102 (setq endpt (point-marker))
|
|
|
103 ;; ensure the start column is the left one.
|
|
|
104 (if (< endcol startcol)
|
|
|
105 (let ((col startcol))
|
|
|
106 (setq startcol endcol endcol col)))
|
|
|
107 ;; start looping over lines
|
|
|
108 (goto-char startpt)
|
|
|
109 (while (< (point) endpt)
|
|
|
110 (apply function startcol endcol args)
|
|
|
111 (forward-line 1)))
|
|
|
112 ))
|
|
219
|
113
|
|
398
|
114 ;; I love ascii art ;-)
|
|
|
115 (defconst spaces-strings '[""
|
|
|
116 " "
|
|
|
117 " "
|
|
|
118 " "
|
|
|
119 " "
|
|
|
120 " "
|
|
|
121 " "
|
|
|
122 " "
|
|
|
123 " "])
|
|
219
|
124
|
|
|
125
|
|
398
|
126 ;; This function is untouched --dv
|
|
219
|
127 (defun spaces-string (n)
|
|
|
128 (if (<= n 8) (aref spaces-strings n)
|
|
|
129 (let ((val ""))
|
|
|
130 (while (> n 8)
|
|
|
131 (setq val (concat " " val)
|
|
|
132 n (- n 8)))
|
|
|
133 (concat val (aref spaces-strings n)))))
|
|
398
|
134
|
|
|
135 ;;;###autoload
|
|
|
136 (defvar killed-rectangle nil
|
|
|
137 "Rectangle for `yank-rectangle' to insert.")
|
|
|
138
|
|
219
|
139 ;;;###autoload
|
|
398
|
140 (defun kill-rectangle (start end &optional fill)
|
|
|
141 "Delete the region-rectangle and save it as the last killed one.
|
|
|
142 You might prefer to use `delete-extract-rectangle' from a program.
|
|
|
143
|
|
|
144 When called from a program, the rectangle's corners are START and END.
|
|
|
145 With a prefix (or FILL) argument, also fill lines where nothing has to be
|
|
|
146 deleted."
|
|
|
147 (interactive "*r\nP")
|
|
|
148 (when buffer-read-only
|
|
|
149 (setq killed-rectangle (extract-rectangle start end))
|
|
|
150 (barf-if-buffer-read-only))
|
|
|
151 (setq killed-rectangle (delete-extract-rectangle start end fill)))
|
|
219
|
152
|
|
|
153 ;;;###autoload
|
|
398
|
154 (defun delete-rectangle (start end &optional fill)
|
|
|
155 "Delete the text in the region-rectangle without saving it.
|
|
|
156 The same range of columns is deleted in each line starting with the line
|
|
|
157 where the region begins and ending with the line where the region ends.
|
|
|
158
|
|
|
159 When called from a program, the rectangle's corners are START and END.
|
|
|
160 With a prefix (or FILL) argument, also fill lines where nothing has to be
|
|
|
161 deleted."
|
|
|
162 (interactive "*r\nP")
|
|
|
163 (apply-on-rectangle 'delete-rectangle-line start end fill))
|
|
|
164
|
|
|
165 (defun delete-rectangle-line (startcol endcol fill)
|
|
|
166 (let ((pt (point-at-eol)))
|
|
|
167 (when (= (move-to-column startcol (or fill 'coerce)) startcol)
|
|
|
168 (if (and (not fill) (<= pt endcol))
|
|
|
169 (delete-region (point) pt)
|
|
|
170 ;; else
|
|
|
171 (setq pt (point))
|
|
|
172 (move-to-column endcol t)
|
|
|
173 (delete-region pt (point))))
|
|
|
174 ))
|
|
|
175
|
|
|
176 ;;;###autoload
|
|
|
177 (defun delete-extract-rectangle (start end &optional fill)
|
|
|
178 "Delete the contents of the rectangle with corners at START and END, and
|
|
|
179 return it as a list of strings, one for each line of the rectangle.
|
|
|
180
|
|
|
181 With an optional FILL argument, also fill lines where nothing has to be
|
|
|
182 deleted."
|
|
|
183 (let ((lines (list nil)))
|
|
|
184 (apply-on-rectangle 'delete-extract-rectangle-line start end lines fill)
|
|
219
|
185 (nreverse (cdr lines))))
|
|
|
186
|
|
398
|
187 (defun delete-extract-rectangle-line (startcol endcol lines fill)
|
|
|
188 (let ((pt (point-at-eol)))
|
|
|
189 (if (< (move-to-column startcol (or fill 'coerce)) startcol)
|
|
|
190 (setcdr lines (cons (spaces-string (- endcol startcol))
|
|
|
191 (cdr lines)))
|
|
|
192 ;; else
|
|
|
193 (setq pt (point))
|
|
|
194 (move-to-column endcol t)
|
|
|
195 (setcdr lines (cons (buffer-substring pt (point)) (cdr lines)))
|
|
|
196 (delete-region pt (point)))
|
|
|
197 ))
|
|
|
198
|
|
219
|
199 ;;;###autoload
|
|
|
200 (defun extract-rectangle (start end)
|
|
398
|
201 "Return the contents of the rectangle with corners at START and END,
|
|
|
202 as a list of strings, one for each line of the rectangle."
|
|
|
203 (let ((lines (list nil)))
|
|
|
204 (apply-on-rectangle 'extract-rectangle-line start end lines)
|
|
219
|
205 (nreverse (cdr lines))))
|
|
|
206
|
|
398
|
207 ;; #### NOTE: this is actually the only function that needs to do complicated
|
|
|
208 ;; stuff like what's happening in `operate-on-rectangle', because the buffer
|
|
|
209 ;; might be read-only. --dv
|
|
|
210 (defun extract-rectangle-line (startcol endcol lines)
|
|
|
211 (let (start end begextra endextra line)
|
|
|
212 (move-to-column startcol)
|
|
|
213 (setq start (point)
|
|
|
214 begextra (- (current-column) startcol))
|
|
|
215 (move-to-column endcol)
|
|
|
216 (setq end (point)
|
|
|
217 endextra (- endcol (current-column)))
|
|
|
218 (setq line (buffer-substring start (point)))
|
|
|
219 (if (< begextra 0)
|
|
|
220 (setq endextra (+ endextra begextra)
|
|
|
221 begextra 0))
|
|
|
222 (if (< endextra 0)
|
|
|
223 (setq endextra 0))
|
|
|
224 (goto-char start)
|
|
|
225 (while (search-forward "\t" end t)
|
|
|
226 (let ((width (- (current-column)
|
|
|
227 (save-excursion (forward-char -1)
|
|
|
228 (current-column)))))
|
|
|
229 (setq line (concat (substring line 0 (- (point) end 1))
|
|
|
230 (spaces-string width)
|
|
|
231 (substring line (+ (length line)
|
|
|
232 (- (point) end)))))))
|
|
|
233 (if (or (> begextra 0) (> endextra 0))
|
|
|
234 (setq line (concat (spaces-string begextra)
|
|
|
235 line
|
|
|
236 (spaces-string endextra))))
|
|
|
237 (setcdr lines (cons line (cdr lines)))))
|
|
219
|
238
|
|
398
|
239 ;; This function is untouched --dv
|
|
219
|
240 ;;;###autoload
|
|
|
241 (defun yank-rectangle ()
|
|
|
242 "Yank the last killed rectangle with upper left corner at point."
|
|
398
|
243 (interactive "*")
|
|
219
|
244 (insert-rectangle killed-rectangle))
|
|
|
245
|
|
398
|
246 ;; This function is untouched --dv
|
|
219
|
247 ;;;###autoload
|
|
|
248 (defun insert-rectangle (rectangle)
|
|
|
249 "Insert text of RECTANGLE with upper left corner at point.
|
|
|
250 RECTANGLE's first line is inserted at point, its second
|
|
|
251 line is inserted at a point vertically under point, etc.
|
|
|
252 RECTANGLE should be a list of strings.
|
|
|
253 After this command, the mark is at the upper left corner
|
|
|
254 and point is at the lower right corner."
|
|
|
255 (let ((lines rectangle)
|
|
|
256 (insertcolumn (current-column))
|
|
|
257 (first t))
|
|
|
258 (push-mark)
|
|
|
259 (while lines
|
|
|
260 (or first
|
|
|
261 (progn
|
|
398
|
262 (forward-line 1)
|
|
|
263 (or (bolp) (insert ?\n))
|
|
|
264 (move-to-column insertcolumn t)))
|
|
219
|
265 (setq first nil)
|
|
|
266 (insert (car lines))
|
|
|
267 (setq lines (cdr lines)))))
|
|
|
268
|
|
|
269 ;;;###autoload
|
|
398
|
270 (defun open-rectangle (start end &optional fill)
|
|
|
271 "Blank out the region-rectangle, shifting text right.
|
|
|
272
|
|
|
273 When called from a program, the rectangle's corners are START and END.
|
|
|
274 With a prefix (or FILL) argument, fill with blanks even if there is no text
|
|
|
275 on the right side of the rectangle."
|
|
|
276 (interactive "*r\nP")
|
|
|
277 (apply-on-rectangle 'open-rectangle-line start end fill)
|
|
219
|
278 (goto-char start))
|
|
|
279
|
|
398
|
280 (defun open-rectangle-line (startcol endcol fill)
|
|
|
281 (let (spaces)
|
|
|
282 (when (= (move-to-column startcol (or fill 'coerce)) startcol)
|
|
|
283 (unless (and (not fill)
|
|
|
284 (= (point) (point-at-eol)))
|
|
|
285 (indent-to endcol)))
|
|
|
286 ))
|
|
219
|
287
|
|
|
288 ;;;###autoload
|
|
|
289 (defun string-rectangle (start end string)
|
|
|
290 "Insert STRING on each line of the region-rectangle, shifting text right.
|
|
398
|
291 The left edge of the rectangle specifies the column for insertion. This
|
|
|
292 command does not delete or overwrite any existing text.
|
|
219
|
293
|
|
398
|
294 When called from a program, the rectangle's corners are START and END."
|
|
|
295 (interactive "*r\nsString rectangle: ")
|
|
|
296 (apply-on-rectangle 'string-rectangle-line start end string))
|
|
|
297
|
|
|
298 (defun string-rectangle-line (startcol endcol string)
|
|
|
299 (move-to-column startcol t)
|
|
|
300 (insert string))
|
|
219
|
301
|
|
|
302 ;;;###autoload
|
|
398
|
303 (defun clear-rectangle (start end &optional fill)
|
|
|
304 "Blank out the region-rectangle.
|
|
|
305 The text previously in the region is overwritten with blanks.
|
|
|
306
|
|
|
307 When called from a program, the rectangle's corners are START and END.
|
|
|
308 With a prefix (or FILL) argument, also fill with blanks the parts of the
|
|
|
309 rectangle which were empty."
|
|
|
310 (interactive "*r\nP")
|
|
|
311 (apply-on-rectangle 'clear-rectangle-line start end fill))
|
|
219
|
312
|
|
398
|
313 (defun clear-rectangle-line (startcol endcol fill)
|
|
|
314 (let ((pt (point-at-eol))
|
|
|
315 spaces)
|
|
|
316 (when (= (move-to-column startcol (or fill 'coerce)) startcol)
|
|
|
317 (if (and (not fill)
|
|
|
318 (<= (save-excursion (goto-char pt) (current-column)) endcol))
|
|
|
319 (delete-region (point) pt)
|
|
|
320 ;; else
|
|
|
321 (setq pt (point))
|
|
|
322 (move-to-column endcol t)
|
|
|
323 (setq spaces (- (point) pt))
|
|
|
324 (delete-region pt (point))
|
|
|
325 (indent-to (+ (current-column) spaces))))
|
|
|
326 ))
|
|
219
|
327
|
|
|
328 (provide 'rect)
|
|
|
329
|
|
|
330 ;;; rect.el ends here
|
