npt-japanese

% Function PAIRLIS

UP


Function PAIRLIS

Function PAIRLIS

構文

pairlis keys data &optional alist => new-alist

引数と戻り値

keys - 通常のリスト
data - 通常のリスト
alist - 連想リスト、デフォルトは空のリスト
new-alist - 連想リスト

定義

keysの要素と、対応するdataの要素を関連付けた連想リストを返却します。 keysdataが同じ長さではないときの結果は未定義です。

alistが与えられたとき、pairlisは、 新しいペアを先頭に追加するようにalistを修正します。 新しいペアは、結果の連想リストに正順か逆順のどちらかで表すことができます。 下記の結果は、

 (pairlis '(one two) '(1 2) '((three . 3) (four . 19)))

次のようになるか、

((one . 1) (two . 2) (three . 3) (four . 19))

あるいは次のようになります。

((two . 2) (one . 1) (three . 3) (four . 19))

Examples:

(setq keys '(1 2 3)
       data '("one" "two" "three")
       alist '((4 . "four"))) =>  ((4 . "four"))
(pairlis keys data) =>  ((3 . "three") (2 . "two") (1 . "one"))
(pairlis keys data alist)
=>  ((3 . "three") (2 . "two") (1 . "one") (4 . "four"))
alist =>  ((4 . "four"))

副作用

なし。

影響

なし。

例外

keysdataが通常のリストではないとき、 型type-errorを通知する準備をしなければなりません。

参考

acons

備考

なし。


TOP, Github