Commit | Line | Data |
---|---|---|
6594deb0 ER |
1 | ;;; mail-utils.el --- utility functions used both by rmail and rnews |
2 | ||
9750e079 ER |
3 | ;; Copyright (C) 1985 Free Software Foundation, Inc. |
4 | ||
e5167999 | 5 | ;; Maintainer: FSF |
fd7fa35a | 6 | ;; Keywords: mail, news |
e5167999 | 7 | |
a2535589 JA |
8 | ;; This file is part of GNU Emacs. |
9 | ||
10 | ;; GNU Emacs is free software; you can redistribute it and/or modify | |
11 | ;; it under the terms of the GNU General Public License as published by | |
e5167999 | 12 | ;; the Free Software Foundation; either version 2, or (at your option) |
a2535589 JA |
13 | ;; any later version. |
14 | ||
15 | ;; GNU Emacs is distributed in the hope that it will be useful, | |
16 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 | ;; GNU General Public License for more details. | |
19 | ||
20 | ;; You should have received a copy of the GNU General Public License | |
b578f267 EN |
21 | ;; along with GNU Emacs; see the file COPYING. If not, write to the |
22 | ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
23 | ;; Boston, MA 02111-1307, USA. | |
a2535589 | 24 | |
e41b2db1 ER |
25 | ;;; Commentary: |
26 | ||
ca10c3d1 | 27 | ;; Utility functions for mail and netnews handling. These handle fine |
e41b2db1 ER |
28 | ;; points of header parsing. |
29 | ||
e5167999 | 30 | ;;; Code: |
a2535589 | 31 | |
ecca85de JB |
32 | ;;; We require lisp-mode to make sure that lisp-mode-syntax-table has |
33 | ;;; been initialized. | |
34 | (require 'lisp-mode) | |
a2535589 | 35 | |
73fa8346 | 36 | ;;;###autoload |
7aa122f4 | 37 | (defcustom mail-use-rfc822 nil "\ |
73fa8346 BP |
38 | *If non-nil, use a full, hairy RFC822 parser on mail addresses. |
39 | Otherwise, (the default) use a smaller, somewhat faster, and | |
7aa122f4 SE |
40 | often correct parser." |
41 | :type 'boolean | |
42 | :group 'mail) | |
a2535589 | 43 | |
996792b1 RS |
44 | ;; Returns t if file FILE is an Rmail file. |
45 | ;;;###autoload | |
46 | (defun mail-file-babyl-p (file) | |
47 | (let ((buf (generate-new-buffer " *rmail-file-p*"))) | |
48 | (unwind-protect | |
49 | (save-excursion | |
50 | (set-buffer buf) | |
51 | (insert-file-contents file nil 0 100) | |
52 | (looking-at "BABYL OPTIONS:")) | |
53 | (kill-buffer buf)))) | |
54 | ||
a2535589 JA |
55 | (defun mail-string-delete (string start end) |
56 | "Returns a string containing all of STRING except the part | |
57 | from START (inclusive) to END (exclusive)." | |
58 | (if (null end) (substring string 0 start) | |
59 | (concat (substring string 0 start) | |
60 | (substring string end nil)))) | |
61 | ||
60ba61bb | 62 | ;;;###autoload |
1d6a4283 RS |
63 | (defun mail-quote-printable (string &optional wrapper) |
64 | "Convert a string to the \"quoted printable\" Q encoding. | |
65 | If the optional argument WRAPPER is non-nil, | |
444dd0b5 | 66 | we add the wrapper characters =?ISO-8859-1?Q?....?=." |
1d6a4283 RS |
67 | (let ((i 0) (result "")) |
68 | (save-match-data | |
69 | (while (string-match "[?=\"\200-\377]" string i) | |
70 | (setq result | |
71 | (concat result (substring string i (match-beginning 0)) | |
72 | (upcase (format "=%02x" | |
73 | (aref string (match-beginning 0)))))) | |
74 | (setq i (match-end 0))) | |
75 | (if wrapper | |
444dd0b5 | 76 | (concat "=?ISO-8859-1?Q?" |
1d6a4283 | 77 | result (substring string i) |
444dd0b5 | 78 | "?=") |
1d6a4283 RS |
79 | (concat result (substring string i)))))) |
80 | ||
81 | (defun mail-unquote-printable-hexdigit (char) | |
82 | (if (>= char ?A) | |
83 | (+ (- char ?A) 10) | |
84 | (- char ?0))) | |
85 | ||
60ba61bb | 86 | ;;;###autoload |
1d6a4283 RS |
87 | (defun mail-unquote-printable (string &optional wrapper) |
88 | "Undo the \"quoted printable\" encoding. | |
89 | If the optional argument WRAPPER is non-nil, | |
444dd0b5 | 90 | we expect to find and remove the wrapper characters =?ISO-8859-1?Q?....?=." |
1d6a4283 RS |
91 | (save-match-data |
92 | (and wrapper | |
444dd0b5 | 93 | (string-match "\\`=\\?ISO-8859-1\\?Q\\?\\([^?]*\\)\\?" string) |
1d6a4283 | 94 | (setq string (match-string 1 string))) |
60ba61bb KH |
95 | (let ((i 0) strings) |
96 | (while (string-match "=\\(..\\|\n\\)" string i) | |
97 | (setq strings (cons (substring string i (match-beginning 0)) strings)) | |
98 | (unless (= (aref string (match-beginning 1)) ?\n) | |
99 | (setq strings | |
100 | (cons (make-string 1 | |
1d6a4283 RS |
101 | (+ (* 16 (mail-unquote-printable-hexdigit |
102 | (aref string (match-beginning 1)))) | |
103 | (mail-unquote-printable-hexdigit | |
60ba61bb KH |
104 | (aref string (1+ (match-beginning 1)))))) |
105 | strings))) | |
1d6a4283 | 106 | (setq i (match-end 0))) |
60ba61bb KH |
107 | (apply 'concat (nreverse (cons (substring string i) strings)))))) |
108 | ||
109 | ;;;###autoload | |
110 | (defun mail-unquote-printable-region (beg end &optional wrapper) | |
111 | "Undo the \"quoted printable\" encoding in buffer from BEG to END. | |
112 | If the optional argument WRAPPER is non-nil, | |
113 | we expect to find and remove the wrapper characters =?ISO-8859-1?Q?....?=." | |
114 | (interactive "r\nP") | |
115 | (save-match-data | |
116 | (save-excursion | |
117 | (save-restriction | |
118 | (narrow-to-region beg end) | |
119 | (goto-char (point-min)) | |
120 | (when (and wrapper | |
121 | (looking-at "\\`=\\?ISO-8859-1\\?Q\\?\\([^?]*\\)\\?")) | |
122 | (delete-region (match-end 1) end) | |
123 | (delete-region (point) (match-beginning 1))) | |
124 | (while (re-search-forward "=\\(..\\|\n\\)" nil t) | |
125 | (goto-char (match-end 0)) | |
126 | (replace-match | |
127 | (if (= (char-after (match-beginning 1)) ?\n) | |
128 | "" | |
129 | (make-string 1 | |
130 | (+ (* 16 (mail-unquote-printable-hexdigit | |
131 | (char-after (match-beginning 1)))) | |
132 | (mail-unquote-printable-hexdigit | |
133 | (char-after (1+ (match-beginning 1))))))) | |
134 | t t)))))) | |
1d6a4283 | 135 | |
a2535589 JA |
136 | (defun mail-strip-quoted-names (address) |
137 | "Delete comments and quoted strings in an address list ADDRESS. | |
138 | Also delete leading/trailing whitespace and replace FOO <BAR> with just BAR. | |
139 | Return a modified address list." | |
10a4c11f JB |
140 | (if (null address) |
141 | nil | |
142 | (if mail-use-rfc822 | |
143 | (progn (require 'rfc822) | |
144 | (mapconcat 'identity (rfc822-addresses address) ", ")) | |
145 | (let (pos) | |
a2535589 | 146 | |
10a4c11f | 147 | ;; Detect nested comments. |
2c9d345f | 148 | (if (string-match "[ \t]*(\\([^)\\]\\|\\\\.\\|\\\\\n\\)*(" address) |
10a4c11f | 149 | ;; Strip nested comments. |
82d22193 | 150 | (with-current-buffer (get-buffer-create " *temp*") |
10a4c11f JB |
151 | (erase-buffer) |
152 | (insert address) | |
153 | (set-syntax-table lisp-mode-syntax-table) | |
154 | (goto-char 1) | |
155 | (while (search-forward "(" nil t) | |
156 | (forward-char -1) | |
157 | (skip-chars-backward " \t") | |
158 | (delete-region (point) | |
c5fb599f RS |
159 | (save-excursion |
160 | (condition-case () | |
161 | (forward-sexp 1) | |
162 | (error (goto-char (point-max)))) | |
163 | (point)))) | |
10a4c11f JB |
164 | (setq address (buffer-string)) |
165 | (erase-buffer)) | |
166 | ;; Strip non-nested comments an easier way. | |
167 | (while (setq pos (string-match | |
168 | ;; This doesn't hack rfc822 nested comments | |
169 | ;; `(xyzzy (foo) whinge)' properly. Big deal. | |
2c9d345f | 170 | "[ \t]*(\\([^)\\]\\|\\\\.\\|\\\\\n\\)*)" |
10a4c11f | 171 | address)) |
82d22193 | 172 | (setq address (replace-match "" nil nil address 0)))) |
a2535589 | 173 | |
ee019c84 RS |
174 | ;; strip surrounding whitespace |
175 | (string-match "\\`[ \t\n]*" address) | |
176 | (setq address (substring address | |
177 | (match-end 0) | |
178 | (string-match "[ \t\n]*\\'" address | |
179 | (match-end 0)))) | |
180 | ||
10a4c11f JB |
181 | ;; strip `quoted' names (This is supposed to hack `"Foo Bar" <bar@host>') |
182 | (setq pos 0) | |
183 | (while (setq pos (string-match | |
82d22193 | 184 | "\\([ \t]?\\)\\([ \t]*\"\\([^\"\\]\\|\\\\.\\|\\\\\n\\)*\"[ \t\n]*\\)" |
10a4c11f JB |
185 | address pos)) |
186 | ;; If the next thing is "@", we have "foo bar"@host. Leave it. | |
187 | (if (and (> (length address) (match-end 0)) | |
188 | (= (aref address (match-end 0)) ?@)) | |
189 | (setq pos (match-end 0)) | |
82d22193 RS |
190 | ;; Otherwise discard the "..." part. |
191 | (setq address (replace-match "" nil nil address 2)))) | |
192 | ;; If this address contains <...>, replace it with just | |
193 | ;; the part between the <...>. | |
194 | (while (setq pos (string-match "\\(,\\s-*\\|\\`\\)\\([^,]*<\\([^>,:]*\\)>[^,]*\\)\\(\\s-*,\\|\\'\\)" | |
10a4c11f | 195 | address)) |
82d22193 RS |
196 | (setq address (replace-match (match-string 3 address) |
197 | nil nil address 2))) | |
10a4c11f | 198 | address)))) |
a2535589 JA |
199 | |
200 | ; rmail-dont-reply-to-names is defined in loaddefs | |
201 | (defun rmail-dont-reply-to (userids) | |
202 | "Returns string of mail addresses USERIDS sans any recipients | |
c7c0858d | 203 | that start with matches for `rmail-dont-reply-to-names'. |
a2535589 JA |
204 | Usenet paths ending in an element that matches are removed also." |
205 | (if (null rmail-dont-reply-to-names) | |
206 | (setq rmail-dont-reply-to-names | |
207 | (concat (if rmail-default-dont-reply-to-names | |
208 | (concat rmail-default-dont-reply-to-names "\\|") | |
209 | "") | |
28b46139 | 210 | (concat (regexp-quote (user-login-name)) |
a2535589 | 211 | "\\>")))) |
fa9b4b91 RS |
212 | (let ((match (concat "\\(^\\|,\\)[ \t\n]*" |
213 | ;; Can anyone figure out what this is for? | |
214 | ;; Is it an obsolete remnant of another way of | |
215 | ;; handling Foo Bar <foo@machine>? | |
216 | "\\([^,\n]*[!<]\\|\\)" | |
217 | "\\(" | |
218 | rmail-dont-reply-to-names | |
219 | "\\|" | |
220 | ;; Include the human name that precedes <foo@bar>. | |
221 | "\\([^\,.<\"]\\|\"[^\"]*\"\\)*" | |
222 | "<\\(" rmail-dont-reply-to-names "\\)" | |
a0b796e3 | 223 | "\\)[^,]*")) |
a2535589 JA |
224 | (case-fold-search t) |
225 | pos epos) | |
fa9b4b91 | 226 | (while (setq pos (string-match match userids pos)) |
a0b796e3 GM |
227 | ;; If there's a match, it starts at the beginning of the string, |
228 | ;; or with `,'. We must delete from that position to the | |
229 | ;; end of the user-id which starts at match-beginning 2. | |
82d22193 | 230 | (let (inside-quotes quote-pos last-quote-pos) |
a0b796e3 GM |
231 | (save-match-data |
232 | (while (and (setq quote-pos (string-match "\"" userids quote-pos)) | |
233 | (< quote-pos pos)) | |
82d22193 | 234 | (setq last-quote-pos quote-pos) |
a0b796e3 GM |
235 | (setq quote-pos (1+ quote-pos)) |
236 | (setq inside-quotes (not inside-quotes)))) | |
fa9b4b91 | 237 | (if inside-quotes |
82d22193 RS |
238 | (if (string-match "\"" userids pos) |
239 | (setq pos (string-match "\"" userids pos)) | |
240 | ;; If the open-quote has no close-quote, | |
241 | ;; delete the open-quote to get something well-defined. | |
242 | ;; This case is not valid, but it can happen if things | |
243 | ;; are weird elsewhere. | |
244 | (setq userids (replace-match "" nil nil userids)) | |
245 | (setq userids (concat (substring userids 0 last-quote-pos) | |
246 | (substring userids (1+ last-quote-pos)))) | |
247 | (setq pos (1- pos))) | |
a0b796e3 | 248 | (setq userids (replace-match "" nil nil userids))))) |
a2535589 JA |
249 | ;; get rid of any trailing commas |
250 | (if (setq pos (string-match "[ ,\t\n]*\\'" userids)) | |
251 | (setq userids (substring userids 0 pos))) | |
252 | ;; remove leading spaces. they bother me. | |
97bd30eb | 253 | (if (string-match "\\(\\s \\|,\\)*" userids) |
a2535589 JA |
254 | (substring userids (match-end 0)) |
255 | userids))) | |
a0b796e3 | 256 | |
a2535589 | 257 | \f |
9b9f9c9d | 258 | ;;;###autoload |
b7bf1cef | 259 | (defun mail-fetch-field (field-name &optional last all list) |
da427818 RS |
260 | "Return the value of the header field whose type is FIELD-NAME. |
261 | The buffer is expected to be narrowed to just the header of the message. | |
262 | If second arg LAST is non-nil, use the last field of type FIELD-NAME. | |
b7bf1cef RS |
263 | If third arg ALL is non-nil, concatenate all such fields with commas between. |
264 | If 4th arg LIST is non-nil, return a list of all such fields." | |
a2535589 JA |
265 | (save-excursion |
266 | (goto-char (point-min)) | |
267 | (let ((case-fold-search t) | |
268 | (name (concat "^" (regexp-quote field-name) "[ \t]*:[ \t]*"))) | |
b7bf1cef RS |
269 | (if (or all list) |
270 | (let ((value (if all ""))) | |
a2535589 JA |
271 | (while (re-search-forward name nil t) |
272 | (let ((opoint (point))) | |
273 | (while (progn (forward-line 1) | |
274 | (looking-at "[ \t]"))) | |
6f759698 RS |
275 | ;; Back up over newline, then trailing spaces or tabs |
276 | (forward-char -1) | |
fb83f550 | 277 | (skip-chars-backward " \t" opoint) |
b7bf1cef RS |
278 | (if list |
279 | (setq value (cons (buffer-substring-no-properties | |
280 | opoint (point)) | |
281 | value)) | |
282 | (setq value (concat value | |
283 | (if (string= value "") "" ", ") | |
284 | (buffer-substring-no-properties | |
285 | opoint (point))))))) | |
286 | (if list | |
287 | value | |
288 | (and (not (string= value "")) value))) | |
a2535589 JA |
289 | (if (re-search-forward name nil t) |
290 | (progn | |
291 | (if last (while (re-search-forward name nil t))) | |
292 | (let ((opoint (point))) | |
293 | (while (progn (forward-line 1) | |
294 | (looking-at "[ \t]"))) | |
6f759698 RS |
295 | ;; Back up over newline, then trailing spaces or tabs |
296 | (forward-char -1) | |
fb83f550 | 297 | (skip-chars-backward " \t" opoint) |
b94f28ee | 298 | (buffer-substring-no-properties opoint (point))))))))) |
a2535589 JA |
299 | \f |
300 | ;; Parse a list of tokens separated by commas. | |
301 | ;; It runs from point to the end of the visible part of the buffer. | |
302 | ;; Whitespace before or after tokens is ignored, | |
303 | ;; but whitespace within tokens is kept. | |
304 | (defun mail-parse-comma-list () | |
305 | (let (accumulated | |
306 | beg) | |
869fc1d9 | 307 | (skip-chars-forward " \t\n") |
a2535589 JA |
308 | (while (not (eobp)) |
309 | (setq beg (point)) | |
310 | (skip-chars-forward "^,") | |
869fc1d9 | 311 | (skip-chars-backward " \t\n") |
a2535589 | 312 | (setq accumulated |
698f40ca | 313 | (cons (buffer-substring-no-properties beg (point)) |
a2535589 JA |
314 | accumulated)) |
315 | (skip-chars-forward "^,") | |
869fc1d9 | 316 | (skip-chars-forward ", \t\n")) |
a2535589 JA |
317 | accumulated)) |
318 | ||
319 | (defun mail-comma-list-regexp (labels) | |
320 | (let (pos) | |
321 | (setq pos (or (string-match "[^ \t]" labels) 0)) | |
322 | ;; Remove leading and trailing whitespace. | |
323 | (setq labels (substring labels pos (string-match "[ \t]*$" labels pos))) | |
324 | ;; Change each comma to \|, and flush surrounding whitespace. | |
325 | (while (setq pos (string-match "[ \t]*,[ \t]*" labels)) | |
326 | (setq labels | |
327 | (concat (substring labels 0 pos) | |
328 | "\\|" | |
329 | (substring labels (match-end 0)))))) | |
330 | labels) | |
e6a4a267 RS |
331 | \f |
332 | (defun mail-rfc822-time-zone (time) | |
333 | (let* ((sec (or (car (current-time-zone time)) 0)) | |
334 | (absmin (/ (abs sec) 60))) | |
335 | (format "%c%02d%02d" (if (< sec 0) ?- ?+) (/ absmin 60) (% absmin 60)))) | |
336 | ||
337 | (defun mail-rfc822-date () | |
338 | (let* ((time (current-time)) | |
339 | (s (current-time-string time))) | |
340 | (string-match "[^ ]+ +\\([^ ]+\\) +\\([^ ]+\\) \\([^ ]+\\) \\([^ ]+\\)" s) | |
341 | (concat (substring s (match-beginning 2) (match-end 2)) " " | |
342 | (substring s (match-beginning 1) (match-end 1)) " " | |
343 | (substring s (match-beginning 4) (match-end 4)) " " | |
344 | (substring s (match-beginning 3) (match-end 3)) " " | |
345 | (mail-rfc822-time-zone time)))) | |
49116ac0 JB |
346 | |
347 | (provide 'mail-utils) | |
348 | ||
6594deb0 | 349 | ;;; mail-utils.el ends here |