1 ;;; mail-utils.el --- utility functions used both by rmail and rnews
3 ;; Copyright (C) 1985 Free Software Foundation, Inc.
6 ;; Keywords: mail, news
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software; you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation; either version 2, or (at your option)
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs; see the file COPYING. If not, write to the
22 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23 ;; Boston, MA 02111-1307, USA.
27 ;; Utility functions for mail and netnews handling. These handle fine
28 ;; points of header parsing.
32 ;;; We require lisp-mode to make sure that lisp-mode-syntax-table has
37 (defvar mail-use-rfc822 nil "\
38 *If non-nil, use a full, hairy RFC822 parser on mail addresses.
39 Otherwise, (the default) use a smaller, somewhat faster, and
40 often correct parser.")
42 ;; Returns t if file FILE is an Rmail file.
44 (defun mail-file-babyl-p (file)
45 (let ((buf (generate-new-buffer " *rmail-file-p*")))
49 (insert-file-contents file nil 0 100)
50 (looking-at "BABYL OPTIONS:"))
53 (defun mail-string-delete (string start end)
54 "Returns a string containing all of STRING except the part
55 from START (inclusive) to END (exclusive)."
56 (if (null end) (substring string 0 start)
57 (concat (substring string 0 start)
58 (substring string end nil))))
60 (defun mail-strip-quoted-names (address)
61 "Delete comments and quoted strings in an address list ADDRESS.
62 Also delete leading/trailing whitespace and replace FOO <BAR> with just BAR.
63 Return a modified address list."
67 (progn (require 'rfc822)
68 (mapconcat 'identity (rfc822-addresses address) ", "))
70 (string-match "\\`[ \t\n]*" address)
71 ;; strip surrounding whitespace
72 (setq address (substring address
74 (string-match "[ \t\n]*\\'" address
77 ;; Detect nested comments.
78 (if (string-match "[ \t]*(\\([^)\\]\\|\\\\.\\|\\\\\n\\)*(" address)
79 ;; Strip nested comments.
82 (set-buffer (get-buffer-create " *temp*"))
85 (set-syntax-table lisp-mode-syntax-table)
87 (while (search-forward "(" nil t)
89 (skip-chars-backward " \t")
90 (delete-region (point)
94 (error (goto-char (point-max))))
96 (setq address (buffer-string))
98 ;; Strip non-nested comments an easier way.
99 (while (setq pos (string-match
100 ;; This doesn't hack rfc822 nested comments
101 ;; `(xyzzy (foo) whinge)' properly. Big deal.
102 "[ \t]*(\\([^)\\]\\|\\\\.\\|\\\\\n\\)*)"
105 (mail-string-delete address
106 pos (match-end 0)))))
108 ;; strip `quoted' names (This is supposed to hack `"Foo Bar" <bar@host>')
110 (while (setq pos (string-match
111 "[ \t]*\"\\([^\"\\]\\|\\\\.\\|\\\\\n\\)*\"[ \t\n]*"
113 ;; If the next thing is "@", we have "foo bar"@host. Leave it.
114 (if (and (> (length address) (match-end 0))
115 (= (aref address (match-end 0)) ?@))
116 (setq pos (match-end 0))
118 (mail-string-delete address
119 pos (match-end 0)))))
120 ;; Retain only part of address in <> delims, if there is such a thing.
121 (while (setq pos (string-match "\\(,\\s-*\\|\\`\\)[^,]*<\\([^>,]*>\\)"
123 (let ((junk-beg (match-end 1))
124 (junk-end (match-beginning 2))
125 (close (match-end 0)))
126 (setq address (mail-string-delete address (1- close) close))
127 (setq address (mail-string-delete address junk-beg junk-end))))
130 (or (and (boundp 'rmail-default-dont-reply-to-names)
131 (not (null rmail-default-dont-reply-to-names)))
132 (setq rmail-default-dont-reply-to-names "info-"))
134 ; rmail-dont-reply-to-names is defined in loaddefs
135 (defun rmail-dont-reply-to (userids)
136 "Returns string of mail addresses USERIDS sans any recipients
137 that start with matches for `rmail-dont-reply-to-names'.
138 Usenet paths ending in an element that matches are removed also."
139 (if (null rmail-dont-reply-to-names)
140 (setq rmail-dont-reply-to-names
141 (concat (if rmail-default-dont-reply-to-names
142 (concat rmail-default-dont-reply-to-names "\\|")
144 (concat (regexp-quote (user-login-name))
146 (let ((match (concat "\\(^\\|,\\)[ \t\n]*\\([^,\n]*!\\|\\)\\("
147 rmail-dont-reply-to-names
151 (while (setq pos (string-match match userids))
152 (if (> pos 0) (setq pos (match-beginning 2)))
154 ;; Delete thru the next comma, plus whitespace after.
155 (if (string-match ",[ \t\n]+" userids (match-end 0))
161 ;; get rid of any trailing commas
162 (if (setq pos (string-match "[ ,\t\n]*\\'" userids))
163 (setq userids (substring userids 0 pos)))
164 ;; remove leading spaces. they bother me.
165 (if (string-match "\\s *" userids)
166 (substring userids (match-end 0))
170 (defun mail-fetch-field (field-name &optional last all)
171 "Return the value of the header field FIELD-NAME.
172 The buffer is expected to be narrowed to just the headers of the message.
173 If second arg LAST is non-nil, use the last such field if there are several.
174 If third arg ALL is non-nil, concatenate all such fields with commas between."
176 (goto-char (point-min))
177 (let ((case-fold-search t)
178 (name (concat "^" (regexp-quote field-name) "[ \t]*:[ \t]*")))
181 (while (re-search-forward name nil t)
182 (let ((opoint (point)))
183 (while (progn (forward-line 1)
184 (looking-at "[ \t]")))
185 ;; Back up over newline, then trailing spaces or tabs
187 (skip-chars-backward " \t" opoint)
188 (setq value (concat value
189 (if (string= value "") "" ", ")
190 (buffer-substring-no-properties
192 (and (not (string= value "")) value))
193 (if (re-search-forward name nil t)
195 (if last (while (re-search-forward name nil t)))
196 (let ((opoint (point)))
197 (while (progn (forward-line 1)
198 (looking-at "[ \t]")))
199 ;; Back up over newline, then trailing spaces or tabs
201 (skip-chars-backward " \t" opoint)
202 (buffer-substring-no-properties opoint (point)))))))))
204 ;; Parse a list of tokens separated by commas.
205 ;; It runs from point to the end of the visible part of the buffer.
206 ;; Whitespace before or after tokens is ignored,
207 ;; but whitespace within tokens is kept.
208 (defun mail-parse-comma-list ()
211 (skip-chars-forward " ")
214 (skip-chars-forward "^,")
215 (skip-chars-backward " ")
217 (cons (buffer-substring beg (point))
219 (skip-chars-forward "^,")
220 (skip-chars-forward ", "))
223 (defun mail-comma-list-regexp (labels)
225 (setq pos (or (string-match "[^ \t]" labels) 0))
226 ;; Remove leading and trailing whitespace.
227 (setq labels (substring labels pos (string-match "[ \t]*$" labels pos)))
228 ;; Change each comma to \|, and flush surrounding whitespace.
229 (while (setq pos (string-match "[ \t]*,[ \t]*" labels))
231 (concat (substring labels 0 pos)
233 (substring labels (match-end 0))))))
236 (defun mail-rfc822-time-zone (time)
237 (let* ((sec (or (car (current-time-zone time)) 0))
238 (absmin (/ (abs sec) 60)))
239 (format "%c%02d%02d" (if (< sec 0) ?- ?+) (/ absmin 60) (% absmin 60))))
241 (defun mail-rfc822-date ()
242 (let* ((time (current-time))
243 (s (current-time-string time)))
244 (string-match "[^ ]+ +\\([^ ]+\\) +\\([^ ]+\\) \\([^ ]+\\) \\([^ ]+\\)" s)
245 (concat (substring s (match-beginning 2) (match-end 2)) " "
246 (substring s (match-beginning 1) (match-end 1)) " "
247 (substring s (match-beginning 4) (match-end 4)) " "
248 (substring s (match-beginning 3) (match-end 3)) " "
249 (mail-rfc822-time-zone time))))
251 (provide 'mail-utils)
253 ;;; mail-utils.el ends here