Mercurial > emacs
annotate lisp/sort.el @ 49968:80ed3e75ba10
(read-envvar-name): Decode names.
(substitute-env-vars): Use eval-when-compile and char class.
(setenv): Doc fix. Encode the data (after checking that's
possible).
(getenv): Encode the name and decode the result.
author | Dave Love <fx@gnu.org> |
---|---|
date | Mon, 24 Feb 2003 22:51:41 +0000 |
parents | c205b3bd7372 |
children | 180066f315b2 d7ddb3e565de |
rev | line source |
---|---|
38412
253f761ad37b
Some fixes to follow coding conventions in files maintained by FSF.
Pavel Janík <Pavel@Janik.cz>
parents:
34601
diff
changeset
|
1 ;;; sort.el --- commands to sort text in an Emacs buffer |
658
7cbd4fcd8b0f
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
584
diff
changeset
|
2 |
49128
93b43f689e56
(sort-regexp-fields): pass noerror to
Karl Berry <karl@gnu.org>
parents:
44521
diff
changeset
|
3 ;; Copyright (C) 1986, 1987, 1994, 1995, 2003 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 | |
14169 | 22 ;; along with GNU Emacs; see the file COPYING. If not, write to the |
23 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
24 ;; Boston, MA 02111-1307, USA. | |
70 | 25 |
2315
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2185
diff
changeset
|
26 ;;; Commentary: |
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2185
diff
changeset
|
27 |
14169 | 28 ;; This package provides the sorting facilities documented in the Emacs |
29 ;; user's manual. | |
2315
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2185
diff
changeset
|
30 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
658
diff
changeset
|
31 ;;; Code: |
70 | 32 |
19418 | 33 (defgroup sort nil |
34 "Commands to sort text in an Emacs buffer." | |
35 :group 'data) | |
36 | |
37 (defcustom sort-fold-case nil | |
38 "*Non-nil if the buffer sort functions should ignore case." | |
39 :group 'sort | |
40 :type 'boolean) | |
3409
09bba81c038f
(sort-fold-case): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
2315
diff
changeset
|
41 |
6474
79765ff7bfa1
(sort-subr): Add autoload.
Richard M. Stallman <rms@gnu.org>
parents:
5747
diff
changeset
|
42 ;;;###autoload |
70 | 43 (defun sort-subr (reverse nextrecfun endrecfun &optional startkeyfun endkeyfun) |
44 "General text sorting routine to divide buffer into records and sort them. | |
45 | |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
46 We divide the accessible portion of the buffer into disjoint pieces |
998 | 47 called sort records. A portion of each sort record (perhaps all of |
48 it) is designated as the sort key. The records are rearranged in the | |
49 buffer in order by their sort keys. The records may or may not be | |
50 contiguous. | |
70 | 51 |
52 Usually the records are rearranged in order of ascending sort key. | |
53 If REVERSE is non-nil, they are rearranged in order of descending sort key. | |
16765 | 54 The variable `sort-fold-case' determines whether alphabetic case affects |
55 the sort order. | |
70 | 56 |
57 The next four arguments are functions to be called to move point | |
58 across a sort record. They will be called many times from within sort-subr. | |
59 | |
60 NEXTRECFUN is called with point at the end of the previous record. | |
61 It moves point to the start of the next record. | |
62 It should move point to the end of the buffer if there are no more records. | |
63 The first record is assumed to start at the position of point when sort-subr | |
64 is called. | |
65 | |
1836 | 66 ENDRECFUN is called with point within the record. |
70 | 67 It should move point to the end of the record. |
68 | |
1836 | 69 STARTKEYFUN moves from the start of the record to the start of the key. |
70 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
|
71 else the key is the substring between the values of point after |
135 | 72 STARTKEYFUN and ENDKEYFUN are called. If STARTKEYFUN is nil, the key |
73 starts at the beginning of the record. | |
70 | 74 |
75 ENDKEYFUN moves from the start of the sort key to the end of the sort key. | |
76 ENDKEYFUN may be nil if STARTKEYFUN returns a value or if it would be the | |
77 same as ENDRECFUN." | |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
78 ;; 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
|
79 (let ((messages (> (- (point-max) (point-min)) 50000))) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
80 (save-excursion |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
81 (if messages (message "Finding sort keys...")) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
82 (let* ((sort-lists (sort-build-lists nextrecfun endrecfun |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
83 startkeyfun endkeyfun)) |
3409
09bba81c038f
(sort-fold-case): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
2315
diff
changeset
|
84 (old (reverse sort-lists)) |
09bba81c038f
(sort-fold-case): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
2315
diff
changeset
|
85 (case-fold-search sort-fold-case)) |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
86 (if (null sort-lists) |
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 (or reverse (setq sort-lists (nreverse sort-lists))) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
89 (if messages (message "Sorting records...")) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
90 (setq sort-lists |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
91 (if (fboundp 'sortcar) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
92 (sortcar sort-lists |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
93 (cond ((numberp (car (car sort-lists))) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
94 ;; This handles both ints and floats. |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
95 '<) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
96 ((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
|
97 (function |
d48f094be56e
(sort-build-lists): Record the key as pair of positions;
Richard M. Stallman <rms@gnu.org>
parents:
1836
diff
changeset
|
98 (lambda (a b) |
49597
e88404e8f2cf
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49128
diff
changeset
|
99 (> 0 (compare-buffer-substrings |
1845
aeb1a834481b
(sort-subr): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
1844
diff
changeset
|
100 nil (car a) (cdr a) |
aeb1a834481b
(sort-subr): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
1844
diff
changeset
|
101 nil (car b) (cdr b)))))) |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
102 (t |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
103 'string<))) |
998 | 104 (sort sort-lists |
105 (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
|
106 'car-less-than-car) |
998 | 107 ((consp (car (car sort-lists))) |
108 (function | |
109 (lambda (a b) | |
49597
e88404e8f2cf
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49128
diff
changeset
|
110 (> 0 (compare-buffer-substrings |
1845
aeb1a834481b
(sort-subr): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
1844
diff
changeset
|
111 nil (car (car a)) (cdr (car a)) |
aeb1a834481b
(sort-subr): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
1844
diff
changeset
|
112 nil (car (car b)) (cdr (car b))))))) |
998 | 113 (t |
114 (function | |
115 (lambda (a b) | |
116 (string< (car a) (car b))))))))) | |
996
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
117 (if reverse (setq sort-lists (nreverse sort-lists))) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
118 (if messages (message "Reordering buffer...")) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
119 (sort-reorder-buffer sort-lists old))) |
0e8ace07a231
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
840
diff
changeset
|
120 (if messages (message "Reordering buffer... Done")))) |
70 | 121 nil) |
122 | |
123 ;; Parse buffer into records using the arguments as Lisp expressions; | |
136 | 124 ;; return a list of records. Each record looks like (KEY STARTPOS . ENDPOS) |
70 | 125 ;; where KEY is the sort key (a number or string), |
126 ;; and STARTPOS and ENDPOS are the bounds of this record in the buffer. | |
127 | |
128 ;; The records appear in the list lastmost first! | |
129 | |
130 (defun sort-build-lists (nextrecfun endrecfun startkeyfun endkeyfun) | |
131 (let ((sort-lists ()) | |
132 (start-rec nil) | |
133 done key) | |
134 ;; Loop over sort records. | |
135 ;(goto-char (point-min)) -- it is the caller's responsibility to | |
136 ;arrange this if necessary | |
137 (while (not (eobp)) | |
138 (setq start-rec (point)) ;save record start | |
139 (setq done nil) | |
140 ;; Get key value, or move to start of key. | |
141 (setq key (catch 'key | |
142 (or (and startkeyfun (funcall startkeyfun)) | |
143 ;; If key was not returned as value, | |
144 ;; move to end of key and get key from the buffer. | |
145 (let ((start (point))) | |
146 (funcall (or endkeyfun | |
147 (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
|
148 (cons start (point)))))) |
70 | 149 ;; Move to end of this record (start of next one, or end of buffer). |
150 (cond ((prog1 done (setq done nil))) | |
151 (endrecfun (funcall endrecfun)) | |
152 (nextrecfun (funcall nextrecfun) (setq done t))) | |
153 (if key (setq sort-lists (cons | |
154 ;; consing optimization in case in which key | |
155 ;; is same as record. | |
156 (if (and (consp key) | |
157 (equal (car key) start-rec) | |
158 (equal (cdr key) (point))) | |
159 (cons key key) | |
135 | 160 (cons key (cons start-rec (point)))) |
161 sort-lists))) | |
70 | 162 (and (not done) nextrecfun (funcall nextrecfun))) |
163 sort-lists)) | |
164 | |
165 (defun sort-reorder-buffer (sort-lists old) | |
42284
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
166 (let ((last (point-min)) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
167 (min (point-min)) (max (point-max)) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
168 (old-buffer (current-buffer)) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
169 temp-buffer) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
170 (with-temp-buffer |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
171 ;; Record the temporary buffer. |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
172 (setq temp-buffer (current-buffer)) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
173 |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
174 ;; Copy the sorted text into the temporary buffer. |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
175 (while sort-lists |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
176 (goto-char (point-max)) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
177 (insert-buffer-substring old-buffer |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
178 last |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
179 (nth 1 (car old))) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
180 (goto-char (point-max)) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
181 (insert-buffer-substring old-buffer |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
182 (nth 1 (car sort-lists)) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
183 (cdr (cdr (car sort-lists)))) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
184 (setq last (cdr (cdr (car old))) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
185 sort-lists (cdr sort-lists) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
186 old (cdr old))) |
70 | 187 (goto-char (point-max)) |
44521
d0c94b4f58f6
(sort-reorder-buffer): Don't assume point-min == 1.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
42284
diff
changeset
|
188 (insert-buffer-substring old-buffer last max) |
42284
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
189 |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
190 ;; Copy the reordered text from the temporary buffer |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
191 ;; to the buffer we sorted (OLD-BUFFER). |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
192 (set-buffer old-buffer) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
193 (let ((inhibit-quit t)) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
194 ;; Make sure insertions done for reordering |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
195 ;; do not go after any markers at the end of the sorted region, |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
196 ;; by inserting a space to separate them. |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
197 (goto-char max) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
198 (insert-before-markers " ") |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
199 ;; Delete the original copy of the text. |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
200 (delete-region min max) |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
201 ;; Now replace the separator " " with the sorted text. |
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
202 (goto-char (point-max)) |
44521
d0c94b4f58f6
(sort-reorder-buffer): Don't assume point-min == 1.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
42284
diff
changeset
|
203 (insert-buffer-substring temp-buffer) |
42284
b8c51fd416a8
(sort-reorder-buffer): Copy all to a temp buffer first.
Richard M. Stallman <rms@gnu.org>
parents:
38412
diff
changeset
|
204 (delete-region min (1+ min)))))) |
70 | 205 |
258 | 206 ;;;###autoload |
49597
e88404e8f2cf
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49128
diff
changeset
|
207 (defun sort-lines (reverse beg end) |
70 | 208 "Sort lines in region alphabetically; argument means descending order. |
209 Called from a program, there are three arguments: | |
16765 | 210 REVERSE (non-nil means reverse order), BEG and END (region to sort). |
211 The variable `sort-fold-case' determines whether alphabetic case affects | |
212 the sort order." | |
70 | 213 (interactive "P\nr") |
214 (save-excursion | |
215 (save-restriction | |
216 (narrow-to-region beg end) | |
217 (goto-char (point-min)) | |
218 (sort-subr reverse 'forward-line 'end-of-line)))) | |
219 | |
258 | 220 ;;;###autoload |
70 | 221 (defun sort-paragraphs (reverse beg end) |
222 "Sort paragraphs in region alphabetically; argument means descending order. | |
223 Called from a program, there are three arguments: | |
16765 | 224 REVERSE (non-nil means reverse order), BEG and END (region to sort). |
225 The variable `sort-fold-case' determines whether alphabetic case affects | |
226 the sort order." | |
70 | 227 (interactive "P\nr") |
228 (save-excursion | |
229 (save-restriction | |
230 (narrow-to-region beg end) | |
231 (goto-char (point-min)) | |
232 (sort-subr reverse | |
5747
cbd0de32e997
(sort-paragraphs): Use proper paragraph definition instead of just checking
Karl Heuer <kwzh@gnu.org>
parents:
5418
diff
changeset
|
233 (function |
cbd0de32e997
(sort-paragraphs): Use proper paragraph definition instead of just checking
Karl Heuer <kwzh@gnu.org>
parents:
5418
diff
changeset
|
234 (lambda () |
cbd0de32e997
(sort-paragraphs): Use proper paragraph definition instead of just checking
Karl Heuer <kwzh@gnu.org>
parents:
5418
diff
changeset
|
235 (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
|
236 (forward-line 1)))) |
70 | 237 'forward-paragraph)))) |
238 | |
258 | 239 ;;;###autoload |
70 | 240 (defun sort-pages (reverse beg end) |
241 "Sort pages in region alphabetically; argument means descending order. | |
242 Called from a program, there are three arguments: | |
16765 | 243 REVERSE (non-nil means reverse order), BEG and END (region to sort). |
244 The variable `sort-fold-case' determines whether alphabetic case affects | |
245 the sort order." | |
70 | 246 (interactive "P\nr") |
247 (save-excursion | |
248 (save-restriction | |
249 (narrow-to-region beg end) | |
250 (goto-char (point-min)) | |
251 (sort-subr reverse | |
252 (function (lambda () (skip-chars-forward "\n"))) | |
253 'forward-page)))) | |
254 | |
255 (defvar sort-fields-syntax-table nil) | |
256 (if sort-fields-syntax-table nil | |
257 (let ((table (make-syntax-table)) | |
258 (i 0)) | |
259 (while (< i 256) | |
260 (modify-syntax-entry i "w" table) | |
261 (setq i (1+ i))) | |
262 (modify-syntax-entry ?\ " " table) | |
263 (modify-syntax-entry ?\t " " table) | |
264 (modify-syntax-entry ?\n " " table) | |
265 (modify-syntax-entry ?\. "_" table) ; for floating pt. numbers. -wsr | |
266 (setq sort-fields-syntax-table table))) | |
267 | |
27468
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
268 (defcustom sort-numeric-base 10 |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
269 "*The default base used by `sort-numeric-fields'." |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
270 :group 'sort |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
271 :type 'integer) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
272 |
258 | 273 ;;;###autoload |
70 | 274 (defun sort-numeric-fields (field beg end) |
275 "Sort lines in region numerically by the ARGth field of each line. | |
276 Fields are separated by whitespace and numbered from 1 up. | |
27468
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
277 Specified field must contain a number in each line of the region, |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
278 which may begin with \"0x\" or \"0\" for hexadecimal and octal values. |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
279 Otherwise, the number is interpreted according to sort-numeric-base. |
86 | 280 With a negative arg, sorts by the ARGth field counted from the right. |
70 | 281 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
|
282 FIELD, BEG and END. BEG and END specify region to sort." |
70 | 283 (interactive "p\nr") |
284 (sort-fields-1 field beg end | |
27468
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
285 (lambda () |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
286 (sort-skip-fields field) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
287 (let* ((case-fold-search t) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
288 (base |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
289 (if (looking-at "\\(0x\\)[0-9a-f]\\|\\(0\\)[0-7]") |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
290 (cond ((match-beginning 1) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
291 (goto-char (match-end 1)) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
292 16) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
293 ((match-beginning 2) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
294 (goto-char (match-end 2)) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
295 8) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
296 (t nil))))) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
297 (string-to-number (buffer-substring (point) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
298 (save-excursion |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
299 (forward-sexp 1) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
300 (point))) |
8a6ee5b485d2
(sort-numeric-base): New option.
Gerd Moellmann <gerd@gnu.org>
parents:
19418
diff
changeset
|
301 (or base sort-numeric-base)))) |
70 | 302 nil)) |
303 | |
5418
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
304 ;;;;;###autoload |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
305 ;;(defun sort-float-fields (field beg end) |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
306 ;; "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
|
307 ;;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
|
308 ;;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
|
309 ;;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
|
310 ;;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
|
311 ;;region to sort." |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
312 ;; (interactive "p\nr") |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
313 ;; (sort-fields-1 field beg end |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
314 ;; (function (lambda () |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
315 ;; (sort-skip-fields field) |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
316 ;; (string-to-number |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
317 ;; (buffer-substring |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
318 ;; (point) |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
319 ;; (save-excursion |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
320 ;; (re-search-forward |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
321 ;; "[+-]?[0-9]*\.?[0-9]*\\([eE][+-]?[0-9]+\\)?") |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
322 ;; (point)))))) |
6eb86cda3856
(sort-float-fields): Commented out.
Richard M. Stallman <rms@gnu.org>
parents:
4247
diff
changeset
|
323 ;; nil)) |
86 | 324 |
258 | 325 ;;;###autoload |
70 | 326 (defun sort-fields (field beg end) |
327 "Sort lines in region lexicographically by the ARGth field of each line. | |
328 Fields are separated by whitespace and numbered from 1 up. | |
86 | 329 With a negative arg, sorts by the ARGth field counted from the right. |
70 | 330 Called from a program, there are three arguments: |
16765 | 331 FIELD, BEG and END. BEG and END specify region to sort. |
332 The variable `sort-fold-case' determines whether alphabetic case affects | |
333 the sort order." | |
70 | 334 (interactive "p\nr") |
335 (sort-fields-1 field beg end | |
336 (function (lambda () | |
4238
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
337 (sort-skip-fields field) |
70 | 338 nil)) |
339 (function (lambda () (skip-chars-forward "^ \t\n"))))) | |
340 | |
341 (defun sort-fields-1 (field beg end startkeyfun endkeyfun) | |
86 | 342 (let ((tbl (syntax-table))) |
343 (if (zerop field) (setq field 1)) | |
70 | 344 (unwind-protect |
345 (save-excursion | |
346 (save-restriction | |
347 (narrow-to-region beg end) | |
348 (goto-char (point-min)) | |
349 (set-syntax-table sort-fields-syntax-table) | |
86 | 350 (sort-subr nil |
70 | 351 'forward-line 'end-of-line |
352 startkeyfun endkeyfun))) | |
353 (set-syntax-table tbl)))) | |
354 | |
4238
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
355 ;; 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
|
356 ;; assuming point is initially at the beginning of the line. |
70 | 357 (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
|
358 (if (> n 0) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
359 ;; Skip across N - 1 fields. |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
360 (let ((i (1- n))) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
361 (while (> i 0) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
362 (skip-chars-forward " \t") |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
363 (skip-chars-forward "^ \t\n") |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
364 (setq i (1- i))) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
365 (skip-chars-forward " \t") |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
366 (if (eolp) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
367 (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
|
368 (buffer-substring |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
369 (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
|
370 (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
|
371 (end-of-line) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
372 ;; 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
|
373 (let ((i (1- (- n)))) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
374 (while (> i 0) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
375 (skip-chars-backward " \t") |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
376 (skip-chars-backward "^ \t\n") |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
377 (setq i (1- i))) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
378 (skip-chars-backward " \t")) |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
379 (if (bolp) |
70 | 380 (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
|
381 (buffer-substring |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
382 (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
|
383 (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
|
384 ;; 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
|
385 ;; even if moving backwards. |
6a22eb586080
(sort-skip-fields): Really implement fields as runs
Richard M. Stallman <rms@gnu.org>
parents:
3591
diff
changeset
|
386 (skip-chars-backward "^ \t\n"))) |
70 | 387 |
10763
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
388 (defvar sort-regexp-fields-regexp) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
389 (defvar sort-regexp-record-end) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
390 |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
391 ;; Move to the beginning of the next match for record-regexp, |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
392 ;; and set sort-regexp-record-end to the end of that match. |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
393 ;; If the next match is empty and does not advance point, |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
394 ;; skip one character and try again. |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
395 (defun sort-regexp-fields-next-record () |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
396 (let ((oldpos (point))) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
397 (and (re-search-forward sort-regexp-fields-regexp nil 'move) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
398 (setq sort-regexp-record-end (match-end 0)) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
399 (if (= sort-regexp-record-end oldpos) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
400 (progn |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
401 (forward-char 1) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
402 (re-search-forward sort-regexp-fields-regexp nil 'move) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
403 (setq sort-regexp-record-end (match-end 0))) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
404 t) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
405 (goto-char (match-beginning 0))))) |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
406 |
258 | 407 ;;;###autoload |
70 | 408 (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
|
409 "Sort the region lexicographically as specified by RECORD-REGEXP and KEY. |
70 | 410 RECORD-REGEXP specifies the textual units which should be sorted. |
411 For example, to sort lines RECORD-REGEXP would be \"^.*$\" | |
412 KEY specifies the part of each record (ie each match for RECORD-REGEXP) | |
413 is to be used for sorting. | |
13643
146c5daf3019
(sort-regexp-fields): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
11235
diff
changeset
|
414 If it is \"\\\\digit\" then the digit'th \"\\\\(...\\\\)\" match field from |
70 | 415 RECORD-REGEXP is used. |
13643
146c5daf3019
(sort-regexp-fields): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
11235
diff
changeset
|
416 If it is \"\\\\&\" then the whole record is used. |
70 | 417 Otherwise, it is a regular-expression for which to search within the record. |
418 If a match for KEY is not found within a record then that record is ignored. | |
419 | |
420 With a negative prefix arg sorts in reverse order. | |
421 | |
16765 | 422 The variable `sort-fold-case' determines whether alphabetic case affects |
423 the sort order. | |
424 | |
70 | 425 For example: to sort lines in the region by the first word on each line |
426 starting with the letter \"f\", | |
13643
146c5daf3019
(sort-regexp-fields): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
11235
diff
changeset
|
427 RECORD-REGEXP would be \"^.*$\" and KEY would be \"\\\\=\\<f\\\\w*\\\\>\"" |
86 | 428 ;; using negative prefix arg to mean "reverse" is now inconsistent with |
429 ;; other sort-.*fields functions but then again this was before, since it | |
430 ;; didn't use the magnitude of the arg to specify anything. | |
49597
e88404e8f2cf
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49128
diff
changeset
|
431 (interactive "P\nsRegexp specifying records to sort: |
70 | 432 sRegexp specifying key within record: \nr") |
433 (cond ((or (equal key-regexp "") (equal key-regexp "\\&")) | |
434 (setq key-regexp 0)) | |
435 ((string-match "\\`\\\\[1-9]\\'" key-regexp) | |
436 (setq key-regexp (- (aref key-regexp 1) ?0)))) | |
437 (save-excursion | |
438 (save-restriction | |
439 (narrow-to-region beg end) | |
440 (goto-char (point-min)) | |
10763
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
441 (let (sort-regexp-record-end |
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
442 (sort-regexp-fields-regexp record-regexp)) |
49128
93b43f689e56
(sort-regexp-fields): pass noerror to
Karl Berry <karl@gnu.org>
parents:
44521
diff
changeset
|
443 (re-search-forward sort-regexp-fields-regexp nil t) |
70 | 444 (setq sort-regexp-record-end (point)) |
445 (goto-char (match-beginning 0)) | |
446 (sort-subr reverse | |
10763
d5a22f90865d
(sort-regexp-fields-next-record): New subroutine.
Richard M. Stallman <rms@gnu.org>
parents:
7300
diff
changeset
|
447 'sort-regexp-fields-next-record |
70 | 448 (function (lambda () |
449 (goto-char sort-regexp-record-end))) | |
450 (function (lambda () | |
451 (let ((n 0)) | |
452 (cond ((numberp key-regexp) | |
453 (setq n key-regexp)) | |
454 ((re-search-forward | |
455 key-regexp sort-regexp-record-end t) | |
456 (setq n 0)) | |
457 (t (throw 'key nil))) | |
458 (condition-case () | |
16765 | 459 (cons (match-beginning n) |
460 (match-end n)) | |
70 | 461 ;; if there was no such register |
462 (error (throw 'key nil))))))))))) | |
463 | |
464 | |
465 (defvar sort-columns-subprocess t) | |
466 | |
258 | 467 ;;;###autoload |
70 | 468 (defun sort-columns (reverse &optional beg end) |
469 "Sort lines in region alphabetically by a certain range of columns. | |
33993
d38d6c74805d
(sort-columns): Don't concat strings with numbers.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
33555
diff
changeset
|
470 For the purpose of this command, the region BEG...END includes |
70 | 471 the entire line that point is in and the entire line the mark is in. |
472 The column positions of point and mark bound the range of columns to sort on. | |
33993
d38d6c74805d
(sort-columns): Don't concat strings with numbers.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
33555
diff
changeset
|
473 A prefix argument means sort into REVERSE order. |
16765 | 474 The variable `sort-fold-case' determines whether alphabetic case affects |
475 the sort order. | |
70 | 476 |
477 Note that `sort-columns' rejects text that contains tabs, | |
478 because tabs could be split across the specified columns | |
479 and it doesn't know how to handle that. Also, when possible, | |
480 it uses the `sort' utility program, which doesn't understand tabs. | |
481 Use \\[untabify] to convert tabs to spaces before sorting." | |
482 (interactive "P\nr") | |
483 (save-excursion | |
484 (let (beg1 end1 col-beg1 col-end1 col-start col-end) | |
485 (goto-char (min beg end)) | |
486 (setq col-beg1 (current-column)) | |
487 (beginning-of-line) | |
488 (setq beg1 (point)) | |
489 (goto-char (max beg end)) | |
490 (setq col-end1 (current-column)) | |
491 (forward-line) | |
492 (setq end1 (point)) | |
493 (setq col-start (min col-beg1 col-end1)) | |
494 (setq col-end (max col-beg1 col-end1)) | |
495 (if (search-backward "\t" beg1 t) | |
34601
5ca359ff87e6
(sort-columns): Fix error message.
Gerd Moellmann <gerd@gnu.org>
parents:
33993
diff
changeset
|
496 (error "sort-columns does not work with tabs -- use M-x untabify")) |
16655
c7b0fffd4c2e
(sort-columns): Don't use `sort' utility if the text has text properties.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
497 (if (not (or (eq system-type 'vax-vms) |
c7b0fffd4c2e
(sort-columns): Don't use `sort' utility if the text has text properties.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
498 (text-properties-at beg1) |
c7b0fffd4c2e
(sort-columns): Don't use `sort' utility if the text has text properties.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
499 (< (next-property-change beg1 nil end1) end1))) |
70 | 500 ;; Use the sort utility if we can; it is 4 times as fast. |
16655
c7b0fffd4c2e
(sort-columns): Don't use `sort' utility if the text has text properties.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
501 ;; Do not use it if there are any properties in the region, |
c7b0fffd4c2e
(sort-columns): Don't use `sort' utility if the text has text properties.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
502 ;; since the sort utility would lose the properties. |
33555
a77843a1f4e4
(sort-columns): If sort-fold-case it non-nil, invoke
Gerd Moellmann <gerd@gnu.org>
parents:
27468
diff
changeset
|
503 (let ((sort-args (list (if reverse "-rt\n" "-t\n") |
33993
d38d6c74805d
(sort-columns): Don't concat strings with numbers.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
33555
diff
changeset
|
504 (concat "+0." (int-to-string col-start)) |
d38d6c74805d
(sort-columns): Don't concat strings with numbers.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
33555
diff
changeset
|
505 (concat "-0." (int-to-string col-end))))) |
33555
a77843a1f4e4
(sort-columns): If sort-fold-case it non-nil, invoke
Gerd Moellmann <gerd@gnu.org>
parents:
27468
diff
changeset
|
506 (when sort-fold-case |
a77843a1f4e4
(sort-columns): If sort-fold-case it non-nil, invoke
Gerd Moellmann <gerd@gnu.org>
parents:
27468
diff
changeset
|
507 (push "-f" sort-args)) |
a77843a1f4e4
(sort-columns): If sort-fold-case it non-nil, invoke
Gerd Moellmann <gerd@gnu.org>
parents:
27468
diff
changeset
|
508 (apply #'call-process-region beg1 end1 "sort" t t nil sort-args)) |
70 | 509 ;; On VMS, use Emacs's own facilities. |
510 (save-excursion | |
511 (save-restriction | |
512 (narrow-to-region beg1 end1) | |
513 (goto-char beg1) | |
514 (sort-subr reverse 'forward-line 'end-of-line | |
33555
a77843a1f4e4
(sort-columns): If sort-fold-case it non-nil, invoke
Gerd Moellmann <gerd@gnu.org>
parents:
27468
diff
changeset
|
515 #'(lambda () (move-to-column col-start) nil) |
a77843a1f4e4
(sort-columns): If sort-fold-case it non-nil, invoke
Gerd Moellmann <gerd@gnu.org>
parents:
27468
diff
changeset
|
516 #'(lambda () (move-to-column col-end) nil)))))))) |
86 | 517 |
258 | 518 ;;;###autoload |
86 | 519 (defun reverse-region (beg end) |
520 "Reverse the order of lines in a region. | |
521 From a program takes two point or marker arguments, BEG and END." | |
522 (interactive "r") | |
523 (if (> beg end) | |
524 (let (mid) (setq mid end end beg beg mid))) | |
525 (save-excursion | |
526 ;; put beg at the start of a line and end and the end of one -- | |
527 ;; the largest possible region which fits this criteria | |
528 (goto-char beg) | |
529 (or (bolp) (forward-line 1)) | |
530 (setq beg (point)) | |
531 (goto-char end) | |
532 ;; the test for bolp is for those times when end is on an empty line; | |
533 ;; it is probably not the case that the line should be included in the | |
534 ;; reversal; it isn't difficult to add it afterward. | |
535 (or (and (eolp) (not (bolp))) (progn (forward-line -1) (end-of-line))) | |
536 (setq end (point-marker)) | |
537 ;; the real work. this thing cranks through memory on large regions. | |
538 (let (ll (do t)) | |
539 (while do | |
540 (goto-char beg) | |
541 (setq ll (cons (buffer-substring (point) (progn (end-of-line) (point))) | |
542 ll)) | |
543 (setq do (/= (point) end)) | |
544 (delete-region beg (if do (1+ (point)) (point)))) | |
545 (while (cdr ll) | |
546 (insert (car ll) "\n") | |
547 (setq ll (cdr ll))) | |
548 (insert (car ll))))) | |
584 | 549 |
550 (provide 'sort) | |
551 | |
658
7cbd4fcd8b0f
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
584
diff
changeset
|
552 ;;; sort.el ends here |