annotate lisp/international/utf-7.el @ 92222:77158849803a lisp-bob

*** empty log message ***
author Roland Winkler <Roland.Winkler@physik.uni-erlangen.de>
date Mon, 25 Feb 2008 20:07:28 +0000
parents 606f2d163a64
children 4054054dd212
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
1 ;;; utf-7.el --- utf-7 coding system
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
2
79709
b6fdfff4ae81 Add 2008 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 78274
diff changeset
3 ;; Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
4
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
5 ;; Author: Dave Love <fx@gnu.org>
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
6 ;; Keywords: i18n, mail
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
7
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
8 ;; This file is free software; you can redistribute it and/or modify
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
9 ;; it under the terms of the GNU General Public License as published by
78274
451a2d341d55 Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents: 75347
diff changeset
10 ;; the Free Software Foundation; either version 3, or (at your option)
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
11 ;; any later version.
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
12
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
13 ;; This file is distributed in the hope that it will be useful,
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
14 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
15 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
16 ;; GNU General Public License for more details.
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
17
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
18 ;; You should have received a copy of the GNU General Public License
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
19 ;; along with GNU Emacs; see the file COPYING. If not, write to
64085
18a818a2ee7c Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
20 ;; the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18a818a2ee7c Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
21 ;; Boston, MA 02110-1301, USA.
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
22
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
23 ;;; Commentary:
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
24
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
25 ;; Defines a coding system for UTF-7, defined in RFC 2152. Non-ASCII
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
26 ;; segments are encoded as base64-encoded big endian UTF-16. Also
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
27 ;; defines a variation required for IMAP (RFC 2060).
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
28
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
29 ;; The encoding and decoding was originally taken from Jon K Hellan's
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
30 ;; implementation in Gnus, but has been substantially re-done.
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
31
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
32 ;; This probably needs more attention. In particular, it's not
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
33 ;; completely consistent with iconv's behaviour. It's arguable
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
34 ;; whether the IMAP version should be a coding system since it's
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
35 ;; apparently only used for IMAP mailbox names, so it's commented out.
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
36
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
37 ;;; Code:
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
38
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
39 (defun utf-7-decode (len imap)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
40 "Decode LEN bytes of UTF-7 at point.
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
41 IMAP non-nil means use the IMAP version."
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
42 (save-excursion
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
43 (save-restriction
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
44 (narrow-to-region (point) (+ (point) len))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
45 (let ((not-esc (if imap "^&" "^+"))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
46 (skip-chars (if imap "A-Za-z0-9+," "A-Za-z0-9+/")))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
47 (while (not (eobp))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
48 (skip-chars-forward not-esc)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
49 (unless (eobp)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
50 (forward-char)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
51 (let ((p (point))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
52 (run-length (skip-chars-forward skip-chars)))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
53 (if (eq ?- (char-after))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
54 (delete-char 1))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
55 (unless (= run-length 0) ; encoded lone esc-char
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
56 (let ((pl (mod (- run-length) 4)))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
57 (insert-char ?= pl)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
58 (if imap
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
59 (subst-char-in-region p (point) ?, ?/))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
60 (base64-decode-region p (point)))
51630
90215b7be64d Adjusted for the name change: xxx-utf-16-{le,be} -> xxx-utf-16{le,be}.
Kenichi Handa <handa@m17n.org>
parents: 50897
diff changeset
61 (decode-coding-region p (point) 'utf-16be)
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
62 (save-excursion
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
63 (goto-char p)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
64 (delete-backward-char 1)))))))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
65 (- (point-max) (point-min)))))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
66
90250
1c8f24770e68 Delete the definition of utf-7.
Kenichi Handa <handa@m17n.org>
parents: 90200
diff changeset
67 ;;;###autoload
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
68 (defun utf-7-post-read-conversion (len)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
69 (utf-7-decode len nil))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
70
91117
57ad20761f87 (utf-7-imap-post-read-conversion)
Kenichi Handa <handa@m17n.org>
parents: 90996
diff changeset
71 ;;;###autoload
85926
025d69230a9b (utf-7-imap): New coding system.
Kenichi Handa <handa@m17n.org>
parents: 78274
diff changeset
72 (defun utf-7-imap-post-read-conversion (len)
025d69230a9b (utf-7-imap): New coding system.
Kenichi Handa <handa@m17n.org>
parents: 78274
diff changeset
73 (utf-7-decode len t))
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
74
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
75 (defun utf-7-encode (from to imap)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
76 "Encode bytes between FROM and TO to UTF-7.
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
77 ESC and SKIP-CHARS are adjusted for the normal and IMAP versions."
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
78 (let* ((old-buf (current-buffer))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
79 (esc (if imap ?& ?+))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
80 ;; These are characters which can be encoded asis.
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
81 (skip-chars (if imap
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
82 "\t\n\r\x20-\x25\x27-\x7e" ; rfc2060
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
83 ;; This includes the rfc2152 optional set.
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
84 ;; Perhaps it shouldn't (like iconv).
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
85 "\t\n\r -*,-[]-}"))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
86 (not-skip-chars (format "^%s%c" skip-chars esc)))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
87 (set-buffer (generate-new-buffer " *temp*"))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
88 (if (stringp from)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
89 (insert from)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
90 (insert-buffer-substring old-buf from to))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
91 (goto-char (point-min))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
92 (while (not (eobp))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
93 (skip-chars-forward skip-chars)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
94 (if (eq ?+ (char-after))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
95 (progn (forward-char)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
96 (insert ?-))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
97 (unless (eobp)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
98 (insert esc)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
99 (let ((p (point)))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
100 (skip-chars-forward not-skip-chars)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
101 (save-restriction
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
102 ;; encode-coding-region doesn't preserve point
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
103 (narrow-to-region p (point))
51630
90215b7be64d Adjusted for the name change: xxx-utf-16-{le,be} -> xxx-utf-16{le,be}.
Kenichi Handa <handa@m17n.org>
parents: 50897
diff changeset
104 (encode-coding-region p (point-max) 'utf-16be)
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
105 (base64-encode-region p (point-max))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
106 (if imap
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
107 (subst-char-in-region p (point-max) ?/ ?,))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
108 (goto-char p)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
109 ;; As I read the RFC, this isn't correct, but it's
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
110 ;; consistent with iconv, at least regarding `='.
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
111 (skip-chars-forward "^= \t\n")
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
112 (delete-region (point) (point-max))))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
113 (unless (eobp)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
114 (insert ?-)))))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
115 nil))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
116
90250
1c8f24770e68 Delete the definition of utf-7.
Kenichi Handa <handa@m17n.org>
parents: 90200
diff changeset
117 ;;;###autoload
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
118 (defun utf-7-pre-write-conversion (from to)
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
119 (utf-7-encode from to nil))
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
120
91117
57ad20761f87 (utf-7-imap-post-read-conversion)
Kenichi Handa <handa@m17n.org>
parents: 90996
diff changeset
121 ;;;###autoload
85926
025d69230a9b (utf-7-imap): New coding system.
Kenichi Handa <handa@m17n.org>
parents: 78274
diff changeset
122 (defun utf-7-imap-pre-write-conversion (from to)
025d69230a9b (utf-7-imap): New coding system.
Kenichi Handa <handa@m17n.org>
parents: 78274
diff changeset
123 (utf-7-encode from to t))
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
124
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
125 (provide 'utf-7)
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 51630
diff changeset
126
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 51630
diff changeset
127 ;;; arch-tag: 975ee403-90a4-4286-97d2-4ed1323f4ef9
50897
289523dd4fa7 *** empty log message ***
Dave Love <fx@gnu.org>
parents:
diff changeset
128 ;;; utf-7.el ends here