Mercurial > emacs
annotate lisp/sort.el @ 9922:f653d8aac66a
(Fmake_overlay, Foverlay_properties, Foverlay_get, Foverlay_put): Use new
overlay substructure.
(list_buffers_1): Use PT, not point.
author | Karl Heuer <kwzh@gnu.org> |
---|---|
date | Tue, 15 Nov 1994 02:02:34 +0000 |
parents | cc7cd83ccf3f |
children | d5a22f90865d |
rev | line source |
---|---|
658
7cbd4fcd8b0f
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
584
diff
changeset
|
1 ;;; sort.el --- commands to sort text in an Emacs buffer. |
7cbd4fcd8b0f
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
584
diff
changeset
|
2 |
7300 | 3 ;; Copyright (C) 1986, 1987, 1994 Free Software Foundation, Inc. |
840
113281b361ec
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
814
diff
changeset
|
4 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
658
diff
changeset
|
5 ;; Author: Howie Kaye |
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
658
diff
changeset
|
6 ;; Maintainer: FSF |
814
38b2499cb3e9
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
807
diff
changeset
|
7 ;; Keywords: unix |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
658
diff
changeset
|
8 |
70 | 9 ;; This file is part of GNU Emacs. |
10 | |
11 ;; GNU Emacs is free software; you can redistribute it and/or modify | |
12 ;; it under the terms of the GNU General Public License as published by | |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
658
diff
changeset
|
13 ;; the Free Software Foundation; either version 2, or (at your option) |
70 | 14 ;; any later version. |
15 | |
16 ;; GNU Emacs is distributed in the hope that it will be useful, | |
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
19 ;; GNU General Public License for more details. | |
20 | |
21 ;; You should have received a copy of the GNU General Public License | |
22 ;; along with GNU Emacs; see the file COPYING. If not, write to | |
23 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. | |
24 | |
2315
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2185
diff
changeset
|
25 ;;; Commentary: |
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2185
diff
changeset
|
26 |
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2185
diff
changeset
|
27 ;;; This package provides the sorting facilities documented in the Emacs |
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2185
diff
changeset
|
28 ;;; user's manual. |
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2185
diff
changeset
|
29 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
658
diff
changeset
|
30 ;;; Code: |
70 | 31 |
3409
09bba81c038f
(sort-fold-case): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
2315
diff
changeset
|
32 (defvar sort-fold-case nil |
09bba81c038f
(sort-fold-case): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
2315
diff
changeset
|
33 "*Non-nil if the buffer sort functions should ignore case.") |
09bba81c038f
(sort-fold-case): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
2315
diff
changeset
|
34 |
6474
79765ff7bfa1
(sort-subr): Add autoload.
Richard M. Stallman <rms@gnu.org>
parents:
5747
diff
changeset
|
35 ;;;###autoload |
70 | 36 (defun sort-subr (reverse nextrecfun endrecfun &optional startkeyfun endkeyfun) |
37 "General text sorting routine to divide buffer into records and sort them. | |
38 Arguments are REVERSE NEXTRECFUN ENDRECFUN &optional STARTKEYFUN ENDKEYFUN. | |
39 | |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
40 We divide the accessible portion of the buffer into disjoint pieces |
998 | 41 called sort records. A portion of each sort record (perhaps all of |
42 it) is designated as the sort key. The records are rearranged in the | |
43 buffer in order by their sort keys. The records may or may not be | |
44 contiguous. | |
70 | 45 |
46 Usually the records are rearranged in order of ascending sort key. | |
47 If REVERSE is non-nil, they are rearranged in order of descending sort key. | |
48 | |
49 The next four arguments are functions to be called to move point | |
50 across a sort record. They will be called many times from within sort-subr. | |
51 | |
52 NEXTRECFUN is called with point at the end of the previous record. | |
53 It moves point to the start of the next record. | |
54 It should move point to the end of the buffer if there are no more records. | |
55 The first record is assumed to start at the position of point when sort-subr | |
56 is called. | |
57 | |
1836 | 58 ENDRECFUN is called with point within the record. |
70 | 59 It should move point to the end of the record. |
60 | |
1836 | 61 STARTKEYFUN moves from the start of the record to the start of the key. |
62 It may return either a non-nil value to be used as the key, or | |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
63 else the key is the substring between the values of point after |
135 | 64 STARTKEYFUN and ENDKEYFUN are called. If STARTKEYFUN is nil, the key |
65 starts at the beginning of the record. | |
70 | 66 |
67 ENDKEYFUN moves from the start of the sort key to the end of the sort key. | |
68 ENDKEYFUN may be nil if STARTKEYFUN returns a value or if it would be the | |
69 same as ENDRECFUN." | |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
70 ;; Heuristically try to avoid messages if sorting a small amt of text. |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
71 (let ((messages (> (- (point-max) (point-min)) 50000))) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
72 (save-excursion |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
73 (if messages (message "Finding sort keys...")) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
74 (let* ((sort-lists (sort-build-lists nextrecfun endrecfun |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
75 startkeyfun endkeyfun)) |
3409
09bba81c038f
(sort-fold-case): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
2315
diff
changeset
|
76 (old (reverse sort-lists)) |
09bba81c038f
(sort-fold-case): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
2315
diff
changeset
|
77 (case-fold-search sort-fold-case)) |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
78 (if (null sort-lists) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
79 () |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
80 (or reverse (setq sort-lists (nreverse sort-lists))) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
81 (if messages (message "Sorting records...")) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
82 (setq sort-lists |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
83 (if (fboundp 'sortcar) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
84 (sortcar sort-lists |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
85 (cond ((numberp (car (car sort-lists))) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
86 ;; This handles both ints and floats. |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
87 '<) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
88 ((consp (car (car sort-lists))) |
1844
d48f094be56e
(sort-build-lists): Record the key as pair of positions;
Richard M. Stallman <rms@gnu.org>
parents:
1836
diff
changeset
|
89 (function |
d48f094be56e
(sort-build-lists): Record the key as pair of positions;
Richard M. Stallman <rms@gnu.org>
parents:
1836
diff
changeset
|
90 (lambda (a b) |
d48f094be56e
(sort-build-lists): Record the key as pair of positions;
Richard M. Stallman <rms@gnu.org>
parents:
1836
diff
changeset
|
91 (> 0 (compare-buffer-substrings |
1845
aeb1a834481b
(sort-subr): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
1844
diff
changeset
|
92 nil (car a) (cdr a) |
aeb1a834481b
(sort-subr): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
1844
diff
changeset
|
93 nil (car b) (cdr b)))))) |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
94 (t |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
95 'string<))) |
998 | 96 (sort sort-lists |
97 (cond ((numberp (car (car sort-lists))) | |
6991
72393aa69dd2
(sort-subr): Use car-less-than-car when appropriate.
Richard M. Stallman <rms@gnu.org>
parents:
6474
diff
changeset
|
98 'car-less-than-car) |
998 | 99 ((consp (car (car sort-lists))) |
100 (function | |
101 (lambda (a b) | |
1844
d48f094be56e
(sort-build-lists): Record the key as pair of positions;
Richard M. Stallman <rms@gnu.org>
parents:
1836
diff
changeset
|
102 (> 0 (compare-buffer-substrings |
1845
aeb1a834481b
(sort-subr): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
1844
diff
changeset
|
103 nil (car (car a)) (cdr (car a)) |
aeb1a834481b
(sort-subr): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
1844
diff
changeset
|
104 nil (car (car b)) (cdr (car b))))))) |
998 | 105 (t |
106 (function | |
107 (lambda (a b) | |
108 (string< (car a) (car b))))))))) | |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
109 (if reverse (setq sort-lists (nreverse sort-lists))) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
110 (if messages (message "Reordering buffer...")) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
111 (sort-reorder-buffer sort-lists old))) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
112 (if messages (message "Reordering buffer... Done")))) |
70 | 113 nil) |
114 | |
115 ;; Parse buffer into records using the arguments as Lisp expressions; | |
136 | 116 ;; return a list of records. Each record looks like (KEY STARTPOS . ENDPOS) |
70 | 117 ;; where KEY is the sort key (a number or string), |
118 ;; and STARTPOS and ENDPOS are the bounds of this record in the buffer. | |
119 | |
120 ;; The records appear in the list lastmost first! | |
121 | |
122 (defun sort-build-lists (nextrecfun endrecfun startkeyfun endkeyfun) | |
123 (let ((sort-lists ()) | |
124 (start-rec nil) | |
125 done key) | |
126 ;; Loop over sort records. | |
127 ;(goto-char (point-min)) -- it is the caller's responsibility to | |
128 ;arrange this if necessary | |
129 (while (not (eobp)) | |
130 (setq start-rec (point)) ;save record start | |
131 (setq done nil) | |
132 ;; Get key value, or move to start of key. | |
133 (setq key (catch 'key | |
134 (or (and startkeyfun (funcall startkeyfun)) | |
135 ;; If key was not returned as value, | |
136 ;; move to end of key and get key from the buffer. | |
137 (let ((start (point))) | |
138 (funcall (or endkeyfun | |
139 (prog1 endrecfun (setq done t)))) | |
1844
d48f094be56e
(sort-build-lists): Record the key as pair of positions;
Richard M. Stallman <rms@gnu.org>
parents:
1836
diff
changeset
|
140 (cons start (point)))))) |
70 | 141 ;; Move to end of this record (start of next one, or end of buffer). |
142 (cond ((prog1 done (setq done nil))) | |
143 (endrecfun (funcall endrecfun)) | |
144 (nextrecfun (funcall nextrecfun) (setq done t))) | |
145 (if key (setq sort-lists (cons | |
146 ;; consing optimization in case in which key | |
147 ;; is same as record. | |
148 (if (and (consp key) | |
149 (equal (car key) start-rec) | |
150 (equal (cdr key) (point))) | |
151 (cons key key) | |
135 | 152 (cons key (cons start-rec (point)))) |
153 sort-lists))) | |
70 | 154 (and (not done) nextrecfun (funcall nextrecfun))) |
155 sort-lists)) | |
156 | |
157 (defun sort-reorder-buffer (sort-lists old) | |
158 (let ((inhibit-quit t) | |
159 (last (point-min)) | |
160 (min (point-min)) (max (point-max))) | |
161 ;; Make sure insertions done for reordering | |
162 ;; do not go after any markers at the end of the sorted region, | |
163 ;; by inserting a space to separate them. | |
164 (goto-char (point-max)) | |
165 (insert-before-markers " ") | |
166 (narrow-to-region min (1- (point-max))) | |
167 (while sort-lists | |
168 (goto-char (point-max)) | |
169 (insert-buffer-substring (current-buffer) | |
170 last | |
171 (nth 1 (car old))) | |
172 (goto-char (point-max)) | |
173 (insert-buffer-substring (current-buffer) | |
174 (nth 1 (car sort-lists)) | |
135 | 175 (cdr (cdr (car sort-lists)))) |
176 (setq last (cdr (cdr (car old))) | |
70 | 177 sort-lists (cdr sort-lists) |
178 old (cdr old))) | |
179 (goto-char (point-max)) | |
180 (insert-buffer-substring (current-buffer) | |
181 last | |
182 max) | |
183 ;; Delete the original copy of the text. | |
184 (delete-region min max) | |
185 ;; Get rid of the separator " ". | |
186 (goto-char (point-max)) | |
187 (narrow-to-region min (1+ (point))) | |
188 (delete-region (point) (1+ (point))))) | |
189 | |
258 | 190 ;;;###autoload |
70 | 191 (defun sort-lines (reverse beg end) |
192 "Sort lines in region alphabetically; argument means descending order. | |
193 Called from a program, there are three arguments: | |
194 REVERSE (non-nil means reverse order), BEG and END (region to sort)." | |
195 (interactive "P\nr") | |
196 (save-excursion | |
197 (save-restriction | |
198 (narrow-to-region beg end) | |
199 (goto-char (point-min)) | |
200 (sort-subr reverse 'forward-line 'end-of-line)))) | |
201 | |
258 | 202 ;;;###autoload |
70 | 203 (defun sort-paragraphs (reverse beg end) |
204 "Sort paragraphs in region alphabetically; argument means descending order. | |
205 Called from a program, there are three arguments: | |
206 REVERSE (non-nil means reverse order), BEG and END (region to sort)." | |
207 (interactive "P\nr") | |
208 (save-excursion | |
209 (save-restriction | |
210 (narrow-to-region beg end) | |
211 (goto-char (point-min)) | |
212 (sort-subr reverse | |
5747
cbd0de32e997
(sort-paragraphs): Use proper paragraph definition instead of just checking
Karl Heuer <kwzh@gnu.org>
parents:
5418
diff
changeset
|
213 (function |
cbd0de32e997
(sort-paragraphs): Use proper paragraph definition instead of just checking
Karl Heuer <kwzh@gnu.org>
parents:
5418
diff
changeset
|
214 (lambda () |
cbd0de32e997
(sort-paragraphs): Use proper paragraph definition instead of just checking
Karl Heuer <kwzh@gnu.org>
parents:
5418
diff
changeset
|
215 (while (and (not (eobp)) (looking-at paragraph-separate)) |
cbd0de32e997
(sort-paragraphs): Use proper paragraph definition instead of just checking
Karl Heuer <kwzh@gnu.org>
parents:
5418
diff
changeset
|
216 (forward-line 1)))) |
70 | 217 'forward-paragraph)))) |
218 | |
258 | 219 ;;;###autoload |
70 | 220 (defun sort-pages (reverse beg end) |
221 "Sort pages in region alphabetically; argument means descending order. | |
222 Called from a program, there are three arguments: | |
223 REVERSE (non-nil means reverse order), BEG and END (region to sort)." | |
224 (interactive "P\nr") | |
225 (save-excursion | |
226 (save-restriction | |
227 (narrow-to-region beg end) | |
228 (goto-char (point-min)) | |
229 (sort-subr reverse | |
230 (function (lambda () (skip-chars-forward "\n"))) | |
231 'forward-page)))) | |
232 | |
233 (defvar sort-fields-syntax-table nil) | |
234 (if sort-fields-syntax-table nil | |
235 (let ((table (make-syntax-table)) | |
236 (i 0)) | |
237 (while (< i 256) | |
238 (modify-syntax-entry i "w" table) | |
239 (setq i (1+ i))) | |
240 (modify-syntax-entry ?\ " " table) | |
241 (modify-syntax-entry ?\t " " table) | |
242 (modify-syntax-entry ?\n " " table) | |
243 (modify-syntax-entry ?\. "_" table) ; for floating pt. numbers. -wsr | |
244 (setq sort-fields-syntax-table table))) | |
245 | |
258 | 246 ;;;###autoload |
70 | 247 (defun sort-numeric-fields (field beg end) |
248 "Sort lines in region numerically by the ARGth field of each line. | |
249 Fields are separated by whitespace and numbered from 1 up. | |
250 Specified field must contain a number in each line of the region. | |
86 | 251 With a negative arg, sorts by the ARGth field counted from the right. |
70 | 252 Called from a program, there are three arguments: |
5418
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
253 FIELD, BEG and END. BEG and END specify region to sort." |
70 | 254 (interactive "p\nr") |
255 (sort-fields-1 field beg end | |
256 (function (lambda () | |
4238
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
257 (sort-skip-fields field) |
2185
5bf3a379d7b5
* sort.el (sort-float-fields, sort-numeric-fields): Use
Jim Blandy <jimb@redhat.com>
parents:
2184
diff
changeset
|
258 (string-to-number |
70 | 259 (buffer-substring |
260 (point) | |
261 (save-excursion | |
262 ;; This is just wrong! Even without floats... | |
263 ;; (skip-chars-forward "[0-9]") | |
264 (forward-sexp 1) | |
265 (point)))))) | |
266 nil)) | |
267 | |
5418
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
268 ;;;;;###autoload |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
269 ;;(defun sort-float-fields (field beg end) |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
270 ;; "Sort lines in region numerically by the ARGth field of each line. |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
271 ;;Fields are separated by whitespace and numbered from 1 up. Specified field |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
272 ;;must contain a floating point number in each line of the region. With a |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
273 ;;negative arg, sorts by the ARGth field counted from the right. Called from a |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
274 ;;program, there are three arguments: FIELD, BEG and END. BEG and END specify |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
275 ;;region to sort." |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
276 ;; (interactive "p\nr") |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
277 ;; (sort-fields-1 field beg end |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
278 ;; (function (lambda () |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
279 ;; (sort-skip-fields field) |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
280 ;; (string-to-number |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
281 ;; (buffer-substring |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
282 ;; (point) |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
283 ;; (save-excursion |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
284 ;; (re-search-forward |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
285 ;; "[+-]?[0-9]*\.?[0-9]*\\([eE][+-]?[0-9]+\\)?") |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
286 ;; (point)))))) |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
287 ;; nil)) |
86 | 288 |
258 | 289 ;;;###autoload |
70 | 290 (defun sort-fields (field beg end) |
291 "Sort lines in region lexicographically by the ARGth field of each line. | |
292 Fields are separated by whitespace and numbered from 1 up. | |
86 | 293 With a negative arg, sorts by the ARGth field counted from the right. |
70 | 294 Called from a program, there are three arguments: |
295 FIELD, BEG and END. BEG and END specify region to sort." | |
296 (interactive "p\nr") | |
297 (sort-fields-1 field beg end | |
298 (function (lambda () | |
4238
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
299 (sort-skip-fields field) |
70 | 300 nil)) |
301 (function (lambda () (skip-chars-forward "^ \t\n"))))) | |
302 | |
303 (defun sort-fields-1 (field beg end startkeyfun endkeyfun) | |
86 | 304 (let ((tbl (syntax-table))) |
305 (if (zerop field) (setq field 1)) | |
70 | 306 (unwind-protect |
307 (save-excursion | |
308 (save-restriction | |
309 (narrow-to-region beg end) | |
310 (goto-char (point-min)) | |
311 (set-syntax-table sort-fields-syntax-table) | |
86 | 312 (sort-subr nil |
70 | 313 'forward-line 'end-of-line |
314 startkeyfun endkeyfun))) | |
315 (set-syntax-table tbl)))) | |
316 | |
4238
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
317 ;; Position at the beginning of field N on the current line, |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
318 ;; assuming point is initially at the beginning of the line. |
70 | 319 (defun sort-skip-fields (n) |
4238
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
320 (if (> n 0) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
321 ;; Skip across N - 1 fields. |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
322 (let ((i (1- n))) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
323 (while (> i 0) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
324 (skip-chars-forward " \t") |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
325 (skip-chars-forward "^ \t\n") |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
326 (setq i (1- i))) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
327 (skip-chars-forward " \t") |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
328 (if (eolp) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
329 (error "Line has too few fields: %s" |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
330 (buffer-substring |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
331 (save-excursion (beginning-of-line) (point)) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
332 (save-excursion (end-of-line) (point)))))) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
333 (end-of-line) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
334 ;; Skip back across - N - 1 fields. |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
335 (let ((i (1- (- n)))) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
336 (while (> i 0) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
337 (skip-chars-backward " \t") |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
338 (skip-chars-backward "^ \t\n") |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
339 (setq i (1- i))) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
340 (skip-chars-backward " \t")) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
341 (if (bolp) |
70 | 342 (error "Line has too few fields: %s" |
4238
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
343 (buffer-substring |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
344 (save-excursion (beginning-of-line) (point)) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
345 (save-excursion (end-of-line) (point))))) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
346 ;; Position at the front of the field |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
347 ;; even if moving backwards. |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
348 (skip-chars-backward "^ \t\n"))) |
70 | 349 |
258 | 350 ;;;###autoload |
70 | 351 (defun sort-regexp-fields (reverse record-regexp key-regexp beg end) |
3591
507f64624555
Apply typo patches from Paul Eggert.
Jim Blandy <jimb@redhat.com>
parents:
3409
diff
changeset
|
352 "Sort the region lexicographically as specified by RECORD-REGEXP and KEY. |
70 | 353 RECORD-REGEXP specifies the textual units which should be sorted. |
354 For example, to sort lines RECORD-REGEXP would be \"^.*$\" | |
355 KEY specifies the part of each record (ie each match for RECORD-REGEXP) | |
356 is to be used for sorting. | |
357 If it is \"\\digit\" then the digit'th \"\\(...\\)\" match field from | |
358 RECORD-REGEXP is used. | |
359 If it is \"\\&\" then the whole record is used. | |
360 Otherwise, it is a regular-expression for which to search within the record. | |
361 If a match for KEY is not found within a record then that record is ignored. | |
362 | |
363 With a negative prefix arg sorts in reverse order. | |
364 | |
365 For example: to sort lines in the region by the first word on each line | |
366 starting with the letter \"f\", | |
367 RECORD-REGEXP would be \"^.*$\" and KEY would be \"\\=\\<f\\w*\\>\"" | |
86 | 368 ;; using negative prefix arg to mean "reverse" is now inconsistent with |
369 ;; other sort-.*fields functions but then again this was before, since it | |
370 ;; didn't use the magnitude of the arg to specify anything. | |
70 | 371 (interactive "P\nsRegexp specifying records to sort: |
372 sRegexp specifying key within record: \nr") | |
373 (cond ((or (equal key-regexp "") (equal key-regexp "\\&")) | |
374 (setq key-regexp 0)) | |
375 ((string-match "\\`\\\\[1-9]\\'" key-regexp) | |
376 (setq key-regexp (- (aref key-regexp 1) ?0)))) | |
377 (save-excursion | |
378 (save-restriction | |
379 (narrow-to-region beg end) | |
380 (goto-char (point-min)) | |
381 (let (sort-regexp-record-end) ;isn't dynamic scoping wonderful? | |
382 (re-search-forward record-regexp) | |
383 (setq sort-regexp-record-end (point)) | |
384 (goto-char (match-beginning 0)) | |
385 (sort-subr reverse | |
386 (function (lambda () | |
387 (and (re-search-forward record-regexp nil 'move) | |
388 (setq sort-regexp-record-end (match-end 0)) | |
389 (goto-char (match-beginning 0))))) | |
390 (function (lambda () | |
391 (goto-char sort-regexp-record-end))) | |
392 (function (lambda () | |
393 (let ((n 0)) | |
394 (cond ((numberp key-regexp) | |
395 (setq n key-regexp)) | |
396 ((re-search-forward | |
397 key-regexp sort-regexp-record-end t) | |
398 (setq n 0)) | |
399 (t (throw 'key nil))) | |
400 (condition-case () | |
401 (if (fboundp 'buffer-substring-lessp) | |
402 (cons (match-beginning n) | |
403 (match-end n)) | |
404 (buffer-substring (match-beginning n) | |
405 (match-end n))) | |
406 ;; if there was no such register | |
407 (error (throw 'key nil))))))))))) | |
408 | |
409 | |
410 (defvar sort-columns-subprocess t) | |
411 | |
258 | 412 ;;;###autoload |
70 | 413 (defun sort-columns (reverse &optional beg end) |
414 "Sort lines in region alphabetically by a certain range of columns. | |
415 For the purpose of this command, the region includes | |
416 the entire line that point is in and the entire line the mark is in. | |
417 The column positions of point and mark bound the range of columns to sort on. | |
418 A prefix argument means sort into reverse order. | |
419 | |
420 Note that `sort-columns' rejects text that contains tabs, | |
421 because tabs could be split across the specified columns | |
422 and it doesn't know how to handle that. Also, when possible, | |
423 it uses the `sort' utility program, which doesn't understand tabs. | |
424 Use \\[untabify] to convert tabs to spaces before sorting." | |
425 (interactive "P\nr") | |
426 (save-excursion | |
427 (let (beg1 end1 col-beg1 col-end1 col-start col-end) | |
428 (goto-char (min beg end)) | |
429 (setq col-beg1 (current-column)) | |
430 (beginning-of-line) | |
431 (setq beg1 (point)) | |
432 (goto-char (max beg end)) | |
433 (setq col-end1 (current-column)) | |
434 (forward-line) | |
435 (setq end1 (point)) | |
436 (setq col-start (min col-beg1 col-end1)) | |
437 (setq col-end (max col-beg1 col-end1)) | |
438 (if (search-backward "\t" beg1 t) | |
439 (error "sort-columns does not work with tabs. Use M-x untabify.")) | |
440 (if (not (eq system-type 'vax-vms)) | |
441 ;; Use the sort utility if we can; it is 4 times as fast. | |
442 (call-process-region beg1 end1 "sort" t t nil | |
443 (if reverse "-rt\n" "-t\n") | |
444 (concat "+0." col-start) | |
445 (concat "-0." col-end)) | |
446 ;; On VMS, use Emacs's own facilities. | |
447 (save-excursion | |
448 (save-restriction | |
449 (narrow-to-region beg1 end1) | |
450 (goto-char beg1) | |
451 (sort-subr reverse 'forward-line 'end-of-line | |
452 (function (lambda () (move-to-column col-start) nil)) | |
453 (function (lambda () (move-to-column col-end) nil))))))))) | |
86 | 454 |
258 | 455 ;;;###autoload |
86 | 456 (defun reverse-region (beg end) |
457 "Reverse the order of lines in a region. | |
458 From a program takes two point or marker arguments, BEG and END." | |
459 (interactive "r") | |
460 (if (> beg end) | |
461 (let (mid) (setq mid end end beg beg mid))) | |
462 (save-excursion | |
463 ;; put beg at the start of a line and end and the end of one -- | |
464 ;; the largest possible region which fits this criteria | |
465 (goto-char beg) | |
466 (or (bolp) (forward-line 1)) | |
467 (setq beg (point)) | |
468 (goto-char end) | |
469 ;; the test for bolp is for those times when end is on an empty line; | |
470 ;; it is probably not the case that the line should be included in the | |
471 ;; reversal; it isn't difficult to add it afterward. | |
472 (or (and (eolp) (not (bolp))) (progn (forward-line -1) (end-of-line))) | |
473 (setq end (point-marker)) | |
474 ;; the real work. this thing cranks through memory on large regions. | |
475 (let (ll (do t)) | |
476 (while do | |
477 (goto-char beg) | |
478 (setq ll (cons (buffer-substring (point) (progn (end-of-line) (point))) | |
479 ll)) | |
480 (setq do (/= (point) end)) | |
481 (delete-region beg (if do (1+ (point)) (point)))) | |
482 (while (cdr ll) | |
483 (insert (car ll) "\n") | |
484 (setq ll (cdr ll))) | |
485 (insert (car ll))))) | |
584 | 486 |
487 (provide 'sort) | |
488 | |
658
7cbd4fcd8b0f
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
584
diff
changeset
|
489 ;;; sort.el ends here |