1 FLIM (Faithful Library about Internet Message) API
7 Each function is described by following notation:
9 [Function] NAME-OF-FUNCTION (SIGNATURE)
13 Each inline function is described by following notation:
15 [Inline function] NAME-OF-FUNCTION (SIGNATURE)
19 Each macro is described by following notation:
21 [Macro] NAME-OF-MACRO (SIGNATURE)
25 Each variable is described by following notation:
27 [Variable] NAME-OF-VARIABLE
31 ILEVEL specifies implementation level:
33 Required: Must implement
34 Suggest: Should implement
37 ULEVEL specifies implementation level:
40 Not Suggest: Should not use
41 Obsolete: Should not use (historical)
51 ** MIME-Entity Creation
53 [Function] mime-open-entity (type location)
54 Open an entity and return it.
56 TYPE is representation-type.
58 LOCATION is location of entity. Specification of it is depended on
62 (Usage: SEMI 1.14 MIME-View)
65 [Function] mime-parse-buffer (&optional buffer representation-type)
66 Parse BUFFER as a MIME message.
68 If buffer is omitted, it parses current-buffer.
70 [Optional]<Not Suggest>
73 ** MIME-Entity Hierarchy
75 [Function] mime-entity-children (entity)
76 Return list of entities included in the ENTITY.
79 (Usage: SEMI 1.14 MIME-View, MIME-PGP)
82 [Function] mime-entity-parent (entity &optional message)
83 Return mother entity of ENTITY.
85 If MESSAGE is specified, it is regarded as root entity.
88 (Usage: SEMI 1.14 MIME-View, MIME-PGP)
91 [Function] mime-find-root-entity (entity)
92 Return root entity of ENTITY.
97 [Function] mime-root-entity-p (entity &optional message)
98 Return t if ENTITY is root-entity (message).
100 If MESSAGE is specified, it is regarded as root entity.
105 [Function] mime-entity-node-id (entity)
106 Return node-id of ENTITY.
109 (Usage: SEMI 1.14 MIME-View, MIME-PGP)
112 [Function] mime-entity-number (entity)
113 Return entity-number of ENTITY.
116 (Usage: SEMI 1.14 MIME-View, MIME-PGP)
119 ** MIME-Entity Search
121 [Function] mime-find-entity-from-node-id (entity-node-id message)
122 Return entity from ENTITY-NODE-ID in MESSAGE.
127 [Function] mime-find-entity-from-number (entity-number message)
128 Return entity from ENTITY-NUMBER in MESSAGE.
133 [Function] mime-find-entity-from-content-id (cid message)
134 Return entity from CID in MESSAGE.
139 ** MIME-Entity Attributes
141 [Function] mime-entity-content-type (entity)
142 Return content-type of ENTITY.
144 (cf. <** Content-Type>)
147 (Usage: SEMI 1.14 MIME-View)
150 [Inline function] mime-entity-media-type (entity)
151 Return primary media-type of ENTITY.
153 [Suggest]<Not Suggest>
154 (Usage: SEMI 1.14 MIME-View)
157 [Inline function] mime-entity-media-subtype (entity)
158 Return media-subtype of ENTITY.
160 [Suggest]<Not Suggest>
161 (Usage: SEMI 1.14 MIME-View)
164 [Inline function] mime-entity-type/subtype (entity)
165 Return media-type/subtype of ENTITY.
168 (Usage: SEMI 1.14 MIME-W3)
171 [Inline function] mime-entity-parameters (entity)
172 Return parameters of Content-Type of ENTITY.
174 [Suggest]<Not Suggest>
175 (Usage: SEMI 1.14 MIME-View)
178 [Function] mime-entity-set-content-type (entity content-type)
179 Set ENTITY's content-type to CONTENT-TYPE.
181 (cf. <** Content-Type>)
184 (Usage: SEMI 1.14 MIME-View)
187 [Function] mime-entity-content-disposition (entity)
188 Return content-disposition of ENTITY.
190 (cf. <** Content-Disposition>)
193 (Usage: SEMI 1.14 MIME-View)
196 [Function] mime-entity-filename (entity)
197 Return filename of ENTITY.
200 (Usage: SEMI 1.14 MIME-View)
203 [Function] mime-entity-encoding (entity &optional default-encoding)
204 Return content-transfer-encoding of ENTITY.
206 If the ENTITY does not have Content-Transfer-Encoding field, this
207 function returns DEFAULT-ENCODING. If it is nil, "7bit" is used as
211 (Usage: SEMI 1.14 MIME-View)
214 [Function] mime-entity-set-encoding (entity encoding)
215 Set ENTITY's content-transfer-encoding to ENCODING.
218 (Usage: SEMI 1.14 MIME-View)
221 [Function] mime-entity-cooked-p (entity)
222 Return non-nil if contents of ENTITY has been already
226 (Usage: SEMI 1.14 MIME-PGP)
229 [Function] mime-entity-name (entity)
230 Return unique name of the ENTITY.
233 (Usage: SEMI 1.14 MIME-View)
236 ** MIME-Entity Header
238 [Function] mime-entity-fetch-field (entity field-name)
239 Return the value of the ENTITY's header field whose type is
242 The results is network representation.
244 If FIELD-NAME field is not found, this function returns nil.
247 (Usage: SEMI 1.14 MIME-View, MIME-BBDB)
250 [Function] mime-entity-read-field (entity field-name)
251 Parse FIELD-NAME field in header of ENTITY, and return the result.
253 Format of result is depended on kind of field. For non-structured
254 field, this function returns string. For structured field, it
255 returns list corresponding with structure of the field.
257 Strings in the result will be converted to internal representation
260 If FIELD-NAME field is not found, this function returns nil.
263 (Usage: SEMI 1.14 MIME-View, MIME-BBDB)
266 ** Text Presentation of MIME-Entity Content
268 [Function] mime-insert-header (entity &optional invisible-fields
270 Insert before point a decoded header of ENTITY.
272 INVISIBLE-FIELDS is list of regexps to match field-name to hide.
273 VISIBLE-FIELDS is list of regexps to match field-name to hide.
275 If a field-name is matched with some elements of INVISIBLE-FIELDS
276 and matched with none of VISIBLE-FIELDS, this function don't insert
279 Each encoded-word in the header is decoded. ``Raw non us-ascii
280 characters'' are also decoded as `default-mime-charset'.
285 [Function] mime-insert-text-content (entity)
286 Insert before point a contents of ENTITY as text entity.
288 Contents of the ENTITY are decoded as MIME charset. If the ENTITY
289 does not have charset parameter of Content-Type field,
290 `default-mime-charset' is used as default value.
295 [Variable] default-mime-charset
296 Symbol to indicate default value of MIME charset.
298 It is used when MIME charset is not specified.
300 It is originally variable of APEL.
305 ** Bytes Representation of MIME-Entity Content
307 [Function] mime-entity-content (entity)
308 Return content of ENTITY as byte sequence (string).
311 (Usage: SEMI 1.14 MIME-View, Postpet)
314 [Function] mime-insert-entity-content (entity)
315 Insert content of ENTITY (byte sequence) at point.
320 [Function] mime-write-entity-content (entity filename)
321 Write content of ENTITY (byte sequence) into FILENAME.
326 ** Network Representation of MIME-Entity
328 [Function] mime-entity-string (entity)
329 Return header and body of ENTITY (string).
331 [Optional]<Not Suggest>
334 [Function] mime-insert-entity (entity)
335 Insert header and body of ENTITY at point.
340 [Function] mime-write-entity (entity filename)
341 Write header and body of ENTITY into FILENAME.
346 [Function] mime-entity-header (entity)
347 Return network representation of ENTITY header (string).
349 [Optional]<Not Suggest>
352 [Function] mime-insert-entity-header (entity)
353 Insert network representation of ENTITY header at point.
355 [Optional]<Not Suggest>
358 [Function] mime-write-entity-header (entity filename)
359 Write network representation of ENTITY header FILENAME.
361 [Optional]<Not Suggest>
364 [Function] mime-entity-body (entity)
365 Return network representation of ENTITY body (string).
367 [Optional]<Not Suggest>
370 [Function] mime-insert-entity-body (entity)
371 Insert network representation of ENTITY body at point.
376 [Function] mime-write-entity-body (entity filename)
377 Write body of ENTITY into FILENAME.
382 * MIME content information
391 [Function] mime-parse-Content-Type (string)
392 Parse STRING as field-body of Content-Type field, and
393 return the result as `mime-content-type' structure.
398 [Function] mime-read-Content-Type ()
399 Read field-body of Content-Type field from current-buffer,
400 and return the parsed result.
402 Format of return value is as same as `mime-parse-Content-Type'.
404 Return `nil' if Content-Type field is not found.
409 [Inline function] mime-content-type-primary-type (content-type)
410 Return primary-type of CONTENT-TYPE.
415 [Inline function] mime-content-type-subtype (content-type)
416 Return subtype of CONTENT-TYPE.
421 [Inline function] mime-content-type-parameter (content-type parameter)
422 Return PARAMETER value of CONTENT-TYPE.
427 [Inline function] mime-content-type-parameters (content-type)
428 Return parameters of CONTENT-TYPE.
433 [Inline function] mime-type/subtype-string (type &optional subtype)
434 Return type/subtype string from TYPE and SUBTYPE.
439 ** Content-Disposition
441 [Function] mime-parse-Content-Disposition (string)
442 Parse STRING as field-body of Content-Disposition field.
447 [Function] mime-read-Content-Disposition ()
448 Read field-body of Content-Disposition field from current-buffer,
449 and return parsed it.
454 [Inline function] mime-content-disposition-type (content-disposition)
455 Return disposition-type of CONTENT-DISPOSITION.
460 [Inline function] mime-content-disposition-parameter
461 (content-disposition parameter)
462 Return PARAMETER value of CONTENT-DISPOSITION.
467 [Inline function] mime-content-disposition-filename (content-disposition)
468 Return filename of CONTENT-DISPOSITION.
473 [Inline function] mime-content-disposition-parameters (content-disposition)
474 Return disposition-parameters of CONTENT-DISPOSITION.
488 [Function] mime-decode-header-in-buffer (&optional code-conversion
490 Decode MIME encoded-words in header fields.
492 If CODE-CONVERSION is nil, it decodes only encoded-words. If it is
493 mime-charset, it decodes non-ASCII bit patterns as the mime-charset.
494 Otherwise it decodes non-ASCII bit patterns as the
495 default-mime-charset.
497 If SEPARATOR is not nil, it is used as header separator.
502 [Function] [Function] eword-decode-header (&optional code-conversion
504 As same as `mime-decode-header-in-buffer', q.v.
508 (require 'eword-decode)
510 is necessary to use this function.
512 [Optional]<Obsolete> (Usage: cmail 2.61)
515 [Function] mime-decode-header-in-region (start end
516 &optional code-conversion)
517 Decode MIME encoded-words in region between START and END.
519 If CODE-CONVERSION is nil, it decodes only encoded-words. If it is
520 mime-charset, it decodes non-ASCII bit patterns as the mime-charset.
521 Otherwise it decodes non-ASCII bit patterns as the
522 default-mime-charset.
527 [Function] mime-decode-field-body (field-body field-name
528 &optional mode max-column)
529 Decode FIELD-BODY as FIELD-NAME in MODE, and return the result.
531 Optional argument MODE must be `plain', `wide', `summary' or `nov'.
532 Default mode is `summary'.
534 If MODE is `wide' and MAX-COLUMN is non-nil, the result is folded
537 Non MIME encoded-word part in FILED-BODY is decoded with
538 `default-mime-charset'.
543 [Function] mime-set-field-decoder (field &rest specs)
544 Set decoder of FIELD.
546 SPECS must be like `MODE1 DECODER1 MODE2 DECODER2 ...'.
548 Each mode must be `nil', `plain', `wide', `summary' or `nov'. If
549 mode is `nil', corresponding decoder is set up for every modes.
554 [Macro] mime-find-field-presentation-method (name)
555 Return field-presentation-method from NAME.
557 NAME must be `plain', `wide', `summary' or `nov'.
562 [Function] mime-find-field-decoder (field &optional mode)
563 Return function to decode field-body of FIELD in MODE.
565 Optional argument MODE must be object or name of
566 field-presentation-method. Name of field-presentation-method must
567 be `plain', `wide', `summary' or `nov'. Default value of MODE is
573 [Function] mime-update-field-decoder-cache (field mode &optional function)
574 Update field decoder cache `mime-field-decoder-cache'.
581 [Function] mime-encode-header-in-buffer (&optional code-conversion)
582 Encode header fields to network representation, such as MIME
585 It refer variable `mime-field-encoding-method-alist'.
590 [Function] mime-encode-field-body (field-body field-name)
591 Encode FIELD-BODY as FIELD-NAME, and return the result.
593 A lexical token includes non-ASCII character is encoded as MIME
594 encoded-word. ASCII token is not encoded.
599 * Content-Transfer-Encoding
608 [Variable] mime-encoding-list
609 List of Content-Transfer-Encoding. Each encoding must be string.
614 [Function] mime-encoding-list (&optional service)
615 Return list of Content-Transfer-Encoding.
617 If SERVICE is specified, it returns available list of
618 Content-Transfer-Encoding for it.
623 [Function] mime-encoding-alist (&optional service)
624 Return table of Content-Transfer-Encoding for completion.
631 [Function] mime-decode-string (string encoding)
632 Decode STRING using ENCODING.
634 ENCODING must be string. If ENCODING is found in
635 `mime-encoding-list', this function decodes the STRING by its value.
640 [Function] mime-decode-region (start end encoding)
641 Decode region START to END of current buffer using ENCODING.
643 ENCODING must be string.
645 [Suggest]<Not Suggest>
648 [Function] mime-write-decoded-region (start end filename encoding)
649 Decode and write current region encoded by ENCODING into FILENAME.
651 START and END are buffer positions.
658 [Function] mime-encode-string (string encoding)
659 Encode STRING using ENCODING.
661 ENCODING must be string.
663 [Optional]<Not Suggest>
666 [Function] mime-encode-region (start end encoding)
667 Encode region START to END of current buffer using ENCODING.
669 ENCODING must be string.
671 [Suggest]<Not Suggest>
674 [Function] mime-insert-encoded-file (filename encoding)
675 Insert file FILENAME encoded by ENCODING format.
682 [Function] encoded-text-decode-string (string encoding)
683 Decode STRING as encoded-text using ENCODING.
685 ENCODING must be string.
690 [Function] encoded-text-encode-string (string encoding &optional mode)
691 Encode STRING as encoded-text using ENCODING.
693 ENCODING must be string.
695 MODE allows `text', `comment', `phrase' or nil. Default value is
701 [Function] base64-encoded-length (string)
702 Return length of B-encoded STRING.
707 [Function] Q-encoded-text-length (string &optional mode)
708 Return length of Q-encoded STRING.
710 MODE allows `text', `comment', `phrase' or nil. Default value is
725 [Function] mime-parse-mailcap-buffer (&optional buffer order)
726 Parse BUFFER as a mailcap, and return the result.
728 If optional argument ORDER is a function, result is sorted by it.
729 If optional argument ORDER is not specified, result is sorted
730 original order. Otherwise result is not sorted.
735 [Variable] mime-mailcap-file
736 File name of user's mailcap file.
738 [Required]<Suggest> (default value may be "~/.mailcap")
741 [Function] mime-parse-mailcap-file (&optional filename order)
742 Parse FILENAME as a mailcap, and return the result.
744 If optional argument ORDER is a function, result is sorted by it.
745 If optional argument ORDER is not specified, result is sorted
746 original order. Otherwise result is not sorted.
753 [Function] mime-format-mailcap-command (mtext situation)
754 Return formated command string from MTEXT and SITUATION.
756 MTEXT is a command text of mailcap specification, such as
759 SITUATION is an association-list about information of entity. Its
762 'type primary media-type
763 'subtype media-subtype
765 STRING parameter of Content-Type field
779 [Variable] mime-field-parser-alist
780 Alist to specify field parser.
783 [Function] mime-parse-Content-Type (string)
784 Parse STRING as field-body of Content-Type field.
787 (PRIMARY-TYPE SUBTYPE (NAME1 . VALUE1)(NAME2 . VALUE2) ...)
788 or nil. PRIMARY-TYPE and SUBTYPE are symbol and NAME_n and VALUE_n
792 [Function] mime-read-Content-Type ()
793 Read field-body of Content-Type field from current-buffer,
794 and return parsed it. Format of return value is as same as
795 `mime-parse-Content-Type'.
798 [Function] mime-parse-Content-Disposition (string)
799 Parse STRING as field-body of Content-Disposition field.
802 [Function] mime-read-Content-Disposition ()
803 Read field-body of Content-Disposition field from current-buffer,
804 and return parsed it.
807 [Function] mime-parse-Content-Transfer-Encoding (string)
808 Parse STRING as field-body of Content-Transfer-Encoding field.
811 [Function] mime-read-Content-Transfer-Encoding (&optional default-encoding)
812 Read field-body of Content-Transfer-Encoding field from
813 current-buffer, and return it.
815 If is is not found, return DEFAULT-ENCODING.
818 [Function] mime-parse-msg-id (tokens)
819 Parse TOKENS as msg-id of Content-Id or Message-Id field.
822 [Function] mime-uri-parse-cid (string)
823 Parse STRING as cid URI.
835 [Function] std11-fetch-field (name)
836 Return the value of the header field NAME.
838 The buffer is expected to be narrowed to just the headers of the message.
841 [Function] std11-narrow-to-header (&optional boundary)
842 Narrow to the message header.
844 If BOUNDARY is not nil, it is used as message header separator.
847 [Function] std11-field-body (name &optional boundary)
848 Return the value of the header field NAME.
850 If BOUNDARY is not nil, it is used as message header separator.
853 [Function] std11-unfold-string (string)
854 Unfold STRING as message header field.
859 [Function] std11-lexical-analyze (string &optional analyzer start)
860 Analyze STRING as lexical tokens of STD 11.
863 [Function] std11-address-string (address)
864 Return string of address part from parsed ADDRESS of RFC 822.
867 [Function] std11-full-name-string (address)
868 Return string of full-name part from parsed ADDRESS of RFC 822.
871 [Function] std11-msg-id-string (msg-id)
872 Return string from parsed MSG-ID of RFC 822.
875 [Function] std11-fill-msg-id-list-string (string &optional column)
876 Fill list of msg-id in STRING, and return the result.
879 [Function] std11-parse-address-string (string)
880 Parse STRING as mail address.
883 [Function] std11-parse-addresses-string (string)
884 Parse STRING as mail address list.
887 [Function] std11-parse-msg-id-string (string)
888 Parse STRING as msg-id.
891 [Function] std11-parse-msg-ids-string (string)
892 Parse STRING as `*(phrase / msg-id)'.
895 [Function] std11-extract-address-components (string)
896 Extract full name and canonical address from STRING.
898 Returns a list of the form (FULL-NAME CANONICAL-ADDRESS). If no
899 name can be extracted, FULL-NAME will be nil.
911 [Function] smtp-send-buffer (sender recipients buffer)
914 SENDER is an envelope sender address.
915 RECIPIENTS is a list of envelope recipient addresses.
916 BUFFER may be a buffer or a buffer name which contains mail message.
920 [Function] smtp-via-smtp (sender recipients buffer)
921 Like `smtp-send-buffer', but sucks in any errors.
923 [Optional]<Not Suggest>