;;; qp.el --- Quoted-Printable functions
;; Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004,
;; 2005, 2006 Free Software Foundation, Inc.
;; Author: Lars Magne Ingebrigtsen <email@example.com>
;; Keywords: mail, extensions
;; This file is part of GNU Emacs.
;; GNU Emacs is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation; either version 2, or (at your option)
;; any later version.
;; GNU Emacs is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;; GNU General Public License for more details.
;; You should have received a copy of the GNU General Public License
;; along with GNU Emacs; see the file COPYING. If not, write to the
;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
;; Boston, MA 02110-1301, USA.
;; Functions for encoding and decoding quoted-printable text as
;; defined in RFC 2045.
(eval-when-compile (defvar mm-use-ultra-safe-encoding))
(defun quoted-printable-decode-region (from to &optional coding-system)
"Decode quoted-printable in the region between FROM and TO, per RFC 2045.
If CODING-SYSTEM is non-nil, decode bytes into characters with that
Interactively, you can supply the CODING-SYSTEM argument
The CODING-SYSTEM argument is a historical hangover and is deprecated.
QP encodes raw bytes and should be decoded into raw bytes. Decoding
them into characters should be done separately."
;; Let the user determine the coding system with "C-x RET c".
(list (region-beginning) (region-end) coding-system-for-read))
(unless (mm-coding-system-p coding-system) ; e.g. `ascii' from Gnus
(setq coding-system nil))
;; RFC 2045: ``An "=" followed by two hexadecimal digits, one
;; or both of which are lowercase letters in "abcdef", is
;; formally illegal. A robust implementation might choose to
;; recognize them as the corresponding uppercase letters.''
(let ((case-fold-search t))
(narrow-to-region from to)
;; Do this in case we're called from Gnus, say, in a buffer
;; which already contains non-ASCII characters which would
;; then get doubly-decoded below.
(mm-encode-coding-region (point-min) (point-max) coding-system))
(while (and (skip-chars-forward "^=")
(cond ((eq (char-after (1+ (point))) ?\n)
(let ((byte (string-to-number (buffer-substring (1+ (point))
(+ 3 (point)))
(mm-insert-byte byte 1)
(message "Malformed quoted-printable text")
(mm-decode-coding-region (point-min) (point-max) coding-system)))))
(defun quoted-printable-decode-string (string &optional coding-system)
"Decode the quoted-printable encoded STRING and return the result.
If CODING-SYSTEM is non-nil, decode the region with coding-system.
Use of CODING-SYSTEM is deprecated; this function should deal with
raw bytes, and coding conversion should be done separately."
(quoted-printable-decode-region (point-min) (point-max) coding-system)
(defun quoted-printable-encode-region (from to &optional fold class)
"Quoted-printable encode the region between FROM and TO per RFC 2045.
If FOLD, fold long lines at 76 characters (as required by the RFC).
If CLASS is non-nil, translate the characters not matched by that
regexp class, which is in the form expected by `skip-chars-forward'.
You should probably avoid non-ASCII characters in this arg.
If `mm-use-ultra-safe-encoding' is set, fold lines unconditionally and
encode lines starting with \"From\"."
;; Avoid using 8bit characters. = is \075.
;; Equivalent to "^\000-\007\013\015-\037\200-\377="
(setq class "\010-\012\014\040-\074\076-\177"))
(if (re-search-forward (mm-string-to-multibyte "[^\x0-\x7f\x80-\xff]")
(error "Multibyte character in QP encoding region"))
(narrow-to-region from to)
;; Encode all the non-ascii and control characters.
(while (and (skip-chars-forward class)
;; To unibyte in case of Emacs 23 (unicode) eight-bit.
(format "=%02X" (mm-multibyte-char-to-unibyte (char-after)))
;; Encode white space at the end of lines.
(while (re-search-forward "[ \t]+$" nil t)
(goto-char (match-beginning 0))
(while (not (eolp))
(format "=%02X" (char-after))
(and (boundp 'mm-use-ultra-safe-encoding)
(when (or fold mm-use-ultra-safe-encoding)
(let ((tab-width 1)) ; HTAB is one character.
(while (not (eobp))
;; In ultra-safe mode, encode "From " at the beginning
;; of a line.
(if (looking-at "From ")
(replace-match "From=20" nil t)
(if (looking-at "-")
(replace-match "=2D" nil t))))
;; Fold long lines.
(while (> (current-column) 76) ; tab-width must be 1.
(forward-char 75) ; 75 chars plus an "="
(search-backward "=" (- (point) 2) t)
(defun quoted-printable-encode-string (string)
"Encode the STRING as quoted-printable and return the result."
(let ((default-enable-multibyte-characters (mm-multibyte-string-p string)))
(quoted-printable-encode-region (point-min) (point-max))
;;; arch-tag: db89e52a-e4a1-4b69-926f-f434f04216ba
;;; qp.el ends here