mcharset.el

   1 ;;; mcharset.el --- MIME charset API
   2
   3 ;; Copyright (C) 1997,1998,1999 Free Software Foundation, Inc.
   4
   5 ;; Author: MORIOKA Tomohiko <tomo@m17n.org>
   6 ;; Keywords: emulation, compatibility, Mule
   7
   8 ;; This file is part of APEL (A Portable Emacs Library).
   9
  10 ;; This program is free software; you can redistribute it and/or
  11 ;; modify it under the terms of the GNU General Public License as
  12 ;; published by the Free Software Foundation; either version 2, or (at
  13 ;; your option) any later version.
  14
  15 ;; This program is distributed in the hope that it will be useful, but
  16 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
  17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  18 ;; General Public License for more details.
  19
  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.
  24
  25 ;;; Code:
  26
  27 (require 'poe)
  28 (require 'pcustom)
  29
  30 (cond ((featurep 'mule)
  31        (cond ((featurep 'xemacs)
  32               (require 'mcs-xm)
  33               )
  34              ((>= emacs-major-version 20)
  35               (require 'mcs-e20)
  36               )
  37              (t
  38               ;; for MULE 1.* and 2.*
  39               (require 'mcs-om)
  40               ))
  41        )
  42       ((boundp 'NEMACS)
  43        ;; for Nemacs and Nepoch
  44        (require 'mcs-nemacs)
  45        )
  46       (t
  47        (require 'mcs-ltn1)
  48        ))
  49
  50 (defcustom default-mime-charset-for-write
  51   (if (and (fboundp 'find-coding-system)
  52            (find-coding-system 'utf-8))
  53       'utf-8
  54     default-mime-charset)
  55   "Default value of MIME-charset for encoding.
  56 It may be used when suitable MIME-charset is not found.
  57 It must be symbol."
  58   :group 'i18n
  59   :type 'mime-charset)
  60
  61 (defcustom default-mime-charset-detect-method-for-write
  62   nil
  63   "Function called when suitable MIME-charset is not found to encode.
  64 It must be nil or function.
  65 If it is nil, variable `default-mime-charset-for-write' is used.
  66 If it is a function, interface must be (TYPE CHARSETS &rest ARGS).
  67 CHARSETS is list of charset.
  68 If TYPE is 'region, ARGS has START and END."
  69   :group 'i18n
  70   :type '(choice function (const nil)))
  71
  72 (defun charsets-to-mime-charset (charsets)
  73   "Return MIME charset from list of charset CHARSETS.
  74 Return nil if suitable mime-charset is not found."
  75   (if charsets
  76       (catch 'tag
  77         (let ((rest charsets-mime-charset-alist)
  78               cell)
  79           (while (setq cell (car rest))
  80             (if (catch 'not-subset
  81                   (let ((set1 charsets)
  82                         (set2 (car cell))
  83                         obj)
  84                     (while set1
  85                       (setq obj (car set1))
  86                       (or (memq obj set2)
  87                           (throw 'not-subset nil))
  88                       (setq set1 (cdr set1)))
  89                     t))
  90                 (throw 'tag (cdr cell)))
  91             (setq rest (cdr rest)))
  92           ))))
  93
  94 (defun find-mime-charset-by-charsets (charsets &optional mode &rest args)
  95   "Like `charsets-to-mime-charset', but it does not return nil.
  96
  97 When suitable mime-charset is not found and variable
  98 `default-mime-charset-detect-method-for-write' is not nil,
  99 `find-mime-charset-by-charsets' calls the variable as function and
 100 return the return value of the function.
 101 Interface of the function is (MODE CHARSETS &rest ARGS).
 102
 103 When suitable mime-charset is not found and variable
 104 `default-mime-charset-detect-method-for-write' is nil,
 105 variable `default-mime-charset-for-write' is returned."
 106   (or (charsets-to-mime-charset charsets)
 107       (if default-mime-charset-detect-method-for-write
 108           (apply default-mime-charset-detect-method-for-write
 109                  mode charsets args)
 110         default-mime-charset-for-write)))
 111
 112
 113 ;;; @ end
 114 ;;;
 115
 116 (require 'product)
 117 (product-provide (provide 'mcharset) (require 'apel-ver))
 118
 119 ;;; mcharset.el ends here