-*-tl manual-*-
tl manual

tm などで使われる Emacs Lisp の library, `tl' に関して説明します。

概要

tl は tm などの Emacs Lisp program で共通に使うための汎用的な module を集めた package です。

tl は以下のような module から成ります。

  * tl-18

  * tl-nemacs

  * tl-orig

  * tl-mule

  * tl-list

  * tl-str

  * tl-header

互換性をとるための機構

tl では、Original Emacs での version の差や、その日本語化や多言語化などの拡張による差を埋め、これらの多様な Emacs の上で互換性をとるための機構を用意しています。

その一つは、Emacs 18 で Emacs 19 の関数を用意して、Emacs 19 で拡張された機能を Emacs 18 で利用するための module `tl-18' です。

もう一つは、NEmacs, Original Emacs, Mule などでの文字、文字列の取扱いの差異を埋め、これらで共通に動く program を書くための module です。

tl-18

tl-18 は Emacs 18 で Emacs 19 の関数を使うための module です。

tl-18.el では、現在、Emacs 19 の関数のうち、add-hook, member を実現しています。

tl-18 を利用するには (require 'tl-18) を書いて下さい。

tl-nemacs

tl-nemacs は、NEmacs において、主に、日本語処理に関して、Mule などの他の Emacs との互換性を取るための module です。tl-nemacs を使うことによって、NEmacs, Original Emacs, Mule の別に依らない program を書くことができます。

tl-nemacs を利用するには (require 'tl-nemacs) を書いて下さい。

文字 code

Constant *junet*

ISO-2022-JP (JIS) を表す。値は 2.（MULE 互換定数）

Constant *internal*

NEmacs の内部 code を表す。値は 3. 実際には、EUC と同じ。（MULE 互換定数）

Constant *euc-japan*

EUC-JP (EUC) を表す。値は 3.（MULE 互換定数）

Function code-convert-string STR SOURCE TARGET

文字列 STR を SOURCE code から TARGET code に変換する。（MULE 互換関数）

leading character

Constant lc-ascii

ASCII を表す leading character.（MULE 互換定数）

Constant lc-jp

JIS X0208 を表す leading character.（MULE 互換定数）

Function get-lc CHR

文字の先頭 octet CHR に対して、その文字の leading character を返す。

文字処理

Function char-bytes CHR

文字の先頭 octet CHR に対して、その文字の byte 数を返す。（MULE 互換関数）

Function char-width CHR

文字の先頭 octet CHR に対して、その文字の幅を返す。（MULE 互換関数）

文字列処理

Function string-width STR

文字列 STR の幅を返す。（MULE 互換関数）

Function check-ASCII-string STR

文字列 STR の中に ASCII 以外の文字が含まれないことを確かめる。もし、ASCII 以外の文字が含まれていれば nil を返す。

その他

Function attribute-add-narrow-attribute ATR FROM TO

FROM と TO で囲まれた region に ATR の attribute を付ける。

tl-orig

tl-orig は、Original Emacs 19 において、主に、ISO-8859-1 の処理に関して、Mule などの他の Emacs との互換性を取るための module です。tl-orig を使うことによって、NEmacs, Original Emacs, Mule の別に依らない program を書くことができます。

tl-orig を利用するには (require 'tl-orig) を書いて下さい。

leading character

Constant lc-ascii

ASCII を表す leading character.（MULE 互換定数）

Constant lc-ltn1

ISO 8859-1 を表す leading character.（MULE 互換定数）

Function get-lc CHR

文字の先頭 octet CHR に対して、その文字の leading character を返す。

文字処理

Function char-bytes CHR

文字の先頭 octet CHR に対して、その文字の byte 数を返す。（MULE 互換関数）

Function char-width CHR

文字の先頭 octet CHR に対して、その文字の幅を返す。（MULE 互換関数）

文字列処理

Function string-width STR

文字列 STR の幅を返す。（MULE 互換関数）

tl-mule

tl-mule は、Mule において、主に、多言語文字列の処理に関して、NEmacs や Original Emacs などの他の Emacs との互換性を取るための module です。 tl-mule を使うことによって、NEmacs, Original Emacs, Mule の別に依らない program を書くことができます。

tl-mule を利用するには (require 'tl-mule) を書いて下さい。

leading character

Function get-lc CHR

文字の先頭 octet CHR に対して、その文字の leading character を返す。

tl-list

tl-list は list 処理に関する有用な関数を集めた module です。

tl-list を利用するには (require 'tl-list) を書いて下さい。

list

Function last LIST

LIST の最後の要素を返す。（Common Lisp 互換関数）

Function butlast LIST &optional n

LIST の最後の N 要素を除いた copy を返す。（Common Lisp 互換関数）

Function nbutlast LIST &optional n

LIST の最後の N 要素を除いたものを返す。（破壊的）（Common Lisp 互換関数）

連想リスト

Function put-alist ITEM VALUE ALIST

連想リスト ALIST の key ITEM に対応する値を VALUE にする。（破壊的）（ELIS 互換関数）

Function del-alist ITEM ALIST

連想リスト ALIST の key ITEM に対応する値を削除する。（破壊的）（ELIS 互換関数）

Function set-alist SYM ITEM VALUE

連想リストを入れた symbol SYM の key ITEM の値を VALUE にする。（破壊的）

単一化子

field とは (field-type . field-value) という形をした対である。この field を要素とした (field1 field2 ...) という形の連想リストを「型」として取り扱う。

Function fetch-field KEY ALIST

連想リスト ALIST の key KEY に対応する対を返す。assoc と同じ。（jinn 互換関数）

Function put-field KEY VALUE ALIST

連想リスト ALIST の key KEY に対応する値を VALUE にする。put-field と同じ。（破壊的）（jinn 互換関数）

Function delete-field KEY VALUE

連想リスト ALIST の key KEY に対応する値を削除する。（破壊的）（jinn 互換関数）

Function field-unifier-for-default CLASS INSTANCE

他に適当な field-unifier が見つからなかった場合に起動される field-unifier. field CLASS と field INSTANCE の field-unify を行う。（jinn 互換関数）

Function field-unify CLASS INSTANCE

field CLASS と field INSTANCE の field-unify を行う。実際には、CLASS の field-type に対応した field-unifier が起動される。（jinn 互換関数）

Function assoc-unify CLASS INSTANCE

連想リスト CLASS と連想リスト INSTANCE の type-unify を行う。（jinn 互換関数）

tl-str

tl-str は文字列処理に関する有用な関数を集めた module です。

tl-str を利用するには (require 'tl-str) を書いて下さい。

Function rightful-boundary-short-string STR WIDTH

文字列 STR を先頭から幅 WIDTH 以内で切った文字列を返します。 multi octet 文字列の場合でも正しく文字単位で切断します。

Function get-version-string ID

RCS の version 文字列 ID から数字と `.' からのみ構成される version number 文字列を返す。

Function replace-as-filename STR

文字列 STR のから file name として問題のある文字を取り除いた file name として使える文字列を返す。

Variable cited-prefix-regexp

命令 fill-cited-region で用いる、引用文字列の先頭文字列を表す prefix. 正規表現を指定する。

Command fill-cited-region BEGIN END

先頭位置 BEGIN と終了位置 END で囲まれた region を引用文字列として fill する。

Function symbol-concat A B

文字列か symbol である２つの引数 A と B を文字列としてつないだ名前の symbol を返す。（jinn 互換関数）

Function top-string-match PAT STR

文字列 PAT が文字列 STR の先頭に含まれる場合、(PAT 残り) という形式の list を返す。（jinn 互換関数）

Function middle-string-match PAT STR

文字列 PAT が文字列 STR のどこかに含まれる場合、(前 PAT 残り) という形式の list を返す。（jinn 互換関数）

tl-header

tl-header は mail や News などの message header の処理に関する有用な関数を集めた module です。

tl-header を利用するには (require 'tl-header) を書いて下さい。

Constant message/quoted-string-regexp

RFC 822 における quoted-string を表す正規表現。

Constant message/field-name-regexp

RFC 822 における field-name を表す正規表現。

Constant message/field-body-regexp

RFC 822 における field-body を表す正規表現。

Constant message/field-regexp

RFC 822 における field を表す正規表現。

Constant message/word-regexp

RFC 822 における word を表す正規表現。

Constant message/local-part-regexp

RFC 822 における local-part を表す正規表現。

Constant message/domain-regexp

RFC 822 における domain を表す正規表現。

Constant message/addr-spec-regexp

RFC 822 における addr-spec を表す正規表現。

Function message/get-field-body NAME

message header において NAME field の body を返す。

Function message/divide-field STR

field 文字列 STR を (field-name field-body) という形式の list にして返す。

Function message/parse-addr-spec STR

文字列 STR を addr-spec として構文解析し、(addr-spec 残り) という形式のリストにして返す。

Function message/parse-phrase-route-addr STR

文字列 STR を phrase route-addr として構文解析し、((phrase "<" addr-spec ">") 残り) という形式のリストにして返す。（注：正確には、 route も見なければいけないが、route は無いものとして解析している）

Function message/parse-comment STR

文字列 STR を comment として構文解析し、(("(" comment ")") 残り) という形式のリストにして返す。

Function message/parse-address STR

文字列 STR を address として構文解析し、(address 残り) という形式のリストにして返す。

Function message/parse-addresses STR

文字列 STR を address list として構文解析し、(address1 address2 ...) という形式のリストにして返す。

Function message/unfolding-string STR

文字列 STR を field として unfolding した文字列を返す。

Function message/strip-quoted-string STR

文字列 STR を quoted-string として strip した文字列を返す。